Module  java.base
软件包  java.text

Interface AttributedCharacterIterator

  • All Superinterfaces:
    CharacterIteratorCloneable


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

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

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

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

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

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

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

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

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

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

    从以下版本开始:
    1.2
    另请参见:
    AttributedCharacterIterator.AttributeTextAttributeAttributedStringAnnotation
    • 方法详细信息

      • 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 - 所需属性
        结果
        名称为 attributenull的值
      • getAllAttributeKeys

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