Interface CharacterRange

All Superinterfaces:

ClassFileElementPREVIEW, CodeElementPREVIEW, PseudoInstructionPREVIEW

public sealed interface CharacterRange
extends PseudoInstructionPREVIEW

CharacterRange is a preview API of the Java platform.

Programs can only use CharacterRange when preview features are enabled.

Preview features may be removed in a future release, or upgraded to permanent features of the Java platform.

A pseudo-instruction which models a single entry in the CharacterRangeTableAttribute^PREVIEW. Delivered as a CodeElement^PREVIEW during traversal of the elements of a CodeModel^PREVIEW, according to the setting of the ClassFile.DebugElementsOption^PREVIEW option.

Since:

22

Field Summary

Fields

Modifier and Type	Field	Description
static final int	FLAG_ASSIGNMENT	The bit mask of ASSIGNMENT CharacterRangeInfoPREVIEW kind.
static final int	FLAG_BLOCK	The bit mask of BLOCK CharacterRangeInfoPREVIEW kind.
static final int	FLAG_BRANCH_FALSE	The bit mask of BRANCH_FALSE CharacterRangeInfoPREVIEW kind.
static final int	FLAG_BRANCH_TRUE	The bit mask of BRANCH_TRUE CharacterRangeInfoPREVIEW kind.
static final int	FLAG_CREATE	The bit mask of CREATE CharacterRangeInfoPREVIEW kind.
static final int	FLAG_FLOW_CONTROLLER	The bit mask of FLOW_CONTROLLER CharacterRangeInfoPREVIEW kind.
static final int	FLAG_FLOW_TARGET	The bit mask of FLOW_TARGET CharacterRangeInfoPREVIEW kind.
static final int	FLAG_INVOKE	The bit mask of INVOKE CharacterRangeInfoPREVIEW kind.
static final int	FLAG_STATEMENT	The bit mask of STATEMENT CharacterRangeInfoPREVIEW kind.

Method Summary

Modifier and Type	Method	Description
int	characterRangeEnd()	Returns the encoded end of the character range region (exclusive).
int	characterRangeStart()	Returns the encoded start of the character range region (inclusive).
LabelPREVIEW	endScope()	Returns the end of the instruction range.
int	flags()	A flags word, indicating the kind of range.
static CharacterRangePREVIEW	of(LabelPREVIEW startScope, LabelPREVIEW endScope, int characterRangeStart, int characterRangeEnd, int flags)	Returns a character range pseudo-instruction.
LabelPREVIEW	startScope()	Returns the start of the instruction range.

Field Details

FLAG_STATEMENT

static final int FLAG_STATEMENT

The bit mask of STATEMENT CharacterRangeInfo^PREVIEW kind.

See Also:

• Constant Field Values

FLAG_BLOCK

static final int FLAG_BLOCK

The bit mask of BLOCK CharacterRangeInfo^PREVIEW kind.

See Also:

• Constant Field Values

FLAG_ASSIGNMENT

static final int FLAG_ASSIGNMENT

The bit mask of ASSIGNMENT CharacterRangeInfo^PREVIEW kind.

See Also:

• Constant Field Values

FLAG_FLOW_CONTROLLER

static final int FLAG_FLOW_CONTROLLER

The bit mask of FLOW_CONTROLLER CharacterRangeInfo^PREVIEW kind.

See Also:

• Constant Field Values

FLAG_FLOW_TARGET

static final int FLAG_FLOW_TARGET

The bit mask of FLOW_TARGET CharacterRangeInfo^PREVIEW kind.

See Also:

• Constant Field Values

FLAG_INVOKE

static final int FLAG_INVOKE

The bit mask of INVOKE CharacterRangeInfo^PREVIEW kind.

See Also:

• Constant Field Values

FLAG_CREATE

static final int FLAG_CREATE

The bit mask of CREATE CharacterRangeInfo^PREVIEW kind.

See Also:

• Constant Field Values

FLAG_BRANCH_TRUE

static final int FLAG_BRANCH_TRUE

The bit mask of BRANCH_TRUE CharacterRangeInfo^PREVIEW kind.

See Also:

• Constant Field Values

FLAG_BRANCH_FALSE

static final int FLAG_BRANCH_FALSE

The bit mask of BRANCH_FALSE CharacterRangeInfo^PREVIEW kind.

See Also:

• Constant Field Values

Method Details

startScope

LabelPREVIEW startScope()

Returns the start of the instruction range.

Returns:

the start of the instruction range

endScope

LabelPREVIEW endScope()

Returns the end of the instruction range.

Returns:

the end of the instruction range

characterRangeStart

int characterRangeStart()

Returns the encoded start of the character range region (inclusive). The value is constructed from the line_number/column_number pair as given by line_number << 10 + column_number, where the source file is viewed as an array of (possibly multi-byte) characters.

Returns:

the encoded start of the character range region (inclusive)

characterRangeEnd

int characterRangeEnd()

Returns the encoded end of the character range region (exclusive).. The value is constructed from the line_number/column_number pair as given by line_number << 10 + column_number, where the source file is viewed as an array of (possibly multi-byte) characters.

Returns:

the encoded end of the character range region (exclusive)

flags

int flags()

A flags word, indicating the kind of range. Multiple flag bits may be set. Valid flags include:

• FLAG_STATEMENT
• FLAG_BLOCK
• FLAG_ASSIGNMENT
• FLAG_FLOW_CONTROLLER
• FLAG_FLOW_TARGET
• FLAG_INVOKE
• FLAG_CREATE
• FLAG_BRANCH_TRUE
• FLAG_BRANCH_FALSE

Returns:

the flags

See Also:

• CharacterRangeInfo.flags()^PREVIEW

of

static CharacterRangePREVIEW of(LabelPREVIEW startScope,
 LabelPREVIEW endScope,
 int characterRangeStart,
 int characterRangeEnd,
 int flags)

Returns a character range pseudo-instruction.

Parameters:

startScope - the start of the instruction range

endScope - the end of the instruction range

characterRangeStart - the encoded start of the character range region (inclusive)

characterRangeEnd - the encoded end of the character range region (exclusive)

flags - a flags word, indicating the kind of range

Returns:

a character range pseudo-instruction