Интерфейс AttributedCharacterIterator

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

public interface AttributedCharacterIterator extends CharacterIterator

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

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

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

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

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

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

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

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

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

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

С:

1.2

См. также:

Краткое описание вложенных классов

Модификатор и тип	Интерфейс	Описание
`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()

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

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

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.base/java/text/AttributedCharacterIterator.html