模块 java.base
包 java.text

接口 AttributedCharacterIterator

所有父级接口：
CharacterIterator , Cloneable
public interface AttributedCharacterIterator extends CharacterIterator
AttributedCharacterIterator 允许迭代文本和相关属性信息。

属性是键/值对，由键标识。给定字符的两个属性不能具有相同的键。

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

run with respect to an attribute 是最大文本范围，其中：

  • 整个范围的属性未定义或null，或
  • 属性值已定义并且在整个范围内具有相同的非null值。

run with respect to a set of attributes 是每个成员属性满足此条件的最大文本范围。

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

返回的索引被限制在迭代器的范围内。

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

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

自从：
1.2
参见：

  • 方法详情

    • 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 - 一组所需的属性
      返回：
      运行后第一个字符的索引

    • getAttributes

      Map <AttributedCharacterIterator.Attribute ,Object > getAttributes()
      返回具有当前角色定义的属性的map。
      返回：
      具有在当前角色上定义的属性的map

    • getAttribute

      Object  getAttribute(AttributedCharacterIterator.Attribute  attribute)
      返回当前字符的命名 attribute 的值。如果未定义 attribute，则返回 null。
      参数：
      attribute - 所需的属性
      返回：
      命名 attribute 或 null 的值

    • getAllAttributeKeys

      Set <AttributedCharacterIterator.Attribute > getAllAttributeKeys()
      返回在迭代器的文本范围内定义的所有属性的键。如果未定义任何属性，则该集合为空。
      返回：
      所有属性的键