CollationKey クラス

定義

[Android.Runtime.Register("android/icu/text/CollationKey", ApiSince=24, DoNotGenerateAcw=true)]
public sealed class CollationKey : Java.Lang.Object, IDisposable, Java.Lang.IComparable

[<Android.Runtime.Register("android/icu/text/CollationKey", ApiSince=24, 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の相対順序が返されます。

Collatorのルール セットは異なる場合があるため、2 つの異なるCollatorで同じ文字列の並べ替え順序が異なる場合があります。 そのため、異なるCollationKeyから生成されたCollatorを比較すると、正しくない結果が得られます。

メソッド CollationKey.compareTo(CollationKey) とメソッドの両方 Collator.compare(String, String) 2 つの文字列を比較し、その相対順序を返します。 これら 2 つの方法のパフォーマンス特性は異なる場合があります。 照合順序キーは、多くの場合、単に比較を行うよりも効率が低くなることに注意してください。 詳細については、ICU ユーザー ガイドを参照してください。

CollationKeyの構築中に、ソース文字列全体が調べられ、null で終わる一連のビットに処理され、CollationKeyに格納されます。 CollationKey.compareTo(CollationKey)実行すると、ビット シーケンスに対してビットごとの比較が実行されます。 これにより、 CollationKeyの作成時にスタートアップ コストが発生する可能性がありますが、キーが作成されると、バイナリ比較が高速になります。 この方法は、同じ文字列を何度も繰り返し比較する場合に推奨されます。

一方、 Collator.compare(String, String) の実装では、最初の文字の順序が異なるまで、文字列を調べて処理できます。 文字列を 1 回だけ比較する場合は、この方法をお勧めします。

ビット シーケンスの構成の詳細については、 ユーザー ガイドを参照してください。

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

<blockquote>

// 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 );
<br>
            //...
<br>
            // Inside body of sort routine, compare keys this way
            if( keys[i].compareTo( keys[j] ) &gt; 0 )
               // swap keys[i] and keys[j]
<br>
            //...
<br>
            // 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>

このクラスはサブクラス化できません

Javaドキュメント。

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