Collator 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
[加護病房強化] 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("à\u0325", "a\u0325̀") != 0) {
System.out.println("à\u0325 is not equals to a\u0325̀ without decomposition");
myCollator.setDecomposition(CANONICAL_DECOMPOSITION);
if (myCollator.compare("à\u0325", "a\u0325̀") != 0) {
System.out.println("Error: à\u0325 should be equals to a\u0325̀ with decomposition");
}
else {
System.out.println("à\u0325 is equals to a\u0325̀ with decomposition");
}
}
else {
System.out.println("Error: à\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 |
回傳此 |
| 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 的排序器名稱,並以預設 |
| GetDisplayName(ULocale, ULocale) |
[加護病房] 回傳 objectLocale 的排序器名稱,並以 displayLocale 本地化。 |
| GetDisplayName(ULocale) |
[加護病房] 回傳 objectLocale 的排序器名稱,並以預設 |
| 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() |
標記此節點為處置,並以 |
| IJavaPeerable.Finalized() |
標記此節點為處置,並以 |
| IJavaPeerable.JniObjectReferenceControlBlock |
取得此對等端使用的原生控制區塊指標。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
儲存執行時提供的身份雜湊碼。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
取代儲存的受管理對等狀態旗標。 (繼承來源 JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
當引用無效時,更新對等節點並釋放已拋棄節點的控制區塊。 (繼承來源 JavaObject) |
| IJavaPeerable.UnregisterFromRuntime() |
將此實例從執行時的 Java 物件查詢中移除。 |
擴充方法
| 名稱 | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
取得實例 |
| JavaAs<TResult>(IJavaPeerable) |
試著強制 |
| JavaCast<TResult>(IJavaObject) |
執行 Android 執行時檢查型別轉換。 |
| JavaCast<TResult>(IJavaObject) |
重用相容的受管理對等端或取得請求型態的包裝器。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
試著強制 |