Language

CollationKey クラス

定義

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
継承
CollationKey
属性
実装

注釈

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ドキュメント。

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

コンストラクター

Name 説明
CollationKey(IntPtr, JniHandleOwnership)

JNI オブジェクトのマネージド表現を作成するときに使用されるコンストラクター。ランタイムによって呼び出されます。

CollationKey(String)

CollationKey コンストラクター。

プロパティ

Name 説明
Class

この Objectのランタイム クラスを返します。

(継承元 Object)
Handle

基になる Android インスタンスへのハンドル。

(継承元 Object)
JniIdentityHashCode

相互運用ランタイムによってこのJava ピアに割り当てられた ID ハッシュ コードを取得します。

(継承元 Object)
JniManagedPeerState

ランタイムによって最後に割り当てられた状態フラグを取得します。

(継承元 JavaObject)
JniPeerMembers

このJava バインドのメンバーにアクセスするために使用される JNI メタデータを取得します。

PeerReference

このJava ピアの JNI オブジェクト参照を取得します。

(継承元 Object)
SourceString

この CollationKey が表す文字列を返します。

ThresholdClass

この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。

ThresholdType

この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。

メソッド

Name 説明
Clone()

このオブジェクトのコピーを作成して返します。

(継承元 Object)
CompareTo(CollationKey)

この CollationKey をターゲットの CollationKey と比較します。

Construct(JniObjectReference, JniObjectReferenceOptions)

このピアの構築をランタイムの値マネージャーに委任します。

(継承元 JavaObject)
Dispose()

このJava ピアによって保持されているリソースを解放します。

(継承元 Object)
Dispose(Boolean)

このJava ピアによって保持されているリソースを解放します。

(継承元 Object)
DisposeUnlessReferenced()

マッピングで同じマネージド インスタンスが保持されない限り、このピアを破棄するように値マネージャーに要求します。

(継承元 JavaObject)
Equals(Object)

別のマネージド ピアが同じJava オブジェクトを参照しているかどうかをテストします。

(継承元 JavaObject)
Equals(Object)

他のオブジェクトがこのオブジェクトと "等しい" かどうかを示します。

(継承元 Object)
GetHashCode()

オブジェクトのハッシュ コード値を返します。

(継承元 Object)
JavaFinalize()
古い.

オブジェクトへの参照がなくなったとガベージ コレクションによって判断されたときに、オブジェクトのガベージ コレクターによって呼び出されます。

(継承元 Object)
Notify()

このオブジェクトのモニターで待機している 1 つのスレッドを起動します。

(継承元 Object)
NotifyAll()

このオブジェクトのモニターで待機しているすべてのスレッドを起動します。

(継承元 Object)
SetHandle(IntPtr, JniHandleOwnership)

Handle プロパティを設定します。

(継承元 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)

JNI 参照コピーを作成せずに、制御ブロックに参照値を格納します。

(継承元 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)

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

Name 説明
IComparable.CompareTo(Object)

このオブジェクトを指定したオブジェクトと順序を比較します。

IJavaPeerable.Disposed()

このピアを破棄済みとしてマークし、disposingが true に設定されたDisposeを呼び出します。

(継承元 JavaObject)
IJavaPeerable.Finalized()

このピアを破棄済みとしてマークし、disposingが false に設定されたDisposeを呼び出します。

(継承元 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

このピアで使用されるネイティブの control-block ポインターを取得します。

(継承元 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)

ランタイムによって提供される ID ハッシュ コードを格納します。

(継承元 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

格納されているマネージド ピア状態フラグを置き換えます。

(継承元 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)

参照が無効な場合は、ピア参照を更新し、破棄されたピアの制御ブロックを解放します。

(継承元 JavaObject)
IJavaPeerable.UnregisterFromRuntime()

ランタイムのJava オブジェクト参照からこのインスタンスを削除します。

拡張メソッド

Name 説明
GetJniTypeName(IJavaPeerable)

インスタンス selfの型の JNI 名を取得します。

JavaAs<TResult>(IJavaPeerable)

selfを強制的にTResult入力し、強制型がJava側で有効であることを確認します。

JavaCast<TResult>(IJavaObject)

Android ランタイムチェック型変換を実行します。

JavaCast<TResult>(IJavaObject)

互換性のあるマネージド ピアを再利用するか、要求された型のラッパーを取得します。

TryJavaCast<TResult>(IJavaPeerable, TResult)

selfを強制的にTResult入力し、強制型がJava側で有効であることを確認します。

適用対象