Collator 類別

定義

命名空間:

Java.Text

組件:

Mono.Android.dll

類別 Collator 會執行區分 String 地區設定的比較。

[Android.Runtime.Register("java/text/Collator", DoNotGenerateAcw=true)]
public abstract class Collator : Java.Lang.Object, IDisposable, Java.Interop.IJavaPeerable, Java.Lang.ICloneable, Java.Util.IComparator

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

繼承

Object

Object

Collator

衍生

Java.Text.RuleBasedCollator

屬性

RegisterAttribute

實作

IJavaObject IJavaPeerable ICloneable IComparator IDisposable

備註

類別 Collator 會執行區分 String 地區設定的比較。 您可以使用這個類別來建置自然語言文字的搜尋和排序例程。

Collator 是抽象基類。 子類別會實作特定的定序策略。 一個子類別 RuleBasedCollator目前隨附於 Java 平臺，適用於一組廣泛的語言。 可能會建立其他子類別來處理更特製化的需求。

就像其他區分地區設定的類別一樣，您可以使用靜態處理站方法 getInstance，為指定的地區設定取得適當的 Collator 物件。 如果您需要瞭解特定定序策略的詳細數據，或需要修改該策略，您只需要查看 的 Collator 子類別。

下列範例示範如何使用 預設地區設定來 Collator 比較兩個字元串。 <blockquote>

{@code
            // Compare two strings in the default locale
            Collator myCollator = Collator.getInstance();
            if( myCollator.compare("abc", "ABC") < 0 )
                System.out.println("abc is less than ABC");
            else
                System.out.println("abc is greater than or equal to ABC");
            }

</blockquote>

您可以設定 Collator的 <em>強度</em> 屬性，以判斷在比較中視為顯著差異的層級。 提供四個強度： PRIMARY、 SECONDARY、 TERTIARY、 和 IDENTICAL。 語言特徵的確切強度指派取決於地區設定。 例如，在捷克文中，“e” 和 “f” 被視為主要差異，而 “e” 和 “ě” 是次要差異，“e” 和 “E” 則是第三個差異，而 “e” 和 “e” 相同。 以下顯示美式英文如何忽略大小寫和輔色。 <blockquote>

//Get the Collator for US English and set its strength to PRIMARY
            Collator usCollator = Collator.getInstance(Locale.US);
            usCollator.setStrength(Collator.PRIMARY);
            if( usCollator.compare("abc", "ABC") == 0 ) {
                System.out.println("Strings are equivalent");
            }

</blockquote>

若要完全比較 String一次， compare 方法可提供最佳效能。 不過，排序列表String時，通常需要多次比較。String 在此情況下， CollationKey可提供更佳的效能。 類別 CollationKey 會將 String 轉換成一系列的位，而該位可以與其他 CollationKey位進行比較。 是由CollationKeyCollator指定 String之的物件所建立。 <br><strong>Note：</strong>CollationKeys from different Collators can can be compared. 如需使用 CollationKey的範例，請參閱 類別描述CollationKey。

已在1.1中新增。

的 java.text.CollatorJava 檔。

此頁面的部分是根據 原始碼專案所建立和共用的工作進行修改，並根據 中所述的詞彙使用。

建構函式

Collator()	預設建構函式。
Collator(IntPtr, JniHandleOwnership)	建立 JNI 物件的 Managed 表示法時所使用的建構函式;由運行時間呼叫。

欄位

CanonicalDecomposition	分解模式值。
FullDecomposition	分解模式值。
Identical	定序強度值。
NoDecomposition	分解模式值。
Primary	定序強度值。
Secondary	定序強度值。
Tertiary	定序強度值。

屬性

Class	傳回這個 Object的運行時間類別。 (繼承來源 Object)
Decomposition	取得這個定序器的分解模式。 -或- 設定這個定序器的分解模式。
Handle	基礎Android實例的句柄。 (繼承來源 Object)
Instance	取得目前預設地區設定的 Collator。
JniIdentityHashCode	類別 Collator 會執行區分 String 地區設定的比較。 (繼承來源 Object)
JniPeerMembers	類別 Collator 會執行區分 String 地區設定的比較。
PeerReference	類別 Collator 會執行區分 String 地區設定的比較。 (繼承來源 Object)
Strength	傳回這個 Collator 的強度屬性。 -或- 設定這個 Collator 的強度屬性。
ThresholdClass	此 API 支援 Mono for Android 基礎結構，並不適合直接從您的程式代碼使用。
ThresholdType	此 API 支援 Mono for Android 基礎結構，並不適合直接從您的程式代碼使用。

方法

Clone()	傳回與這個定序器相同的分解模式和強度值的新定序器。
Compare(Object, Object)	比較其兩個順序自變數。
Compare(String, String)	根據這個 Collator 的定序規則，比較來源字串與目標字串。
Dispose()	類別 Collator 會執行區分 String 地區設定的比較。 (繼承來源 Object)
Dispose(Boolean)	類別 Collator 會執行區分 String 地區設定的比較。 (繼承來源 Object)
Equals(Object)	指出其他物件是否「等於」這個物件。 (繼承來源 Object)
Equals(String, String)	根據這個 Collator 定序規則比較兩個字串相等的便利方法。
GetAvailableLocales()	傳回這個類別的方法可以傳回本地化實例之所有地區 getInstance 設定的陣列。
GetCollationKey(String)	將 String 轉換成一系列位，可與其他 CollationKey 進行比較。
GetHashCode()	產生這個定序器的哈希程序代碼。
GetInstance(Locale)	取得所需地區設定的 Collator。
JavaFinalize()	當垃圾收集判斷對象沒有其他參考時，由物件上的垃圾收集行程呼叫。 (繼承來源 Object)
Notify()	喚醒正在等候此物件的監視器的單一線程。 (繼承來源 Object)
NotifyAll()	喚醒正在等候此物件監視器的所有線程。 (繼承來源 Object)
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
ToArray<T>()	類別 Collator 會執行區分 String 地區設定的比較。 (繼承來源 Object)
ToString()	傳回物件的字串表示。 (繼承來源 Object)
UnregisterFromRuntime()	類別 Collator 會執行區分 String 地區設定的比較。 (繼承來源 Object)
Wait()	讓目前的線程等到喚醒為止，通常是藉由 <em>notified</em> 或 <em>interrupted</em> 來喚醒。 (繼承來源 Object)
Wait(Int64)	讓目前的線程等到喚醒為止，通常是<透過em>notified</em或em>interrupted</em>>，或<直到經過一定數量的實時為止。 (繼承來源 Object)
Wait(Int64, Int32)	讓目前的線程等到喚醒為止，通常是<透過em>notified</em或em>interrupted</em>>，或<直到經過一定數量的實時為止。 (繼承來源 Object)

明確介面實作

IComparator.Compare(Object, Object)	類別 Collator 會執行區分 String 地區設定的比較。
IJavaPeerable.Disposed()	類別 Collator 會執行區分 String 地區設定的比較。 (繼承來源 Object)
IJavaPeerable.DisposeUnlessReferenced()	類別 Collator 會執行區分 String 地區設定的比較。 (繼承來源 Object)
IJavaPeerable.Finalized()	類別 Collator 會執行區分 String 地區設定的比較。 (繼承來源 Object)
IJavaPeerable.JniManagedPeerState	類別 Collator 會執行區分 String 地區設定的比較。 (繼承來源 Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	類別 Collator 會執行區分 String 地區設定的比較。 (繼承來源 Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	類別 Collator 會執行區分 String 地區設定的比較。 (繼承來源 Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	類別 Collator 會執行區分 String 地區設定的比較。 (繼承來源 Object)

擴充方法

JavaCast<TResult>(IJavaObject)	執行 Android 執行時間檢查的類型轉換。
JavaCast<TResult>(IJavaObject)	類別 Collator 會執行區分 String 地區設定的比較。
GetJniTypeName(IJavaPeerable)	類別 Collator 會執行區分 String 地區設定的比較。