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

繼承

Object

JavaObject

Object

Collator

衍生

Android.Icu.Text.RuleBasedCollator

屬性

RegisterAttribute

實作

IFreezable IJavaObject IJavaPeerable ICloneable IComparator IDisposable

備註

<強力>[加護病房增強]</強重> 加護病房取代 java.text.Collator. ICU特有的方法、領域及其他功能標示為「<強力>[重症監護室]</強力>」。

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

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

依照 Unicode聯盟對 Unicode整合演算法（UCA）的規範，比較中會使用五種不同的強度等級：

<ul><li>主要強度：通常用來表示基本字元之間的差異（例如「a」和「b」）。 這是最明顯的差異。 例如，字典依底字劃分為不同章節。 li次要強項：字元中的口音被視為次要差異（例如「as」 <「&agrave;s“ <「at」）。 其他字母間的差異也可視為次要差異，視語言而定。 當弦中存在主要差異時，次級差異會被忽略。 li第三級強力：大寫與小寫字母的差異在第三級強弱處區分（例如「ao」 <「Ao」 &;「a&ograve;」）。 此外，字母的變體在第三級強度上與基本形式不同（例如「A」和「（A）」）。 另一個例子是大假名與小假名的差異。 當弦中存在主要或次要差異時，三級差異會被忽略。 li第四級強度：當標點符號被忽略（參見 用戶指南中的忽略標點符號）時，可以使用額外強度等級來區分有標點符號與無標點符號的詞彙（例如「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 所創建與分享的作品，並依授權條款所描述的使用進行修改。