CollationKey クラス

定義

名前空間:: Java.Text

アセンブリ:: Mono.Android.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

CollationKeyは、特定のString オブジェクトのルールの下のCollatorを表します。

[Android.Runtime.Register("java/text/CollationKey", DoNotGenerateAcw=true)]
public abstract class CollationKey : Java.Lang.Object, IDisposable, Java.Lang.IComparable

[<Android.Runtime.Register("java/text/CollationKey", DoNotGenerateAcw=true)>]
type CollationKey = class
    inherit Object
    interface IComparable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

継承: Object

JavaObject

Object
CollationKey

属性: RegisterAttribute

実装: IJavaObject IJavaPeerable IComparable IDisposable

注釈

CollationKeyは、特定のString オブジェクトのルールの下のCollatorを表します。 2 つの CollationKeyを比較すると、それらが表す Stringの相対順序が返されます。 CollationKeyを使用してStringを比較することは、通常、Collator.compareを使用するよりも高速です。したがって、 Stringを複数回比較する必要がある場合 (たとえば、 Stringのリストを並べ替えるとき)。 CollationKeyを使用する方が効率的です。

CollationKeyを直接作成することはできません。代わりに、 Collator.getCollationKeyを呼び出して生成します。比較できるのは、同じCollationKey オブジェクトから生成されたCollatorだけです。

CollationKeyのStringを生成するには、String全体を調べて、ビットごとの比較が可能な一連のビットに変換する必要があります。これにより、キーが生成されると、高速な比較が可能になります。キーを生成するコストは、 Stringを何度も比較する必要がある場合に、より高速な比較で回収されます。一方、比較の結果は、多くの場合、各 Stringの最初の数文字によって決定されます。 Collator.compare では、必要な数の文字のみが調べられます。これにより、単一の比較を行うときに高速になります。

次の例は、 CollationKeyを使用して Stringの一覧を並べ替える方法を示しています。 <blockquote>

{@code
            // Create an array of CollationKeys for the Strings to be sorted.
            Collator myCollator = Collator.getInstance();
            CollationKey[] keys = new CollationKey[3];
            keys[0] = myCollator.getCollationKey("Tom");
            keys[1] = myCollator.getCollationKey("Dick");
            keys[2] = myCollator.getCollationKey("Harry");
            sort(keys);

            //...

            // Inside body of sort routine, compare keys this way
            if (keys[i].compareTo(keys[j]) > 0)
               // swap keys[i] and keys[j]

            //...

            // Finally, when we've returned from sort.
            System.out.println(keys[0].getSourceString());
            System.out.println(keys[1].getSourceString());
            System.out.println(keys[2].getSourceString());
            }

</blockquote>

1.1 で追加されました。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

コンストラクター

名前	説明
CollationKey(IntPtr, JniHandleOwnership)	JNI オブジェクトのマネージド表現を作成するときに使用されるコンストラクター。ランタイムによって呼び出されます。
CollationKey(String)	CollationKey コンストラクター。

プロパティ

名前	説明
Class	この `Object`のランタイムクラスを返します。 (継承元 Object)
Handle	基になる Android インスタンスへのハンドル。 (継承元 Object)
JniIdentityHashCode	相互運用ランタイムによってこのJava ピアに割り当てられた ID ハッシュコードを取得します。 (継承元 Object)
JniManagedPeerState	`CollationKey`は、特定の`String` オブジェクトのルールの下の`Collator`を表します。 (継承元 JavaObject)
JniPeerMembers	`CollationKey`は、特定の`String` オブジェクトのルールの下の`Collator`を表します。
PeerReference	このJava ピアの JNI オブジェクト参照を取得します。 (継承元 Object)
SourceString	この CollationKey が表す文字列を返します。
ThresholdClass	この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。
ThresholdType	この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。

メソッド

名前	説明
Clone()	このオブジェクトのコピーを作成して返します。 (継承元 Object)
CompareTo(CollationKey)	この CollationKey をターゲットの CollationKey と比較します。
Construct(JniObjectReference, JniObjectReferenceOptions)	`CollationKey`は、特定の`String` オブジェクトのルールの下の`Collator`を表します。 (継承元 JavaObject)
Dispose()	このJava ピアによって保持されているリソースを解放します。 (継承元 Object)
Dispose(Boolean)	このJava ピアによって保持されているリソースを解放します。 (継承元 Object)
DisposeUnlessReferenced()	`CollationKey`は、特定の`String` オブジェクトのルールの下の`Collator`を表します。 (継承元 JavaObject)
Equals(Object)	`CollationKey`は、特定の`String` オブジェクトのルールの下の`Collator`を表します。 (継承元 JavaObject)
Equals(Object)	他のオブジェクトがこのオブジェクトと "等しい" かどうかを示します。 (継承元 Object)
GetHashCode()	オブジェクトのハッシュコード値を返します。 (継承元 Object)
JavaFinalize()	古い. オブジェクトへの参照がなくなったとガベージコレクションによって判断されたときに、オブジェクトのガベージコレクターによって呼び出されます。 (継承元 Object)
Notify()	このオブジェクトのモニターで待機している 1 つのスレッドを起動します。 (継承元 Object)
NotifyAll()	このオブジェクトのモニターで待機しているすべてのスレッドを起動します。 (継承元 Object)
SetHandle(IntPtr, JniHandleOwnership)	Handle プロパティを設定します。 (継承元 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	`CollationKey`は、特定の`String` オブジェクトのルールの下の`Collator`を表します。 (継承元 JavaObject)
ToArray<T>()	このJava配列ラッパーからマネージド配列を作成します。 (継承元 Object)
ToByteArray()	CollationKey をビットシーケンスに変換します。
ToString()	オブジェクトの文字列形式を返します。 (継承元 Object)
UnregisterFromRuntime()	相互運用ランタイムからこのJava ピアの登録を解除します。 (継承元 Object)
Wait()	現在のスレッドが起動するまで待機します。通常は、 <em>notified</em> または <em>interrupted</em>。 (継承元 Object)
Wait(Int64, Int32)	現在のスレッドは、通常、 <em>notified</em> または <em>interrupted</em>、または一定のリアルタイムが経過するまで、起動されるまで待機します。 (継承元 Object)
Wait(Int64)	現在のスレッドは、通常、 <em>notified</em> または <em>interrupted</em>、または一定のリアルタイムが経過するまで、起動されるまで待機します。 (継承元 Object)

明示的なインターフェイスの実装

名前	説明
IComparable.CompareTo(Object)	`CollationKey`は、特定の`String` オブジェクトのルールの下の`Collator`を表します。
IJavaPeerable.Disposed()	`CollationKey`は、特定の`String` オブジェクトのルールの下の`Collator`を表します。 (継承元 JavaObject)
IJavaPeerable.Finalized()	`CollationKey`は、特定の`String` オブジェクトのルールの下の`Collator`を表します。 (継承元 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	`CollationKey`は、特定の`String` オブジェクトのルールの下の`Collator`を表します。 (継承元 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	`CollationKey`は、特定の`String` オブジェクトのルールの下の`Collator`を表します。 (継承元 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	`CollationKey`は、特定の`String` オブジェクトのルールの下の`Collator`を表します。 (継承元 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	`CollationKey`は、特定の`String` オブジェクトのルールの下の`Collator`を表します。 (継承元 JavaObject)
IJavaPeerable.UnregisterFromRuntime()	`CollationKey`は、特定の`String` オブジェクトのルールの下の`Collator`を表します。

拡張メソッド

名前	説明
GetJniTypeName(IJavaPeerable)	インスタンス `self`の型の JNI 名を取得します。
JavaAs<TResult>(IJavaPeerable)	`self`を強制的に`TResult`入力し、強制型がJava側で有効であることを確認します。
JavaCast<TResult>(IJavaObject)	Android ランタイムチェック型変換を実行します。
JavaCast<TResult>(IJavaObject)	`CollationKey`は、特定の`String` オブジェクトのルールの下の`Collator`を表します。
TryJavaCast<TResult>(IJavaPeerable, TResult)	`self`を強制的に`TResult`入力し、強制型がJava側で有効であることを確認します。

適用対象