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 TruffleStackTraceElement	create(Node location, RootCallTarget target, Frame frame) Create a new stack trace element.
Frame	getFrame() Returns the materialized frame.
Node	getLocation() Returns a node representing the callsite on the stack.
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

create

public static TruffleStackTraceElement create(Node location,
                                              RootCallTarget target,
                                              Frame frame)

Create a new stack trace element.

Parameters:

location - See TruffleStackTraceElement.getLocation()

target - See TruffleStackTraceElement.getTarget()

frame - See TruffleStackTraceElement.getFrame()

Since:

20.1.0

getLocation

public Node getLocation()

Returns a node representing the callsite on the stack.

Returns null if no detailed callsite information is available. This is the case when CallTarget.call(Object...) is used or for the top-of-the-stack element if TruffleException.getLocation() returned null or the exception wasn't a TruffleException.

See FrameInstance.getCallNode() for the relation between callsite and CallTarget.

Since:

0.27

getTarget

public RootCallTarget getTarget()

Returns the call target on the stack. Never returns null.

See FrameInstance.getCallNode() for the relation between callsite and CallTarget.

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