Loyc.Syntax.LNodeFactory Class Reference

Contains helper methods for creating LNodes. An LNodeFactory holds a reference to the current source file (File) so that it does not need to be repeated every time you create a node. More...

---

Source file:

• /Core/Loyc.Syntax/LNodes/LNodeFactory.cs

Remarks

Contains helper methods for creating LNodes. An LNodeFactory holds a reference to the current source file (File) so that it does not need to be repeated every time you create a node.

Public static fields
static readonly LNode	Missing_ = new StdIdNode(S.Missing, new SourceRange(EmptySourceFile.Unknown))

Properties
LNode	Missing [get]
ISourceFile	File [get, set]
IMessageSink< LNode >	ErrorSink [get, set]
	Where errors should be sent if there is an error parsing a literal. More...
LNode	true [get]
LNode	false [get]
LNode	null [get]
LNode	void [get]
LNode	int_0 [get]
LNode	int_1 [get]
LNode	string_empty [get]

Public Member Functions
	LNodeFactory (ISourceFile file, IMessageSink?sink=null)
LNode this[0, Missing_].	IsIdNamed (S.TriviaNewline)) return node
LNode	Id (string name, int startIndex=-1, int endIndex=-1)
LNode	Id (Symbol name, int startIndex=-1, int endIndex=-1)
LNode	Id (Symbol name, Token t)
LNode	Id (Token t)
LiteralNode	Literal< V > (V value, int startIndex=-1, int endIndex=-1)
LiteralNode	Literal (object value, string typeMarker, int startIndex=-1, int endIndex=-1)
LiteralNode	Literal (object value, Symbol typeMarker, int startIndex=-1, int endIndex=-1)
LiteralNode	Literal (Token t)
	Creates a literal from a Token. If the token is uninterpreted (Token.IsUninterpretedLiteral), this method uses StandardLiteralHandlers.Value to parse the literal's value; otherwise LiteralFromValueOf(Token) is called to create the literal based on the Token.Value. More...
LiteralNode	Literal (Token t, ILiteralParser parser)
	Creates a literal from a Token. If it's an "ordinary" token, this function simply calls LiteralFromValueOf(Token). If it is an "uninterpreted literal" (type marker with text), this function uses the parser provided to interpret the literal, or, if parser is null, calls UninterpretedLiteral(Token) to create the node without parsing it. More...
LiteralNode	LiteralFromValueOf (Token t)
	Creates a literal whose LNode.Value is the same as the value of t. More...
LiteralNode	UninterpretedLiteral (Token t)
	This method produces a literal by assuming that the provided token is an uninterpreted literal (see Token.IsUninterpretedLiteral) in the current file and that it does not need to be parsed. Therefore, t.Value becomes the LNode.TypeMarker, t.TextValue(_file.Text) becomes the LNode.TextValue, and the LNode.Value will be a boxed copy of TextValue. More...
LNode	Trivia (string suffix, object value)
	Creates a trivia node named "%" + suffix with the specified Value attached. More...
LNode	Trivia (Symbol name, object value, int startIndex=-1, int endIndex=-1)
	Creates a trivia node with the specified Value attached. More...
LNode	Call (LNode target, IEnumerable< LNode > args, int startIndex=-1, int endIndex=-1)
LNode	Call (LNode target, LNodeList args, int startIndex=-1, int endIndex=-1, NodeStyle style=NodeStyle.Default)
LNode	Call (LNode target, int startIndex=-1, int endIndex=-1)
LNode	Call (LNode target, LNode _1, int startIndex=-1, int endIndex=-1, NodeStyle style=NodeStyle.Default)
LNode	Call (LNode target, LNode _1, LNode _2, int startIndex=-1, int endIndex=-1)
LNode	Call (LNode target, LNode _1, LNode _2, LNode _3, int startIndex=-1, int endIndex=-1)
LNode	Call (LNode target, LNode _1, LNode _2, LNode _3, LNode _4, int startIndex=-1, int endIndex=-1)
LNode	Call (LNode target, params LNode[] list)
LNode	Call (LNode target, LNode[] list, int startIndex=-1, int endIndex=-1)
LNode	Call (Symbol target, IEnumerable< LNode > args, int startIndex=-1, int endIndex=-1)
LNode	Call (Symbol target, LNodeList args, int startIndex=-1, int endIndex=-1)
LNode	Call (Symbol target, LNodeList args, int startIndex, int endIndex, int targetStart, int targetEnd, NodeStyle style=NodeStyle.Default)
LNode	Call (Symbol target, int startIndex=-1, int endIndex=-1)
LNode	Call (Symbol target, LNode _1, int startIndex=-1, int endIndex=-1)
LNode	Call (Symbol target, LNode _1, LNode _2, int startIndex=-1, int endIndex=-1, NodeStyle style=NodeStyle.Default)
LNode	Call (Symbol target, LNode _1, LNode _2, LNode _3, int startIndex=-1, int endIndex=-1)
LNode	Call (Symbol target, LNode _1, LNode _2, LNode _3, LNode _4, int startIndex=-1, int endIndex=-1)
LNode	Call (Symbol target, int startIndex, int endIndex, int targetStart, int targetEnd, NodeStyle style=NodeStyle.Default)
LNode	Call (Symbol target, LNode _1, int startIndex, int endIndex, int targetStart, int targetEnd, NodeStyle style=NodeStyle.Default)
LNode	Call (Symbol target, LNode _1, LNode _2, int startIndex, int endIndex, int targetStart, int targetEnd, NodeStyle style=NodeStyle.Default)
LNode	Call (Symbol target, params LNode[] args)
LNode	Call (Symbol target, LNode[] args, int startIndex=-1, int endIndex=-1)
LNode	Call (string target, IEnumerable< LNode > args, int startIndex=-1, int endIndex=-1)
LNode	Call (string target, LNodeList args, int startIndex=-1, int endIndex=-1)
LNode	Call (string target, int startIndex=-1, int endIndex=-1)
LNode	Call (string target, LNode _1, int startIndex=-1, int endIndex=-1)
LNode	Call (string target, LNode _1, LNode _2, int startIndex=-1, int endIndex=-1)
LNode	Call (string target, LNode _1, LNode _2, LNode _3, int startIndex=-1, int endIndex=-1)
LNode	Call (string target, LNode _1, LNode _2, LNode _3, LNode _4, int startIndex=-1, int endIndex=-1)
LNode	Call (string target, params LNode[] args)
LNode	Call (string target, LNode[] args, int startIndex=-1, int endIndex=-1)
LNode	Call (Token target, IEnumerable< LNode > args, int startIndex=-1, int endIndex=-1, NodeStyle style=NodeStyle.Default)
LNode	Call (Token target, LNodeList args, int startIndex=-1, int endIndex=-1, NodeStyle style=NodeStyle.Default)
LNode	Call (Token target, int startIndex=-1, int endIndex=-1, NodeStyle style=NodeStyle.Default)
LNode	Call (Token target, LNode _1, int startIndex=-1, int endIndex=-1, NodeStyle style=NodeStyle.Default)
LNode	Call (Token target, LNode _1, LNode _2, int startIndex=-1, int endIndex=-1, NodeStyle style=NodeStyle.Default)
LNode	CallPrefixOp (Token target, LNode rhs, Symbol?opName=null, NodeStyle style=NodeStyle.Operator)
LNode	CallPrefixOp (Token target, LNodeList args, Symbol?opName=null, NodeStyle style=NodeStyle.Default)
LNode	CallPrefixOp (Symbol target, IndexRange targetRange, LNode rhs, NodeStyle style=NodeStyle.Operator)
LNode	CallPrefixOp (Symbol target, IndexRange targetRange, LNodeList args, NodeStyle style=NodeStyle.Default)
LNode	CallPrefixOp (LNode target, LNode rhs, NodeStyle style=NodeStyle.Operator)
LNode	CallPrefixOp (LNode target, LNodeList args, NodeStyle style=NodeStyle.Default)
LNode	CallPrefix (Token target, LNode rhs, IndexRange closingBracket, Symbol?opName=null, NodeStyle style=NodeStyle.Default)
LNode	CallPrefix (Token target, LNodeList args, IndexRange closingBracket, Symbol?opName=null, NodeStyle style=NodeStyle.Default)
LNode	CallPrefix (LNode target, LNodeList args, IndexRange closingBracket, NodeStyle style=NodeStyle.Default)
LNode	CallPrefix (Symbol target, IndexRange targetRange, LNodeList args, IndexRange closingBracket, NodeStyle style=NodeStyle.Operator)
LNode	CallInfixOp (LNode lhs, Token target, LNode rhs, Symbol?opName=null, NodeStyle style=NodeStyle.Operator)
LNode	CallInfixOp (LNode lhs, Symbol target, IndexRange targetRange, LNode rhs, NodeStyle style=NodeStyle.Operator)
LNode	CallSuffixOp (LNode lhs, Token target, Symbol?opName=null, NodeStyle style=NodeStyle.Operator)
LNode	CallSuffixOp (LNode lhs, Symbol target, IndexRange targetRange, NodeStyle style=NodeStyle.Operator)
LNode	CallInfixOp (LNode lhs, Token target, LNode middle, LNode rhs, Symbol?opName=null, NodeStyle style=NodeStyle.Operator)
LNode	CallInfixOp (LNode lhs, Symbol target, IndexRange targetRange, LNode middle, LNode rhs, NodeStyle style=NodeStyle.Operator)
LNode	CallBrackets (Symbol opName, Token lhs, LNodeList args, Token rhs, NodeStyle style=NodeStyle.Default)
LNode	Dot (Symbol prefix, Symbol symbol)
LNode	Dot (params string[] symbols)
LNode	Dot (params Symbol[] symbols)
LNode	Dot (params LNode[] parts)
LNode	Dot (LNode prefix, Symbol symbol, int startIndex=-1, int endIndex=-1)
LNode	Dot (LNode prefix, LNode symbol, int startIndex=-1, int endIndex=-1)
LNode	Dot (LNode prefix, LNode symbol, int startIndex, int endIndex, int dotStart, int dotEnd, NodeStyle style=NodeStyle.Default)
LNode	Dot (LNode lhs, IndexRange dotRange, LNode rhs, NodeStyle style=NodeStyle.Operator)
LNode	Of (params Symbol[] list)
LNode	Of (params LNode[] list)
LNode	Of (LNode stem, LNode T1, int startIndex=-1, int endIndex=-1)
LNode	Of (Symbol stem, LNode T1, int startIndex=-1, int endIndex=-1)
LNode	Of (LNode stem, IEnumerable< LNode > typeParams, int startIndex=-1, int endIndex=-1)
LNode	Of (Symbol stem, IEnumerable< LNode > typeParams, int startIndex=-1, int endIndex=-1)
LNode	NamedArg (string name, LNode arg, int startIndex=-1, int endIndex=-1)
LNode	NamedArg (Symbol name, LNode arg, int startIndex=-1, int endIndex=-1)
LNode	NamedArg (LNode name, LNode arg)
LNode	Braces (params LNode[] contents)
LNode	Braces (LNodeList contents, int startIndex=-1, int endIndex=-1)
LNode	Braces (LNode[] contents, int startIndex=-1, int endIndex=-1)
LNode	Braces (IEnumerable< LNode > contents, int startIndex=-1, int endIndex=-1)
LNode	Braces (Token openBrace, LNodeList contents, Token closeBrace, NodeStyle style=NodeStyle.StatementBlock)
LNode	List ()
LNode	List (params LNode[] contents)
LNode	List (LNodeList contents, int startIndex=-1, int endIndex=-1)
LNode	List (IEnumerable< LNode > contents, int startIndex=-1, int endIndex=-1)
LNode	AltList ()
LNode	AltList (params LNode[] contents)
LNode	AltList (LNodeList contents, int startIndex=-1, int endIndex=-1)
LNode	AltList (IEnumerable< LNode > contents, int startIndex=-1, int endIndex=-1)
LNode	Splice ()
LNode	Splice (params LNode[] contents)
LNode	Splice (LNode[] contents, int startIndex=-1, int endIndex=-1)
LNode	Splice (LNodeList contents, int startIndex=-1, int endIndex=-1)
LNode	Splice (IEnumerable< LNode > contents, int startIndex=-1, int endIndex=-1)
LNode	Tuple ()
LNode	Tuple (params LNode[] contents)
LNode	Tuple (LNode[] contents, int startIndex=-1, int endIndex=-1)
LNode	Tuple (LNodeList contents, int startIndex=-1, int endIndex=-1)
LNode	Tuple (IEnumerable< LNode > contents, int startIndex=-1, int endIndex=-1)
LNode	Fn (LNode retType, Symbol name, LNode argList, LNode?body=null, int startIndex=-1, int endIndex=-1)
LNode	Fn (LNode retType, LNode name, LNode argList, LNode?body=null, int startIndex=-1, int endIndex=-1)
LNode	Property (LNode type, LNode name, LNode?body=null, int startIndex=-1, int endIndex=-1)
LNode	Property (LNode type, LNode name, LNode?argList, LNode?body, LNode?initializer=null, int startIndex=-1, int endIndex=-1)
LNode	Var (LNode type, string name, LNode?initValue=null, int startIndex=-1, int endIndex=-1)
LNode	Var (LNode type, Symbol name, LNode?initValue=null, int startIndex=-1, int endIndex=-1)
LNode	Var (LNode type, LNode name, LNode?initValue=null, int startIndex=-1, int endIndex=-1)
LNode	Var (LNode type, LNode name)
LNode	Vars (LNode type, params Symbol[] names)
LNode	Vars (LNode type, params LNode[] namesWithValues)
LNode	InParens (LNode inner)
LNode	InParens (LNode inner, int startIndex, int endIndex)
LNode	InParens (IndexRange leftParen, LNode inner, IndexRange rightParen)
LNode	Result (LNode expr)
LNode	Attr (LNode attr, LNode node)
LNode	Attr (params LNode[] attrsAndNode)
LNode	Assign (Symbol lhs, LNode rhs, int startIndex=-1, int endIndex=-1)
LNode	Assign (LNode lhs, LNode rhs, int startIndex=-1, int endIndex=-1)

Member Function Documentation

LiteralNode Loyc.Syntax.LNodeFactory.Literal

(

Token

t

)

Creates a literal from a Token. If the token is uninterpreted (Token.IsUninterpretedLiteral), this method uses StandardLiteralHandlers.Value to parse the literal's value; otherwise LiteralFromValueOf(Token) is called to create the literal based on the Token.Value.

Parameters

t	Token to be converted

LiteralNode Loyc.Syntax.LNodeFactory.Literal ( Token  t, ILiteralParser  parser  )

inline

Creates a literal from a Token. If it's an "ordinary" token, this function simply calls LiteralFromValueOf(Token). If it is an "uninterpreted literal" (type marker with text), this function uses the parser provided to interpret the literal, or, if parser is null, calls UninterpretedLiteral(Token) to create the node without parsing it.

Parameters

t	Token to be converted
parser	Used to obtain a value from an uninterpreted literal, which becomes the LNode.Value property.

References Loyc.Syntax.Lexing.Token.IsUninterpretedLiteral.

LiteralNode Loyc.Syntax.LNodeFactory.LiteralFromValueOf ( Token  t )

inline

Creates a literal whose LNode.Value is the same as the value of t.

References Loyc.Syntax.Lexing.Token.Length, and Loyc.Syntax.Lexing.Token.StartIndex.

LNode Loyc.Syntax.LNodeFactory.Trivia ( string  suffix, object  value  )

inline

Creates a trivia node named "%" + suffix with the specified Value attached.

This method only adds the prefix % if it is not already present in the 'suffix' argument.

LNode Loyc.Syntax.LNodeFactory.Trivia ( Symbol  name, object  value, int  startIndex = -1, int  endIndex = -1  )

inline

Creates a trivia node with the specified Value attached.

See also

LNode.Trivia(Symbol, object, LNode)

LiteralNode Loyc.Syntax.LNodeFactory.UninterpretedLiteral ( Token  t )

inline

This method produces a literal by assuming that the provided token is an uninterpreted literal (see Token.IsUninterpretedLiteral) in the current file and that it does not need to be parsed. Therefore, t.Value becomes the LNode.TypeMarker, t.TextValue(_file.Text) becomes the LNode.TextValue, and the LNode.Value will be a boxed copy of TextValue.

References Loyc.Syntax.Lexing.Token.TextValue().

Property Documentation

IMessageSink<LNode> Loyc.Syntax.LNodeFactory.ErrorSink

getset

Where errors should be sent if there is an error parsing a literal.

Attempting to set this to null makes the getter return MessageSink.Default.