com.oracle.truffle.api.nodes

Class ExecutableNode

java.lang.Object

com.oracle.truffle.api.nodes.Node

com.oracle.truffle.api.nodes.ExecutableNode

All Implemented Interfaces:

NodeInterface, Cloneable

Direct Known Subclasses:

RootNode

public abstract class ExecutableNode
extends Node

Represents an executable node in a Truffle AST. The executable node represents an AST fragment that can be executed using a frame instance created by the framework.

Since:

0.31

See Also:

TruffleLanguage.parse(com.oracle.truffle.api.TruffleLanguage.InlineParsingRequest)

Nested Class Summary

Nested classes/interfaces inherited from class com.oracle.truffle.api.nodes.Node

Node.Child, Node.Children

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ExecutableNode(TruffleLanguage<?> language) Creates new executable node with a given language instance.

Method Summary

Modifier and Type	Method and Description
abstract Object	execute(VirtualFrame frame) Execute this fragment at the place where it was parsed.
<C extends TruffleLanguage> C	getLanguage(Class<C> languageClass) Returns the language instance associated with this executable node.
LanguageInfo	getLanguageInfo() Returns public information about the language.

Methods inherited from class com.oracle.truffle.api.nodes.Node

accept, adoptChildren, atomic, atomic, copy, deepCopy, getChildren, getCost, getDebugProperties, getDescription, getEncapsulatingSourceSection, getLock, getParent, getRootNode, getSourceSection, insert, insert, isAdoptable, isSafelyReplaceableBy, notifyInserted, onReplace, replace, replace, reportPolymorphicSpecialize, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

ExecutableNode

protected ExecutableNode(TruffleLanguage<?> language)

Creates new executable node with a given language instance. The language instance is obtainable while TruffleLanguage.parse(InlineParsingRequest) is executed.

Parameters:

language - the language this executable node is associated with

Since:

0.31

Method Detail

execute

public abstract Object execute(VirtualFrame frame)

Execute this fragment at the place where it was parsed.

Parameters:

frame - the actual frame valid at the parsed location

Returns:

the result of the execution, must be an interop type (i.e. either implementing TruffleObject or be a primitive value), or null.

Since:

0.31

getLanguageInfo

public final LanguageInfo getLanguageInfo()

Returns public information about the language. The language can be assumed equal if the instances of the language info instance are the same. To access internal details of the language within the language implementation use a TruffleLanguage.LanguageReference.

Since:

0.31

getLanguage

public final <C extends TruffleLanguage> C getLanguage(Class<C> languageClass)

Returns the language instance associated with this executable node. The language instance is intended for internal use in languages and is only accessible if the concrete type of the language is known. Public information about the language can be accessed using ExecutableNode.getLanguageInfo(). The language is null if the executable node is not associated with a language. This method is guaranteed to return a PE constant if the root node is also a PE constant.

Since:

0.31

See Also:

ExecutableNode.getLanguageInfo()