com.oracle.truffle.sl.parser

Class SLNodeFactory

java.lang.Object

com.oracle.truffle.sl.parser.SLNodeFactory

public class SLNodeFactory
extends Object

Helper class used by the SL Parser to create nodes. The code is factored out of the automatically generated parser to keep the attributed grammar of SL small.

Constructor Summary

Constructors

Constructor and Description
SLNodeFactory(SLLanguage language, com.oracle.truffle.api.source.Source source)

Method Summary

Modifier and Type	Method and Description
void	addFormalParameter(org.antlr.v4.runtime.Token nameToken)
SLExpressionNode	createAssignment(SLExpressionNode nameNode, SLExpressionNode valueNode) Returns an SLWriteLocalVariableNode for the given parameters.
SLExpressionNode	createAssignment(SLExpressionNode nameNode, SLExpressionNode valueNode, Integer argumentIndex) Returns an SLWriteLocalVariableNode for the given parameters.
SLExpressionNode	createBinary(org.antlr.v4.runtime.Token opToken, SLExpressionNode leftNode, SLExpressionNode rightNode) Returns the corresponding subclass of SLExpressionNode for binary expressions.
SLStatementNode	createBreak(org.antlr.v4.runtime.Token breakToken) Returns an SLBreakNode for the given token.
SLExpressionNode	createCall(SLExpressionNode functionNode, List<SLExpressionNode> parameterNodes, org.antlr.v4.runtime.Token finalToken) Returns an SLInvokeNode for the given parameters.
SLStatementNode	createContinue(org.antlr.v4.runtime.Token continueToken) Returns an SLContinueNode for the given token.
SLStatementNode	createIf(org.antlr.v4.runtime.Token ifToken, SLExpressionNode conditionNode, SLStatementNode thenPartNode, SLStatementNode elsePartNode) Returns an SLIfNode for the given parameters.
SLExpressionNode	createNumericLiteral(org.antlr.v4.runtime.Token literalToken)
SLExpressionNode	createParenExpression(SLExpressionNode expressionNode, int start, int length)
SLExpressionNode	createRead(SLExpressionNode nameNode) Returns a SLReadLocalVariableNode if this read is a local variable or a SLFunctionLiteralNode if this read is global.
SLExpressionNode	createReadProperty(SLExpressionNode receiverNode, SLExpressionNode nameNode) Returns an SLReadPropertyNode for the given parameters.
SLStatementNode	createReturn(org.antlr.v4.runtime.Token t, SLExpressionNode valueNode) Returns an SLReturnNode for the given parameters.
SLExpressionNode	createStringLiteral(org.antlr.v4.runtime.Token literalToken, boolean removeQuotes)
SLStatementNode	createWhile(org.antlr.v4.runtime.Token whileToken, SLExpressionNode conditionNode, SLStatementNode bodyNode) Returns an SLWhileNode for the given parameters.
SLExpressionNode	createWriteProperty(SLExpressionNode receiverNode, SLExpressionNode nameNode, SLExpressionNode valueNode) Returns an SLWritePropertyNode for the given parameters.
SLStatementNode	finishBlock(List<SLStatementNode> bodyNodes, int startPos, int length)
SLStatementNode	finishBlock(List<SLStatementNode> bodyNodes, int skipCount, int startPos, int length)
void	finishFunction(SLStatementNode bodyNode)
Map<com.oracle.truffle.api.strings.TruffleString,com.oracle.truffle.api.RootCallTarget>	getAllFunctions()
void	startBlock()
void	startFunction(org.antlr.v4.runtime.Token nameToken, org.antlr.v4.runtime.Token bodyStartToken)

Methods inherited from class java.lang.Object

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

Constructor Detail

SLNodeFactory

public SLNodeFactory(SLLanguage language,
                     com.oracle.truffle.api.source.Source source)

Method Detail

getAllFunctions

public Map<com.oracle.truffle.api.strings.TruffleString,com.oracle.truffle.api.RootCallTarget> getAllFunctions()

startFunction

public void startFunction(org.antlr.v4.runtime.Token nameToken,
                          org.antlr.v4.runtime.Token bodyStartToken)

addFormalParameter

public void addFormalParameter(org.antlr.v4.runtime.Token nameToken)

finishFunction

public void finishFunction(SLStatementNode bodyNode)

startBlock

public void startBlock()

finishBlock

public SLStatementNode finishBlock(List<SLStatementNode> bodyNodes,
                                   int startPos,
                                   int length)

finishBlock

public SLStatementNode finishBlock(List<SLStatementNode> bodyNodes,
                                   int skipCount,
                                   int startPos,
                                   int length)

createBreak

public SLStatementNode createBreak(org.antlr.v4.runtime.Token breakToken)

Returns an SLBreakNode for the given token.

Parameters:

breakToken - The token containing the break node's info.

Returns:

A SLBreakNode for the given token.

createContinue

public SLStatementNode createContinue(org.antlr.v4.runtime.Token continueToken)

Returns an SLContinueNode for the given token.

Parameters:

continueToken - The token containing the continue node's info.

Returns:

A SLContinueNode built using the given token.

createWhile

public SLStatementNode createWhile(org.antlr.v4.runtime.Token whileToken,
                                   SLExpressionNode conditionNode,
                                   SLStatementNode bodyNode)

Returns an SLWhileNode for the given parameters.

Parameters:

whileToken - The token containing the while node's info

conditionNode - The conditional node for this while loop

bodyNode - The body of the while loop

Returns:

A SLWhileNode built using the given parameters. null if either conditionNode or bodyNode is null.

createIf

public SLStatementNode createIf(org.antlr.v4.runtime.Token ifToken,
                                SLExpressionNode conditionNode,
                                SLStatementNode thenPartNode,
                                SLStatementNode elsePartNode)

Returns an SLIfNode for the given parameters.

Parameters:

ifToken - The token containing the if node's info

conditionNode - The condition node of this if statement

thenPartNode - The then part of the if

elsePartNode - The else part of the if (null if no else part)

Returns:

An SLIfNode for the given parameters. null if either conditionNode or thenPartNode is null.

createReturn

public SLStatementNode createReturn(org.antlr.v4.runtime.Token t,
                                    SLExpressionNode valueNode)

Returns an SLReturnNode for the given parameters.

Parameters:

t - The token containing the return node's info

valueNode - The value of the return (null if not returning a value)

Returns:

An SLReturnNode for the given parameters.

createBinary

public SLExpressionNode createBinary(org.antlr.v4.runtime.Token opToken,
                                     SLExpressionNode leftNode,
                                     SLExpressionNode rightNode)

Returns the corresponding subclass of SLExpressionNode for binary expressions.
These nodes are currently not instrumented.

Parameters:

opToken - The operator of the binary expression

leftNode - The left node of the expression

rightNode - The right node of the expression

Returns:

A subclass of SLExpressionNode using the given parameters based on the given opToken. null if either leftNode or rightNode is null.

createCall

public SLExpressionNode createCall(SLExpressionNode functionNode,
                                   List<SLExpressionNode> parameterNodes,
                                   org.antlr.v4.runtime.Token finalToken)

Returns an SLInvokeNode for the given parameters.

Parameters:

functionNode - The function being called

parameterNodes - The parameters of the function call

finalToken - A token used to determine the end of the sourceSelection for this call

Returns:

An SLInvokeNode for the given parameters. null if functionNode or any of the parameterNodes are null.

createAssignment

public SLExpressionNode createAssignment(SLExpressionNode nameNode,
                                         SLExpressionNode valueNode)

Returns an SLWriteLocalVariableNode for the given parameters.

Parameters:

nameNode - The name of the variable being assigned

valueNode - The value to be assigned

Returns:

An SLExpressionNode for the given parameters. null if nameNode or valueNode is null.

createAssignment

public SLExpressionNode createAssignment(SLExpressionNode nameNode,
                                         SLExpressionNode valueNode,
                                         Integer argumentIndex)

Returns an SLWriteLocalVariableNode for the given parameters.

Parameters:

nameNode - The name of the variable being assigned

valueNode - The value to be assigned

argumentIndex - null or index of the argument the assignment is assigning

Returns:

An SLExpressionNode for the given parameters. null if nameNode or valueNode is null.

createRead

public SLExpressionNode createRead(SLExpressionNode nameNode)

Returns a SLReadLocalVariableNode if this read is a local variable or a SLFunctionLiteralNode if this read is global. In SL, the only global names are functions.

Parameters:

nameNode - The name of the variable/function being read

Returns:

either:

• A SLReadLocalVariableNode representing the local variable being read.
• A SLFunctionLiteralNode representing the function definition.
• null if nameNode is null.

createStringLiteral

public SLExpressionNode createStringLiteral(org.antlr.v4.runtime.Token literalToken,
                                            boolean removeQuotes)

createNumericLiteral

public SLExpressionNode createNumericLiteral(org.antlr.v4.runtime.Token literalToken)

createParenExpression

public SLExpressionNode createParenExpression(SLExpressionNode expressionNode,
                                              int start,
                                              int length)

createReadProperty

public SLExpressionNode createReadProperty(SLExpressionNode receiverNode,
                                           SLExpressionNode nameNode)

Returns an SLReadPropertyNode for the given parameters.

Parameters:

receiverNode - The receiver of the property access

nameNode - The name of the property being accessed

Returns:

An SLExpressionNode for the given parameters. null if receiverNode or nameNode is null.

createWriteProperty

public SLExpressionNode createWriteProperty(SLExpressionNode receiverNode,
                                            SLExpressionNode nameNode,
                                            SLExpressionNode valueNode)

Returns an SLWritePropertyNode for the given parameters.

Parameters:

receiverNode - The receiver object of the property assignment

nameNode - The name of the property being assigned

valueNode - The value to be assigned

Returns:

An SLExpressionNode for the given parameters. null if receiverNode, nameNode or valueNode is null.