Module  java.base
软件包  java.text

Interface AttributedCharacterIterator

  • All Superinterfaces:
    CharacterIterator ， Cloneable 

    public interface AttributedCharacterIterator
extends CharacterIterator
    一个AttributedCharacterIterator允许通过文本和相关的属性信息进行迭代。

    属性是由键标识的键/值对。 给定字符上没有两个属性可以具有相同的键。

    属性的值是不可变的，不能被客户机或存储设备突变。 它们总是通过引用传递，而不是被克隆。

    关于属性的运行是一个最大文本范围：

    • 该属性未定义，或null为整个范围，或
    • 属性值被定义，并且对于整个范围具有相同的非null值。

    相对于一组属性的运行是每个成员属性满足此条件的最大文本范围。

    当获得没有指定明确属性的运行（即调用getRunStart()和getRunLimit() ）时，具有相同属性（相同属性/值对集合）的任何连续文本段被视为单独的运行，如果属性已被赋予这些文本段分开。

    返回的索引仅限于迭代器的范围。

    返回的属性信息仅限于包含当前字符的运行。

    属性键是AttributedCharacterIterator.Attribute及其子类的实例，例如TextAttribute 。

    从以下版本开始：
    1.2
    另请参见：
    AttributedCharacterIterator.Attribute ， TextAttribute ， AttributedString ， Annotation

    • 方法详细信息

      • getRunStart

        int getRunStart​()
        相对于包含当前字符的所有属性返回运行的第一个字符的索引。

        如果已将属性分别提供给这些文本段，则具有相同属性（相同的属性/值对集合）的任何连续文本段被视为单独的运行。

        结果
        运行的第一个字符的索引

      • getRunStart

        int getRunStart​(AttributedCharacterIterator.Attribute attribute)
        相对于包含当前字符的给定 attribute返回运行的第一个字符的索引。
        参数
        attribute - 所需属性。
        结果
        运行的第一个字符的索引

      • getRunStart

        int getRunStart​(Set<? extends AttributedCharacterIterator.Attribute> attributes)
        相对于包含当前字符的给定的 attributes返回运行的第一个字符的索引。
        参数
        attributes - 一组所需属性。
        结果
        运行的第一个字符的索引

      • getRunLimit

        int getRunLimit​()
        相对于包含当前字符的所有属性返回运行后第一个字符的索引。

        如果已将属性分别提供给这些文本段，则具有相同属性（相同的属性/值对集合）的任何连续文本段被视为单独的运行。

        结果
        运行后的第一个字符的索引

      • getRunLimit

        int getRunLimit​(AttributedCharacterIterator.Attribute attribute)
        相对于包含当前字符的给定的 attribute返回运行后的第一个字符的索引。
        参数
        attribute - 所需属性
        结果
        运行后的第一个字符的索引

      • getRunLimit

        int getRunLimit​(Set<? extends AttributedCharacterIterator.Attribute> attributes)
        返回运行后相对于包含当前字符的给定 attributes的第一个字符的索引。
        参数
        attributes - 一组所需属性
        结果
        运行后的第一个字符的索引

      • getAttribute

        Object getAttribute​(AttributedCharacterIterator.Attribute attribute)
        返回当前字符的名称为attribute的值。 如果attribute则返回null 。
        参数
        attribute - 所需属性
        结果
        名称为 attribute或 null的值

      • getAllAttributeKeys

        Set<AttributedCharacterIterator.Attribute> getAllAttributeKeys​()
        返回在迭代器的文本范围上定义的所有属性的关键字。 如果没有定义属性，则该集合为空。
        结果
        the keys of all attributes