語言

Collator 類別

定義

[加護病房強化] ICU 的替代 java.text.Collator。

[Android.Runtime.Register("android/icu/text/Collator", ApiSince=24, DoNotGenerateAcw=true)]
public abstract class Collator : Java.Lang.Object, Android.Icu.Util.IFreezable, IDisposable, Java.Util.IComparator
[<Android.Runtime.Register("android/icu/text/Collator", ApiSince=24, DoNotGenerateAcw=true)>]
type Collator = class
    inherit Object
    interface IFreezable
    interface ICloneable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface IComparator
繼承
衍生
屬性
實作

備註

[加護病房強化] ICU java.text.Collator的 . ICU 特有的方法、欄位及其他功能標示為「<strong>[icu]</strong>」。

Collator 執行區域敏感字串比較。 一個具體子類別 RuleBasedCollator 允許透過規則集來自訂排序順序。

Collator 只有在凍結時才是線程安全的。 請參閱 #isFrozen() 與 Freezable。

依照 Unicode聯盟對 Unicode整合演算法(UCA)的規範,比較中會使用五種不同的強度等級:

<ul><li>主要強度:通常用來表示基本字元之間的差異(例如「a」「 < b」)。 這是最明顯的差異。 例如,字典依底字劃分為不同章節。 <li>次要優勢:字元中的重音被視為次要差異(例如「as」 < 「às“ < ”at“)。 其他字母間的差異也可視為次要差異,視語言而定。 當弦中存在主要差異時,次級差異會被忽略。 <li>第三強度:在第三字母強度下區分大小寫字母的差異(例如「ao」「 < Ao」「 < aò」)。 此外,字母的變體在第三級強度上與基本形式不同(例如「A」和「(A)」)。 另一個例子是大假名與小假名的差異。 當弦中存在主要或次要差異時,三級差異會被忽略。 <li>第四級強度:當標點符號被忽略(參見 使用者指南中的忽略標點符號)時,從 PRIMARY 到 TERTIARY 強度,可以使用額外的強度等級來區分有標點符號與無標點符號的單詞(例如「ab」「 < a-b」「 < aB」)。 當存在主要、次要或第三階段差異時,這種差異會被忽略。 只有在需要忽略標點符號時,才應使用第四元強度。 <li>等強:當其他強力相等時,以相同強力作為平手決勝條件。 會比較每個字串 NFD 形式的 Unicode 碼點值,以防無差異。 例如,希伯來語的吟唱符號只有在這個強度下才會區分。 這種強度應謹慎使用,因為只有兩個字串間的碼值差異極為罕見。 使用此強度會大幅降低比較與整合金鑰產生 API 的效能。 此強度同時增加排序鍵的大小。 </ul>

與 JDK 不同,ICU4J 的 Collator 僅處理兩種分解模式,一種是標準分解模式,另一種則是不使用任何分解。 相容性分解模式java.text.Collator.FULL_DECOMPOSITION此處不支援。 若設定為典型分解模式,整理器會正確處理未正規化的文字,產生與 NFD 正規化文本相同的結果。 若正典分解被關閉,使用者需確保所有文字格式已正確,才能進行比較或取得 CollationKey。

欲了解更多關於彙整服務的資訊 ,請參閱使用者指南。

使用範例

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

            The following example shows how to compare two strings using the
            Collator for the default locale.

            // Compare two strings in the default locale
            Collator myCollator = Collator.getInstance();
            myCollator.setDecomposition(NO_DECOMPOSITION);
            if (myCollator.compare("&agrave;\u0325", "a\u0325̀") != 0) {
                System.out.println("&agrave;\u0325 is not equals to a\u0325̀ without decomposition");
                myCollator.setDecomposition(CANONICAL_DECOMPOSITION);
                if (myCollator.compare("&agrave;\u0325", "a\u0325̀") != 0) {
                    System.out.println("Error: &agrave;\u0325 should be equals to a\u0325̀ with decomposition");
                }
                else {
                    System.out.println("&agrave;\u0325 is equals to a\u0325̀ with decomposition");
                }
            }
            else {
                System.out.println("Error: &agrave;\u0325 should be not equals to a\u0325̀ without decomposition");
            }

Java 文件 android.icu.text.Collator。

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

建構函式

名稱 Description
Collator()

空的預設建構函數讓 javadocs 滿意

Collator(IntPtr, JniHandleOwnership)

建立一個受管理實例,代表一個現有的 Java 物件。

欄位

名稱 Description
CanonicalDecomposition
已淘汰.

分解模式值。

FullDecomposition
已淘汰.

[ICU] 注意:這僅是為了與 Java API 的向下相容。

Identical
已淘汰.

最小的 Collator 強度值。

NoDecomposition
已淘汰.

分解模式值。

Primary
已淘汰.

最強的收集器強度值。

Quaternary
已淘汰.

[加護病房] 第四層級收集器強度值。

Secondary
已淘汰.

第二級收集者強度值。

Tertiary
已淘汰.

三級收集者力量值。

屬性

名稱 Description
Class

回傳此 Object的執行時類別。

(繼承來源 Object)
Decomposition

回傳此整理器的分解模式。 -或- 設定此排序器的分解模式。

Handle

底層 Android 實例的帳號。

(繼承來源 Object)
Instance

會回傳目前預設地點的整理器。

IsFrozen

判斷物體是否被凍結。

JniIdentityHashCode

取得由互通執行時指派給此 Java 對等端的身份雜湊碼。

(繼承來源 Object)
JniManagedPeerState

取得執行時最後指派的狀態旗標。

(繼承來源 JavaObject)
JniPeerMembers

取得用於存取此 Java 綁定成員的 JNI 元資料。

MaxVariable

[加護病房] 回傳受替代處理行為影響的字元的最大重排序群組。

PeerReference

取得這個 Java 節點的 JNI 物件參考。

(繼承來源 Object)
Strength

回傳此 Collator 的力量屬性。 -或- 設定此計數器的力量屬性。

TailoredSet

[加護病房] 傳回包含此排序器中所有字元與序列的 UnicodeSet。

ThresholdClass

取得用於虛擬方法派遣的 Java 類別。

ThresholdType

取得宣告這個 Java 綁定的受管理型別。

UCAVersion

[加護病房]回傳此整理器物件的 UCA 版本。

VariableTop

[加護病房]取得 Collator 的可變頂值。

Version

[加護病房]回傳這個整理器物件的版本。

方法

名稱 Description
Clone()

複製人整理器。

CloneAsThawed()

提供複製人行動的規定。

Compare(Object, Object)

比較來源物件與目標物件。

Compare(String, String)

根據此整理器的規則、強度與分解模式,將原始文字字串與目標文字字串進行比較。

Construct(JniObjectReference, JniObjectReferenceOptions)

將此對等節點的建置委派給執行時的值管理器。

(繼承來源 JavaObject)
Dispose()

釋放該 Java 節點所持有的資源。

(繼承來源 Object)
Dispose(Boolean)

釋放該 Java 節點所持有的資源。

(繼承來源 Object)
DisposeUnlessReferenced()

請求值管理器處置此對等節點,除非其映射保留該受管理實例。

(繼承來源 JavaObject)
Equals(Object)

測試另一個受管理節點是否參考相同的 Java 物件。

(繼承來源 JavaObject)
Equals(Object)

表示是否有其他物體「等同」於此物。

(繼承來源 Object)
Equals(String, String)

利用此拼貼器的規則、強度與分解模式比較兩個文字字串的相等性。

Freeze()

會凍結整理器。

GetAvailableLocales()

回傳安裝整合器的 locale 物件集合。

GetAvailableULocales()

[加護病房] 回傳安裝排序器的語系集合,作為 ULocale 物件。

GetCollationKey(String)

將字串轉換為適合高效重複比較的 CollationKey。

GetDisplayName(Locale, Locale)

[加護病房] 回傳 objectLocale 的排序器名稱,並以 displayLocale 本地化。

GetDisplayName(Locale)

[加護病房] 回傳 objectLocale 的排序器名稱,並以預設 DISPLAY 語系本地化。

GetDisplayName(ULocale, ULocale)

[加護病房] 回傳 objectLocale 的排序器名稱,並以 displayLocale 本地化。

GetDisplayName(ULocale)

[加護病房] 回傳 objectLocale 的排序器名稱,並以預設 DISPLAY 語系本地化。

GetEquivalentReorderCodes(Int32)

檢索所有與該重排序碼分組的重排序碼。

GetFunctionalEquivalent(String, ULocale, Boolean[])

[加護病房] 回傳針對指定關鍵字所請求語系的功能等價語系,適用於校對服務。

GetFunctionalEquivalent(String, ULocale)

[加護病房] 回傳針對指定關鍵字所請求語系的功能等價語系,適用於校對服務。

GetHashCode()

回傳物件的雜湊碼值。

(繼承來源 Object)
GetInstance(Locale)

回傳想要地點的整理器。

GetInstance(ULocale)

[加護病房] 回傳所需語系的分類器。

GetKeywords()

[加護病房] 回傳所有與排序相關可能的關鍵字陣列。

GetKeywordValues(String)

[加護病房] 給定一個關鍵字時,會傳回一個陣列,包含該關鍵字目前正在使用的所有值。

GetKeywordValuesForLocale(String, ULocale, Boolean)

[加護病房] 給定一個鍵與語系,會以偏好順序回傳一個字串值陣列,這會產生差異。

GetReorderCodes()

取得此整理器的重排序代碼。

JavaFinalize()
已淘汰.

當垃圾回收判定該物件不再有相關參考時,由垃圾回收器呼叫。

(繼承來源 Object)
Notify()

喚醒一個正在該物件監視器上等待的執行緒。

(繼承來源 Object)
NotifyAll()

喚醒所有等待該物件監視器的執行緒。

(繼承來源 Object)
SetHandle(IntPtr, JniHandleOwnership)

設定 Handle 屬性。

(繼承來源 Object)
SetMaxVariable(Int32)

[加護病房] 將變數 top 設定為指定的重新排序群組的最頂端。

SetPeerReference(JniObjectReference, JniObjectReferenceOptions)

在控制區塊中儲存參考值,但不建立 JNI 參考副本。

(繼承來源 JavaObject)
SetReorderCodes(Int32[])

設定此整理器的重新排序代碼。

ToArray<T>()

從這個 Java 陣列包裝器建立一個受管理陣列。

(繼承來源 Object)
ToString()

回傳物件的字串表示。

(繼承來源 Object)
UnregisterFromRuntime()

將此 Java 節點從互通執行時中取消註冊。

(繼承來源 Object)
Wait()

使目前執行緒等待被喚醒,通常是透過 通知 或 中斷。

(繼承來源 Object)
Wait(Int64, Int32)

使目前執行緒等待被喚醒(通常是透過 通知 或 中斷),或等待一定的實際時間過去。

(繼承來源 Object)
Wait(Int64)

使目前執行緒等待被喚醒(通常是透過 通知 或 中斷),或等待一定的實際時間過去。

(繼承來源 Object)

明確介面實作

名稱 Description
IComparator.Compare(Object, Object)

比較了其兩種關於秩序的論點。

IFreezable.CloneAsThawed()

提供複製人行動的規定。

IFreezable.Freeze()

凍結物體。

IJavaPeerable.Disposed()

標記此節點為處置,並以disposing設定為 true的呼叫Dispose。

(繼承來源 JavaObject)
IJavaPeerable.Finalized()

標記此節點為處置,並以disposing設定為 false的呼叫Dispose。

(繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

取得此對等端使用的原生控制區塊指標。

(繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)

儲存執行時提供的身份雜湊碼。

(繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

取代儲存的受管理對等狀態旗標。

(繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)

當引用無效時,更新對等節點並釋放已拋棄節點的控制區塊。

(繼承來源 JavaObject)
IJavaPeerable.UnregisterFromRuntime()

將此實例從執行時的 Java 物件查詢中移除。

擴充方法

名稱 Description
GetJniTypeName(IJavaPeerable)

取得實例 self類型的 JNI 名稱。

JavaAs<TResult>(IJavaPeerable)

試著強制self輸入 TResult,檢查 強制在 Java 端是否有效。

JavaCast<TResult>(IJavaObject)

執行 Android 執行時檢查型別轉換。

JavaCast<TResult>(IJavaObject)

重用相容的受管理對等端或取得請求型態的包裝器。

TryJavaCast<TResult>(IJavaPeerable, TResult)

試著強制self輸入 TResult,檢查 強制在 Java 端是否有效。

適用於