com.oracle.truffle.api

Class TruffleLanguage.ParsingRequest

java.lang.Object

com.oracle.truffle.api.TruffleLanguage.ParsingRequest

Enclosing class:

TruffleLanguage<C>

public static final class TruffleLanguage.ParsingRequest
extends Object

Request for parsing. Contains information of what to parse and in which context.

Since:

0.22

Method Summary

Modifier and Type	Method and Description
List<String>	getArgumentNames() Argument names.
MaterializedFrame	getFrame() Specifies the execution context for parsing.
Node	getLocation() Specifies the code location for parsing.
Source	getSource() The source code to parse.

Methods inherited from class java.lang.Object

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

Method Detail

getSource

public Source getSource()

The source code to parse.

Returns:

the source code, never null

Since:

0.22

getLocation

public Node getLocation()

Specifies the code location for parsing. The location is specified as an instance of a Node in the AST. There doesn't have to be any specific location and in such case this method returns null. If the node is provided, it can be for example EventContext.getInstrumentedNode() when EventContext.parseInContext(com.oracle.truffle.api.source.Source, java.lang.String...) is called.

Returns:

a Node defining AST context for the parsing or null

Since:

0.22

getFrame

public MaterializedFrame getFrame()

Specifies the execution context for parsing. If the parsing request is used for evaluation during halted execution, for example as in DebugStackFrame.eval(String) method, this method provides access to current frame with local variables, etc.

Returns:

a MaterializedFrame exposing the current execution state or null if there is none

Since:

0.22

getArgumentNames

public List<String> getArgumentNames()

Argument names. The result of parsing is an instance of CallTarget that can be invoked without or with some parameters. If the invocation requires some arguments, and the TruffleLanguage.ParsingRequest.getSource() references them, it is essential to name them. Example that uses the argument names:

public void parseWithParams(TruffleLanguage.Env env) {
    Source multiply = Source.newBuilder("a * b").
        mimeType("text/javascript").
        name("mul.js").
        build();
    CallTarget method = env.parse(multiply, "a", "b");
    Number fortyTwo = (Number) method.call(6, 7);
    assert 42 == fortyTwo.intValue();
    Number ten = (Number) method.call(2, 5);
    assert 10 == ten.intValue();
}

Returns:

symbolic names for parameters of CallTarget.call(java.lang.Object...)

Since:

0.22