Интерфейс SourcePositions

Все известные подинтерфейсы:: DocSourcePositions

public interface SourcePositions

Предоставляет методы для получения позиции Tree в CompilationUnit. Позиция определяется как смещение в символах от начала CompilationUnit, где первый символ находится по смещению 0.

С версии:: 1.6

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

Модификатор и тип	Метод	Описание
`default long`	`getEndPosition(CompilationUnitTree file, Tree tree)`	Устарело, будет удалено: этот элемент API планируется удалить в будущей версии. вместо этого используйте `getEndPosition(Tree)`
`long`	`getEndPosition(Tree tree)`	Возвращает конечную позицию указанного `Tree`. Если конечная позиция недоступна, возвращает `Diagnostic.NOPOS`.
`default long`	`getStartPosition(CompilationUnitTree file, Tree tree)`	Устарело, будет удалено: этот элемент API планируется удалить в будущей версии. вместо этого используйте `getStartPosition(Tree)`
`long`	`getStartPosition(Tree tree)`	Возвращает начальную позицию указанного `Tree` или, если начальная позиция недоступна, возвращает `Diagnostic.NOPOS`.

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

getStartPosition

@Deprecated(since="27", forRemoval=true) default long getStartPosition(CompilationUnitTree file, Tree tree)

Устарело, будет удалено: этот элемент API планируется удалить в будущей версии.

вместо этого используйте getStartPosition(Tree)

Возвращает начальную позицию дерева в файле. Если дерево не найдено в файле или начальная позиция недоступна, возвращает Diagnostic.NOPOS. Возвращаемая позиция должна указывать на начало области, занимаемой этим деревом; то есть для любого поддерева этого дерева должно выполняться следующее:

getStartPosition(file, tree) <= getStartPosition(file, subtree) или
getStartPosition(file, tree) == NOPOS или
getStartPosition(file, subtree) == NOPOS

Параметры:: file — CompilationUnit, в которой нужно найти дерево; tree — дерево, для которого требуется найти позицию
Возвращает:: начальную позицию дерева

getStartPosition

long getStartPosition(Tree tree)

Возвращает начальную позицию указанного Tree или, если начальная позиция недоступна, возвращает Diagnostic.NOPOS.

Возвращаемая позиция должна указывать на начало области, занимаемой этим деревом; то есть для любого поддерева этого дерева должно выполняться следующее:

getStartPosition(tree) <= getStartPosition(subtree) или
getStartPosition(tree) == NOPOS или
getStartPosition(subtree) == NOPOS

Параметры:: tree — дерево, для которого требуется найти позицию
Возвращает:: начальную позицию указанного Tree или, если начальная позиция недоступна, возвращает Diagnostic.NOPOS
С версии:: 27

getEndPosition

@Deprecated(since="27", forRemoval=true) default long getEndPosition(CompilationUnitTree file, Tree tree)

Устарело, будет удалено: этот элемент API планируется удалить в будущей версии.

вместо этого используйте getEndPosition(Tree)

Возвращает конечную позицию дерева в файле. Если дерево не найдено в файле или конечная позиция недоступна, возвращает Diagnostic.NOPOS. Возвращаемая позиция должна указывать на конец области, занимаемой этим деревом; то есть для любого поддерева этого дерева должно выполняться следующее:

getEndPosition(file, tree) >= getEndPosition(file, subtree) или
getEndPosition(file, tree) == NOPOS или
getEndPosition(file, subtree) == NOPOS

Кроме того, должно выполняться следующее:

getStartPosition(file, tree) <= getEndPosition(file, tree) или
getStartPosition(file, tree) == NOPOS или
getEndPosition(file, tree) == NOPOS

Параметры:: file — CompilationUnit, в которой нужно найти дерево; tree — дерево, для которого требуется найти позицию
Возвращает:: конечную позицию дерева

getEndPosition

long getEndPosition(Tree tree)

Возвращает конечную позицию указанного Tree. Если конечная позиция недоступна, возвращает Diagnostic.NOPOS.

Возвращаемая позиция должна указывать на конец области, занимаемой этим деревом; то есть для любого поддерева этого дерева должно выполняться следующее:

getEndPosition(tree) >= getEndPosition(subtree) или
getEndPosition(tree) == NOPOS или
getEndPosition(subtree) == NOPOS

Кроме того, должно выполняться следующее:

getStartPosition(tree) <= getEndPosition(tree) или
getStartPosition(tree) == NOPOS или
getEndPosition(tree) == NOPOS

Параметры:: tree — дерево, для которого требуется найти позицию
Возвращает:: конечную позицию указанного Tree. Если конечная позиция недоступна, возвращает Diagnostic.NOPOS
С версии:: 27

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