compact1, compact2, compact3

java.text

Interface AttributedCharacterIterator

All Superinterfaces:

CharacterIterator ， Cloneable

public interface AttributedCharacterIterator
extends CharacterIterator

AttributedCharacterIterator允许通过文本和相关属性信息进行迭代。

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

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

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

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

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

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

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

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

属性键的情况下， AttributedCharacterIterator.Attribute和它的子类，如TextAttribute 。

从以下版本开始：

1.2

另请参见：

AttributedCharacterIterator.Attribute ， TextAttribute ， AttributedString ， Annotation

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	AttributedCharacterIterator.Attribute 定义用于标识文本属性的属性键。

Field Summary

Fields inherited from interface java.text.CharacterIterator

DONE

方法摘要

Modifier and Type	Method and Description
Set<AttributedCharacterIterator.Attribute>	getAllAttributeKeys() 返回在迭代器的文本范围上定义的所有属性的关键字。
Object	getAttribute(AttributedCharacterIterator.Attribute attribute) 返回当前字符的命名为 attribute的值。
Map<AttributedCharacterIterator.Attribute,Object>	getAttributes() 返回当前字符中定义的属性的地图。
int	getRunLimit() 相对于包含当前字符的所有属性返回运行后第一个字符的索引。
int	getRunLimit(AttributedCharacterIterator.Attribute attribute) 相对于包含当前字符的给定 attribute返回运行后第一个字符的索引。
int	getRunLimit(Set<? extends AttributedCharacterIterator.Attribute> attributes) 相对于包含当前字符的给定 attributes返回运行后的第一个字符的索引。
int	getRunStart() 相对于包含当前字符的所有属性返回运行的第一个字符的索引。
int	getRunStart(AttributedCharacterIterator.Attribute attribute) 相对于包含当前字符的给定 attribute返回运行的第一个字符的索引。
int	getRunStart(Set<? extends AttributedCharacterIterator.Attribute> attributes) 相对于包含当前字符的给定 attributes返回运行的第一个字符的索引。

Methods inherited from interface java.text.CharacterIterator

clone, current, first, getBeginIndex, getEndIndex, getIndex, last, next, previous, setIndex

方法详细信息

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()

返回当前字符中定义的属性的地图。

结果

具有当前字符定义的属性的地图

getAttribute

Object getAttribute(AttributedCharacterIterator.Attribute attribute)

返回当前字符的命名为attribute的值。 返回null如果attribute没有定义。

参数

attribute - 所需属性

结果

该值为 attribute或 null

getAllAttributeKeys

Set<AttributedCharacterIterator.Attribute> getAllAttributeKeys()

返回在迭代器的文本范围上定义的所有属性的关键字。 如果没有定义属性，则该集合为空。

结果

the keys of all attributes