Интерфейс CharacterRangeTableAttribute

Все суперинтерфейсы:: Attribute<CharacterRangeTableAttribute>, ClassFileElement

public sealed interface CharacterRangeTableAttribute extends Attribute<CharacterRangeTableAttribute>

Описывает атрибут CharacterRangeTable, представляющий собой двунаправленное сопоставление диапазонов позиций в исходном файле с диапазонами индексов в массиве code. При обходе элементов CodeModel его записи передаются как CharacterRange, включение и отключение которых регулируется параметром ClassFile.DebugElementsOption.

Атрибут CharacterRangeTable состоит из массива записей диапазонов символов. Записи диапазонов символов образуют древовидную структуру: любые две записи либо не пересекаются, либо, если они пересекаются, одна запись должна полностью содержаться в другой — как в массиве code, так и по позициям символов в исходном файле. Записи диапазонов символов могут располагаться в произвольном порядке.

Этот атрибут встречается только в атрибутах Code, допускает многократное появление, но в атрибуте Code должен появляться только один раз. Он зависит от данных меток.

Этот атрибут нельзя передать в CodeBuilder; его записи можно создать с помощью CharacterRange, в результате чего в созданном атрибуте Code будет не более одного экземпляра атрибута.

Этот атрибут не является предопределённым в платформе Java SE. Это нестандартный атрибут, специфичный для JDK, создаваемый эталонной реализацией системного компилятора Java и определённый модулем jdk.compiler.

Начиная с версии:

См. также:

Краткое описание методов

Модификатор и тип	Метод	Описание
`List<CharacterRangeInfo>`	`characterRangeTable()`	Возвращает записи таблицы диапазонов символов.
`static CharacterRangeTableAttribute`	`of(List<CharacterRangeInfo> ranges)`	Возвращает атрибут `CharacterRangeTable`.

Методы, объявленные в интерфейсе Attribute

attributeMapper, attributeName

Модификатор и тип	Метод	Описание
`AttributeMapper<CharacterRangeTableAttribute>`	`attributeMapper()`	Возвращает `AttributeMapper`, связанный с этим атрибутом.
`Utf8Entry`	`attributeName()`	Возвращает имя атрибута.

Подробное описание методов

characterRangeTable

List<CharacterRangeInfo> characterRangeTable()

Возвращает записи таблицы диапазонов символов.

Возвращает:: записи таблицы диапазонов символов

of

static CharacterRangeTableAttribute of(List<CharacterRangeInfo> ranges)

Возвращает атрибут CharacterRangeTable.

Примечание по API:: Созданный атрибут нельзя записать в CodeBuilder. Вместо этого используйте CodeBuilder::characterRange.
Параметры:: ranges — описания диапазонов символов
Возвращает:: атрибут CharacterRangeTable
Вызывает исключение:: IllegalArgumentException — если число диапазонов превышает ограничение u2

© 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.