The parser builds an ScriptStack.Runtime.Executable out of the Token stream returned from the ScriptStack.Compiler.Lexer while checking for correct syntax. More...

Public Member Functions
string	ToLiteral (string input)
	Parser (Script script, List< Token > tokenStream)
Executable	Parse ()
	Parse the token stream into an executable.

Detailed Description

The parser builds an ScriptStack.Runtime.Executable out of the Token stream returned from the ScriptStack.Compiler.Lexer while checking for correct syntax.

The parser takes the output from the Lexer in the form of a Token stream and matches it against syntax rules to detect any errors. The output is an abstract syntax tree in form of Instruction's which can be executed by the ScriptStack.Runtime.Interpreter. More details are coming soon.

Not all methods are well documented yet but please be patient - i am working on it.

See https://en.wikipedia.org/wiki/Parsing

Definition at line 21 of file Parser.cs.

Constructor & Destructor Documentation

◆ Parser()

ScriptStack.Compiler.Parser.Parser	(	Script	script,
		List< Token >	tokenStream )

Definition at line 3073 of file Parser.cs.

        {
            this.script = script;
            debugMode = false;
            nextToken = 0;
            variables = new Dictionary<String, bool>();
            localVariables = new Dictionary<String, bool>();
            functionFrameIndex = 0;
            forwardDeclarations = new Dictionary<Instruction, FunctionDescriptor>();
            loopControl = new Stack<LoopControl>();
            this.tokenStream = new List<Token>(tokenStream);
            derivation = new Derivation();
            executable = null;
        }

Member Function Documentation

◆ Parse()

Executable ScriptStack.Compiler.Parser.Parse ( )

Parse the token stream into an executable.

Returns

Definition at line 3092 of file Parser.cs.

        {
            nextToken = 0;
            variables.Clear();
            localVariables.Clear();
            functionFrameIndex = -1;
            forwardDeclarations.Clear();
            loopControl.Clear();
 
            executable = new Executable(script);
 
            ParseScript();
            ResolveForwardFunctionDeclarations();
            executable.Clean();
 
            return executable;
        }

Referenced by ScriptStack.Runtime.Script.Script(), and ScriptStack.Runtime.Script.Script().

◆ ToLiteral()

string ScriptStack.Compiler.Parser.ToLiteral ( string input )

Definition at line 1217 of file Parser.cs.

        {
            var literal = new StringBuilder(input.Length + 2);
            literal.Append("\"");
            foreach (var c in input)
            {
                switch (c)
                {
                    case '\'': literal.Append(@"\'"); break;
                    case '\"': literal.Append("\\\""); break;
                    case '\\': literal.Append(@"\\"); break;
                    case '\0': literal.Append(@"\0"); break;
                    case '\a': literal.Append(@"\a"); break;
                    case '\b': literal.Append(@"\b"); break;
                    case '\f': literal.Append(@"\f"); break;
                    case '\n': literal.Append(@"\n"); break;
                    case '\r': literal.Append(@"\r"); break;
                    case '\t': literal.Append(@"\t"); break;
                    case '\v': literal.Append(@"\v"); break;
                    default:
                        if (char.GetUnicodeCategory(c) != System.Globalization.UnicodeCategory.Control)
                        {
                            literal.Append(c);
                        }
                        else
                        {
                            literal.Append(@"\u");
                            literal.Append(((ushort)c).ToString("x4"));
                        }
                        break;
                }
            }
            literal.Append("\"");
            return literal.ToString();
        }

The documentation for this class was generated from the following file:

Compiler/Parser.cs