RuleBasedCollator 類別

定義

[Android.Runtime.Register("android/icu/text/RuleBasedCollator", ApiSince=24, DoNotGenerateAcw=true)]
public sealed class RuleBasedCollator : Android.Icu.Text.Collator

[<Android.Runtime.Register("android/icu/text/RuleBasedCollator", ApiSince=24, DoNotGenerateAcw=true)>]
type RuleBasedCollator = class
    inherit Collator

繼承

Object

JavaObject

Object

Collator

RuleBasedCollator

屬性

RegisterAttribute

備註

RuleBasedCollator 是 Collator 的一個具體子類別。 它允許透過使用者自訂的規則集來自訂 Collator。 RuleBasedCollator 設計完全符合 Unicode 排序演算法（UCA）， 並符合 ISO 14651 標準。

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

強烈建議使用者在使用此類別前，先閱讀 使用者指南 以獲得更多關於彙整服務的資訊。

透過在基類 Collator 中呼叫 getInstance（Locale） 工廠方法，從一個區域建立一個 RuleBasedCollator。 Collator.getInstance（Locale）根據參數 locale 定義的整合規則，建立一個 RuleBasedCollator 物件。 若需要自訂的排序順序或屬性，請使用 RuleBasedCollator（String） 建構器搭配相應規則。 自訂的 RuleBasedCollator 會根據 CLDR 根排序來排序，同時根據指定規則重新調整角色的屬性與順序。

RuleBasedCollator 為大多數加護病房支援的地點提供正確的排序順序。 若無法取得特定區域資料，順序最終會退回到 CLDR 的根排序順序。

關於排序規則語法及自訂細節，請參閱使用者指南中的 排序自訂 部分。

<strong>注意</strong> Java 與 ICU4J 中使用的 Collation 規則語法有些差異：

<ul><li>根據 JDK 文件： <br>修飾詞 '！' ：啟動泰語/寮語元音與子音互換。如果此規則在泰語元音範圍為 \ 時生效;U0E40-\U0E44 位於音域 \ 的泰語子音前;U0E01-\U0E2E 或 為 #92 範圍的寮國元音;U0EC0-\U0EC4 位於 \ 音域的寮語子音前;U0E81-\然後將元音放在子音後面以便整理。 <BR> 若規則未加修飾語「！」，則未開啟泰語/寮語元音與子音互換。 <br> ICU4J 的 RuleBasedCollator 不支援關閉泰語/寮語元音與子音互換，因為 UCA 明確表示必須支援才能確保正確的排序順序。 若遇到「！」，則忽略。</li><li>如基底類別 Collator 文件所述，不支援相容分解模式。</li></ul>

<強力>範例</強力>

建立自訂 RuleBasedCollators： <blockquote>

String simple = "& a < b < c < d";
            RuleBasedCollator simpleCollator = new RuleBasedCollator(simple);

            String norwegian = "& a , A < b , B < c , C < d , D < e , E "
                               + "< f , F < g , G < h , H < i , I < j , "
                               + "J < k , K < l , L < m , M < n , N < "
                               + "o , O < p , P < q , Q <r , R <s , S < "
                               + "t , T < u , U < v , V < w , W < x , X "
                               + "< y , Y < z , Z < \u00E5 = a\u030A "
                               + ", \u00C5 = A\u030A ; aa , AA < \u00E6 "
                               + ", \u00C6 < \u00F8 , \u00D8";
            RuleBasedCollator norwegianCollator = new RuleBasedCollator(norwegian);

</區塊引用>

將 s 連接 Collator的規則： <blockquote>

// Create an en_US Collator object
            RuleBasedCollator en_USCollator = (RuleBasedCollator)
                Collator.getInstance(new Locale("en", "US", ""));
            // Create a da_DK Collator object
            RuleBasedCollator da_DKCollator = (RuleBasedCollator)
                Collator.getInstance(new Locale("da", "DK", ""));
            // Combine the two
            // First, get the collation rules from en_USCollator
            String en_USRules = en_USCollator.getRules();
            // Second, get the collation rules from da_DKCollator
            String da_DKRules = da_DKCollator.getRules();
            RuleBasedCollator newCollator =
                                        new RuleBasedCollator(en_USRules + da_DKRules);
            // newCollator has the combined rules

</區塊引用>

對現有的 RuleBasedCollator 進行修改以建立新 Collator 物件，方法是在現有規則上附加變更： <blockquote>

// Create a new Collator object with additional rules
            String addRules = "& C < ch, cH, Ch, CH";
            RuleBasedCollator myCollator =
                new RuleBasedCollator(en_USCollator.getRules() + addRules);
            // myCollator contains the new rules

</區塊引用>

如何更改非空格重音符號的順序： <blockquote>

// old rule with main accents
            String oldRules = "= \u0301 ; \u0300 ; \u0302 ; \u0308 "
                            + "; \u0327 ; \u0303 ; \u0304 ; \u0305 "
                            + "; \u0306 ; \u0307 ; \u0309 ; \u030A "
                            + "; \u030B ; \u030C ; \u030D ; \u030E "
                            + "; \u030F ; \u0310 ; \u0311 ; \u0312 "
                            + "< a , A ; ae, AE ; \u00e6 , \u00c6 "
                            + "< b , B < c, C < e, E & C < d , D";
            // change the order of accent characters
            String addOn = "& \u0300 ; \u0308 ; \u0302";
            RuleBasedCollator myCollator = new RuleBasedCollator(oldRules + addOn);

</區塊引用>

在預設設定前新增主要排序，例如在日文Collator<中將英文字元排序在日文字元之前或之後：blockquote>

// get en_US Collator rules
            RuleBasedCollator en_USCollator
                                   = (RuleBasedCollator)Collator.getInstance(Locale.US);
            // add a few Japanese characters to sort before English characters
            // suppose the last character before the first base letter 'a' in
            // the English collation rule is \u2212
            String jaString = "& \u2212 <\u3041, \u3042 <\u3043, "
                              + "\u3044";
            RuleBasedCollator myJapaneseCollator
                         = new RuleBasedCollator(en_USCollator.getRules() + jaString);

</區塊引用>

此職業不可次級

Java 文件 android.icu.text.RuleBasedCollator。

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