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.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

JavaObject

Object

Collator

衍生

Java.Text.RuleBasedCollator

屬性

RegisterAttribute

實作

IJavaObject IJavaPeerable ICloneable IComparator IDisposable

備註

該 Collator 類別執行區域敏感 String 比較。 你會用這門課建立自然語言文本的搜尋與排序程序。

Collator 是一個抽象基底類別。 子職業實作特定的整理策略。 其中一個子RuleBasedCollator類別 ，目前由 Java 平台提供，適用於廣泛的語言。 其他子類別則可被創造以滿足更專業的需求。

像其他區域敏感類別一樣，你可以使用靜態工廠方法， getInstance來取得特定區域的適當 Collator 物件。 你只需要在需要了解特定排序策略的細節，或是需要修改該策略時，才需要查看 的 Collator 子類別。

以下範例說明如何使用 預設 Collator 位置比較兩個字串。 <引用>

{@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");
            }

</區塊引用>

你可以設定 Collator的 <em>強度</電磁> 特性，來判斷比較中被視為顯著差異的程度。 提供四項優勢：PRIMARY、 SECONDARYTERTIARYIDENTICAL。 語言特徵的確切優勢歸屬地區。 例如，在捷克語中，「e」和「f」被視為主要差異，而「e」和「ě」是次級差異，「e」和「E」是第三級差異，而「e」和「e」則是相同的。 以下說明了美式英語如何可以忽略格和重音符號。 <引用>

//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");
            }

</區塊引用>

若僅比較 String一次 s，該 compare 方法提供最佳效能。 然而，在排序 s 的列表String時，通常需要多次比較。String 在這種情況下， CollationKeys 提供了更好的效能。 該 CollationKey 類別將 a String 轉換成一系列位元，這些位元可逐位 CollationKey元與其他 s 比較。 A CollationKey 是由給定Collator物件所創造String的。 <br><strong>注意：</來自不同 >s 的強CollationKeyCollators 無法比較。 請參考類別描述 CollationKey ，以了解使用 CollationKeys 的範例。

在 1.1 版本中加入。

Java 文件 java.text.Collator。

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

建構函式

名稱	Description
Collator()	預設建構函式。
Collator(IntPtr, JniHandleOwnership)	用於建立 JNI 物件受管理表示的建構器;由執行時呼叫。

欄位

名稱	Description
CanonicalDecomposition	分解模式值。
FullDecomposition	分解模式值。
Identical	整理器強度值。
NoDecomposition	分解模式值。
Primary	整理器強度值。
Secondary	整理器強度值。
Tertiary	整理器強度值。

屬性

名稱	Description
Class	回傳此 Object的執行時類別。 (繼承來源 Object)
Decomposition	取得這個整理器的分解模式。 -或- 設定這個排序器的分解模式。
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
Instance	取得目前預設地點的整理器。
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	該 Collator 類別執行區域敏感 String 比較。 (繼承來源 JavaObject)
JniPeerMembers	該 Collator 類別執行區域敏感 String 比較。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
Strength	回傳此 Collator 的力量屬性。 -或- 設定此整理器強度屬性。
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。

方法

名稱	Description
Clone()	回傳一個新的拼貼器，其分解模式與強度值與此彙整器相同。
Compare(Object, Object)	比較了其兩種關於秩序的論點。
Compare(String, String)	根據此 Collator 的整理規則，將來源字串與目標字串進行比較。
Construct(JniObjectReference, JniObjectReferenceOptions)	該 Collator 類別執行區域敏感 String 比較。 (繼承來源 JavaObject)
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	該 Collator 類別執行區域敏感 String 比較。 (繼承來源 JavaObject)
Equals(Object)	該 Collator 類別執行區域敏感 String 比較。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
Equals(String, String)	根據此整理器的排序規則，方便比較兩字串相等性的方法。
GetAvailableLocales()	回傳一個包含所有區域的陣列，該 getInstance 類別的方法可回傳本地化實例。
GetCollationKey(String)	將字串轉換成一系列位元，可與其他 CollationKey 逐位比較。
GetHashCode()	產生這個整合器的雜湊碼。
GetInstance(Locale)	取得想要地點的整理器。
JavaFinalize()	當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	該 Collator 類別執行區域敏感 String 比較。 (繼承來源 JavaObject)
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToString()	回傳物件的字串表示。 (繼承來源 Object)
UnregisterFromRuntime()	將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object)
Wait()	導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object)
Wait(Int64, Int32)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)
Wait(Int64)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)

明確介面實作

名稱	Description
IComparator.Compare(Object, Object)	比較了其兩種關於秩序的論點。
IJavaPeerable.Disposed()	該 Collator 類別執行區域敏感 String 比較。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	該 Collator 類別執行區域敏感 String 比較。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	該 Collator 類別執行區域敏感 String 比較。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	該 Collator 類別執行區域敏感 String 比較。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	該 Collator 類別執行區域敏感 String 比較。 (繼承來源 JavaObject)

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 self類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制self輸入 TResult，檢查 強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	該 Collator 類別執行區域敏感 String 比較。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制self輸入 TResult，檢查 強制在 Java 端是否有效。