Interface TagTree

All Known Implementing Classes:

TagTreeNode

public interface TagTree

Logical tree representation of the Tag operations of a bytecode program.

Since:

24.2

See Also:

• Tag
• BytecodeNode.getTagTree()

Method Summary

Modifier and Type	Method	Description
int	getEnterBytecodeIndex()	Returns the bytecode index at which the interpreter enters the tag operation.
int	getReturnBytecodeIndex()	Returns the bytecode index at which the interpreter "returns" from the tag operation.
SourceSection	getSourceSection()	Gets the most concrete source location associated with the tag operation.
SourceSection[]	getSourceSections()	Gets all source locations associated with the tag operation, ordered from most to least concrete.
List<Class<? extends Tag>>	getTags()	Returns the tags associated with this node.
List<TagTree>	getTreeChildren()	Returns the child trees corresponding to Tag operations nested in this node.
boolean	hasTag(Class<? extends Tag> tag)	Returns whether the given tag is associated with this node.

Method Details

getTreeChildren

List<TagTree> getTreeChildren()

Returns the child trees corresponding to Tag operations nested in this node.

Since:

24.2

getTags

List<Class<? extends Tag>> getTags()

Returns the tags associated with this node.

Since:

24.2

hasTag

boolean hasTag(Class<? extends Tag> tag)

Returns whether the given tag is associated with this node.

Parameters:

tag - the tag to search for

Since:

24.2

getEnterBytecodeIndex

int getEnterBytecodeIndex()

Returns the bytecode index at which the interpreter enters the tag operation. The bytecode interpreter will invoke ProbeNode.onEnter(VirtualFrame) at this point in the program.

Since:

24.2

getReturnBytecodeIndex

int getReturnBytecodeIndex()

Returns the bytecode index at which the interpreter "returns" from the tag operation. The bytecode interpreter will invoke ProbeNode.onReturnValue(VirtualFrame, Object) with the child operation's result (if any) at this point in the program.

Note: the instruction at this index is not necessarily a return, but the value it produces is treated as a return value for the sake of instrumentation. There can also be other return points if the child operation has early exits; this method returns the regular return point.

Since:

24.2

getSourceSection

SourceSection getSourceSection()

Gets the most concrete source location associated with the tag operation.

Since:

24.2

See Also:

• BytecodeNode.getSourceLocation(com.oracle.truffle.api.frame.Frame, com.oracle.truffle.api.nodes.Node)

getSourceSections

SourceSection[] getSourceSections()

Gets all source locations associated with the tag operation, ordered from most to least concrete.

Since:

24.2

See Also:

• BytecodeNode.getSourceLocations(com.oracle.truffle.api.frame.Frame, com.oracle.truffle.api.nodes.Node)