Class ExceptionHandler

java.lang.Object

com.oracle.truffle.api.bytecode.ExceptionHandler

public abstract class ExceptionHandler
extends Object

Introspection class modeling the meta-information of an exception handler in a bytecode interpreter. An exception handler stores information for bytecode index ranges that determine how an exception should be handled at a particular location.

Note: Introspection classes are intended to be used for debugging purposes only. These APIs may change in the future.

Since:

24.2

See Also:

• BytecodeNode.getExceptionHandlers()
• BytecodeLocation.getExceptionHandlers()

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	ExceptionHandler.HandlerKind	Represents the kind of the exception handler.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	ExceptionHandler(Object token)	Internal constructor for generated code.

Method Summary

Modifier and Type	Method	Description
abstract int	getEndBytecodeIndex()	Returns the end bytecode index guarded by this exception handler (exclusive).
int	getHandlerBytecodeIndex()	Returns the bytecode index of the handler code if this exception handler is of kind ExceptionHandler.HandlerKind.CUSTOM.
abstract ExceptionHandler.HandlerKind	getKind()	Returns a kind that determines whether the handler is a custom or special exception handler.
abstract int	getStartBytecodeIndex()	Returns the start bytecode index guarded by this exception handler (inclusive).
TagTree	getTagTree()	Returns the tag tree of this exception handler if this exception handler is of kind ExceptionHandler.HandlerKind.TAG.
final String	toString()

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Details

ExceptionHandler

protected ExceptionHandler(Object token)

Internal constructor for generated code. Do not use.

Since:

24.2

Method Details

getKind

public abstract ExceptionHandler.HandlerKind getKind()

Returns a kind that determines whether the handler is a custom or special exception handler.

Since:

24.2

See Also:

• ExceptionHandler.HandlerKind

getStartBytecodeIndex

public abstract int getStartBytecodeIndex()

Returns the start bytecode index guarded by this exception handler (inclusive).

Since:

24.2

getEndBytecodeIndex

public abstract int getEndBytecodeIndex()

Returns the end bytecode index guarded by this exception handler (exclusive).

Since:

24.2

getHandlerBytecodeIndex

public int getHandlerBytecodeIndex()
                            throws UnsupportedOperationException

Returns the bytecode index of the handler code if this exception handler is of kind ExceptionHandler.HandlerKind.CUSTOM.

Throws:

UnsupportedOperationException - for handlers not of kind ExceptionHandler.HandlerKind.CUSTOM

Since:

24.2

getTagTree

public TagTree getTagTree()
                   throws UnsupportedOperationException

Returns the tag tree of this exception handler if this exception handler is of kind ExceptionHandler.HandlerKind.TAG.

Throws:

UnsupportedOperationException - for handlers not of kind ExceptionHandler.HandlerKind.TAG

Since:

24.2

toString

public final String toString()

Overrides:

toString in class Object

Since:

24.2