CollationElementIterator 類別

定義

[Android.Runtime.Register("android/icu/text/CollationElementIterator", ApiSince=24, DoNotGenerateAcw=true)]
public sealed class CollationElementIterator : Java.Lang.Object

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

繼承

Object

JavaObject

Object

CollationElementIterator

屬性

RegisterAttribute

備註

CollationElementIterator 是由 RuleBasedCollator 建立的迭代器，用來遍歷字串。 每次迭代的回傳結果是一個 32 位元的校對元素（CE），用以定義來源字串中下一個字元或一連串字元的排序優先順序。

舉例來說，以下斯洛伐克語和傳統西班牙語排序格式如下： <blockquote>

"ca" -> the first collation element is CE('c') and the second
                    collation element is CE('a').
            "cha" -> the first collation element is CE('ch') and the second
                     collation element is CE('a').

</blockquote> 在德語電話簿彙編中，blockquote <>

Since the character 'æ' is a composed character of 'a' and 'e', the
            iterator returns two collation elements for the single character 'æ'

            "æb" -> the first collation element is collation_element('a'), the
                         second collation element is collation_element('e'), and the
                         third collation element is collation_element('b').

</區塊引用>

對於排序排序的比較，無法僅用基本算術運算子（例如 <、== 或 >）來比較排序元素結果，因此還需進一步處理。 詳細資訊請參閱加護病房 使用者指南。 使用 CollationElementIterator 進行排序比較的例子是類別 android.icu.text.StringSearch。

要建構 CollationElementIterator 物件，使用者會在定義所需排序順序的 RuleBasedCollator 上呼叫 getCollationElementIterator（） 這個方法。

範例： <區塊引號>

String testString = "This is a test";
             RuleBasedCollator rbc = new RuleBasedCollator("&a<b");
             CollationElementIterator iterator = rbc.getCollationElementIterator(testString);
             int primaryOrder = iterator.IGNORABLE;
             while (primaryOrder != iterator.NULLORDER) {
                 int order = iterator.next();
                 if (order != iterator.IGNORABLE &&
                     order != iterator.NULLORDER) {
                     // order is valid, not ignorable and we have not passed the end
                     // of the iteration, we do something
                     primaryOrder = CollationElementIterator.primaryOrder(order);
                     System.out.println("Next primary order 0x" +
                                        Integer.toHexString(primaryOrder));
                 }
             }

</區塊引用>

next（） 方法會根據整理器的比較層級回傳下一個字元的排序順序。 前述方法（）會回傳前一個字元的排序順序，該排序基於整理器的比較層級。 排序元素迭代器在呼叫 reset（）、setOffset（或 setText（） 之間僅向一個方向移動。 也就是說，next（） 與 previous （） 不可互用。 每當 next（） 或反之，必須先呼叫 reset（）、setOffset（） 或 setText（） 來重置狀態，將當前位置移至字串的末尾或起始（reset（） 或 setText（）），或指定位置（setOffset（））。 因此，在下一次 next（） 或 presious（） 的呼叫時，會回傳第一個或最後一個排序順序，或指定位置的排序順序。 若改變方向時未使用上述任何一個呼叫，結果則未定義。

這個職業不適合子職業。

Java 文件 android.icu.text.CollationElementIterator。

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