Интерфейс AttributedCharacterIterator

Все суперинтерфейсы:: CharacterIterator, Cloneable

public interface AttributedCharacterIterator
extends CharacterIterator

Объект AttributedCharacterIterator позволяет итерироваться по тексту и связанной с ним информации об атрибутах.

Атрибут представляет собой пару «ключ/значение», идентифицируемую по ключу. Два атрибута одного символа не могут иметь одинаковый ключ.

Значения атрибутов неизменяемы (не могут быть изменены клиентами или хранилищем). Они всегда передаются по ссылке, а не клонируются.

Последовательность символов относительно атрибута — это максимальный диапазон текста, для которого:

атрибут не определён или null для всего диапазона, или
значение атрибута определено и имеет то же значение, отличное от null для всего диапазона.

Последовательность символов относительно набора атрибутов — это максимальный диапазон текста, для которого это условие выполняется для каждого атрибута в наборе.

При получении последовательности без явного указания атрибутов (т.е., вызове getRunStart() и getRunLimit()), любые смежные сегменты текста, имеющие одинаковые атрибуты (одинаковый набор пар атрибут/значение), рассматриваются как отдельные последовательности, если атрибуты были заданы для этих сегментов по отдельности.

Возвращаемые индексы ограничены диапазоном итератора.

Возвращаемая информация об атрибутах ограничена последовательностями, содержащими текущий символ.

Ключи атрибутов являются экземплярами AttributedCharacterIterator.Attribute и его подклассов, таких как TextAttribute.

С момента:: 1.2
См. также:: AttributedCharacterIterator.Attribute, TextAttribute, AttributedString, Annotation

Вложенные классы

Модификатор и тип	Интерфейс	Описание
`static class`	`AttributedCharacterIterator.Attribute`	Определяет ключи атрибутов, используемые для идентификации атрибутов текста.

Поля

Поля, объявленные в интерфейсе java.text.CharacterIterator

DONE

Методы

Модификатор и тип	Метод	Описание
`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` , содержащего текущий символ.

Методы, объявленные в интерфейсе 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()

Возвращает ключи всех атрибутов, определённых в диапазоне текста итератора. Множество пустое, если атрибуты не определены.

Возвращает:: ключи всех атрибутов