Интерфейс AttributedCharacterIterator
- Все суперинтерфейсы:
CharacterIterator, Cloneable
public interface AttributedCharacterIterator extends CharacterIterator
AttributedCharacterIterator позволяет выполнять итерацию как по тексту, так и по связанным с ним сведениям об атрибутах. Атрибут — это пара «ключ/значение», идентифицируемая ключом. Для одного символа два атрибута не могут иметь одинаковый ключ.
Значения атрибутов являются неизменяемыми либо не должны изменяться клиентами или хранилищем. Они всегда передаются по ссылке, а не клонируются.
Диапазон относительно атрибута — это максимальный диапазон текста, для которого выполняется одно из условий:
- атрибут не определён или
nullдля всего диапазона; либо - значение атрибута определено и имеет одинаковое значение, не являющееся
null, для всего диапазона.
Диапазон относительно набора атрибутов — это максимальный диапазон текста, для которого данное условие выполняется для каждого атрибута из набора.
При получении диапазона без явного указания атрибутов (то есть при вызове getRunStart() и getRunLimit()) любые смежные сегменты текста с одинаковыми атрибутами (одинаковым набором пар «атрибут/значение») рассматриваются как отдельные диапазоны, если атрибуты были заданы для этих сегментов текста по отдельности.
Возвращаемые индексы ограничены диапазоном итератора.
Возвращаемые сведения об атрибутах ограничены диапазонами, содержащими текущий символ.
Ключи атрибутов являются экземплярами AttributedCharacterIterator.Attribute и его подклассов, таких как TextAttribute.
- Начиная с версии:
- 1.2
- См. также:
Краткое описание вложенных классов
| Модификатор и тип | Интерфейс | Описание |
|---|---|---|
static class |
AttributedCharacterIterator.Attribute |
Определяет ключи атрибутов, используемые для идентификации текстовых атрибутов. |
Краткое описание полей
Поля, объявленные в интерфейсе CharacterIterator
DONE
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
Set |
getAllAttributeKeys() |
Возвращает ключи всех атрибутов, определённых в текстовом диапазоне итератора. |
Object |
getAttribute |
Возвращает значение именованного attribute для текущего символа. |
Map |
getAttributes() |
Возвращает карту атрибутов, определённых для текущего символа. |
int |
getRunLimit() |
Возвращает индекс первого символа, следующего за диапазоном относительно всех атрибутов, содержащим текущий символ. |
int |
getRunLimit |
Возвращает индекс первого символа, следующего за диапазоном относительно заданного attribute, содержащим текущий символ. |
int |
getRunLimit |
Возвращает индекс первого символа, следующего за диапазоном относительно заданного attributes, содержащим текущий символ. |
int |
getRunStart() |
Возвращает индекс первого символа диапазона относительно всех атрибутов, содержащего текущий символ. |
int |
getRunStart |
Возвращает индекс первого символа диапазона относительно заданного attribute, содержащего текущий символ. |
int |
getRunStart |
Возвращает индекс первого символа диапазона относительно заданного attributes, содержащего текущий символ. |
Методы, объявленные в интерфейсе 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://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/text/AttributedCharacterIterator.html
