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

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').

</blockquote>

对于排序规则排序规则比较，只需使用基本算术运算符（例如 <、== 或 >）来比较排序规则元素结果，必须进一步处理。 可以在 ICU 用户指南中找到详细信息。 将 CollationElementIterator 用于排序规则排序比较的示例是类 android.icu.text.StringSearch。

若要构造 CollationElementIterator 对象，用户对定义所需排序顺序的 RuleBasedCollator 调用 method getCollationElementIterator（）。

示例： <blockquote>

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

</blockquote>

方法 next（） 基于排序规则器的比较级别返回下一个字符的排序规则顺序。 方法 previous（） 基于排序规则器的比较级别返回上一个字符的排序规则顺序。 排序规则元素迭代器仅在对 reset（）、setOffset（）或 setText（）的调用之间移动一个方向。 也就是说，下一个（）和上一个（）不能相互使用。 每当在 next（） 之后调用 previous（）或反之亦然时，必须首先调用 reset（）、setOffset（） 或 setText（）来重置状态，将当前位置移到字符串（reset（） 或 setText（）的末尾或开头（setOffset（）或指定位置（setOffset（））。 因此，在下一次调用 next（） 或 previous（）、第一个或最后一个排序规则顺序时，将返回位于指定位置的排序规则顺序。 如果在没有其中一个调用的情况下完成方向更改，则结果未定义。

此类不可进行子类化。

Java文档android.icu.text.CollationElementIterator。

本页的某些部分是根据 创建和共享的工作进行的修改，并根据 许可证中所述的条款使用。