com.oracle.truffle.api

Class TruffleStackTraceElement

java.lang.Object

com.oracle.truffle.api.TruffleStackTraceElement

public final class TruffleStackTraceElement
extends Object

Represents a guest stack trace element.

Since:

0.27

Method Summary

Modifier and Type	Method and Description
static void	fillIn(Throwable throwable) Fills in the guest language stack frames from the current frames on the stack.
Frame	getFrame() Returns the materialized frame.
Node	getLocation() Returns a node representing the callsite on the stack.
static List<TruffleStackTraceElement>	getStackTrace(Throwable throwable) Returns the guest language frames that are stored in this throwable or null if no guest language frames are available.
RootCallTarget	getTarget() Returns the call target on the stack.

Methods inherited from class java.lang.Object

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

Method Detail

getLocation

public Node getLocation()

Returns a node representing the callsite on the stack. Returns null if no detailed callsite information is available.

Since:

0.27

getTarget

public RootCallTarget getTarget()

Returns the call target on the stack. Returns never null.

Since:

0.27

getFrame

public Frame getFrame()

Returns the materialized frame. Returns null if the initial RootNode that filled in the stack trace did not request frames to be captured by overriding RootNode.isCaptureFramesForTrace().

Since:

0.31

getStackTrace

public static List<TruffleStackTraceElement> getStackTrace(Throwable throwable)

Returns the guest language frames that are stored in this throwable or null if no guest language frames are available. Guest language frames are automatically added by the Truffle runtime the first time the exception is passed through a call target and the frames are not yet set. Therefore no guest language frames are available immediately after the exception was constructed. The returned list is not modifiable. The number stack trace elements that are filled in can be customized by implementing TruffleException.getStackTraceElementLimit() .

Parameters:

throwable - the throwable instance to look for guest language frames

Since:

0.27

See Also:

To force early filling of guest language stack frames.

fillIn

public static void fillIn(Throwable throwable)

Fills in the guest language stack frames from the current frames on the stack. If the stack was already filled before then this method has no effect. The implementation attaches a lightweight exception object to the last location in the cause chain of the exception. The number stack trace elements that are filled in can be customized by implementing TruffleException.getStackTraceElementLimit() .

Parameters:

throwable - the throwable to fill

Since:

0.27