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

備註

A CollationKey 代表 a String 在特定 Collator 物件的規則下。 比較兩個 CollationKeys 會回傳它們所代表 s 的 String相對順序。

由於 s 的 Collator規則集可能不同，同一字串在兩個不同 Collators 下的排序順序可能會不同。 因此比較 CollationKey由不同 Collators 生成的 s 可能會產生錯誤的結果。

方法 CollationKey.compareTo(CollationKey) 與方法 Collator.compare(String, String) 都會比較兩個字串並回傳它們的相對順序。 這兩種方法的效能特性可能有所不同。 請注意，彙整鍵通常不如單純做比較效率。 更多細節請參閱加護病房使用者指南。

在建構 的 CollationKey過程中，整個源串會被檢視並處理成一系列以空點結束的位元，這些位元儲存在 CollationKey。 執行時 CollationKey.compareTo(CollationKey) ，會對位元序列進行位元比較。 這在建立 CollationKey時可能會產生啟動成本，但一旦建立金鑰，二進位比較就非常快速。 當同一根弦要反覆比較時，建議採用此方法。

另一方面，的 Collator.compare(String, String) 實作只能檢查和處理字串直到順序不同的第一個字元。 若只比較一次弦，建議採用此方法。

關於位元序列的組成，更多資訊可參考 使用指南。

以下範例展示了如何使用 CollationKeys 來排序 s 的列表 String。

<引用>

// 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() );

</區塊引用>

此職業不可次級

Java 文件 android.icu.text.CollationKey。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。