1 /*
2  * [The "BSD licence"]
3  * Copyright (c) 2005-2008 Terence Parr
4  * All rights reserved.
5  *
6  * Conversion to C#:
7  * Copyright (c) 2008-2009 Sam Harwell, Pixel Mine, Inc.
8  * All rights reserved.
9  *
10  * Redistribution and use in source and binary forms, with or without
11  * modification, are permitted provided that the following conditions
12  * are met:
13  * 1. Redistributions of source code must retain the above copyright
14  *    notice, this list of conditions and the following disclaimer.
15  * 2. Redistributions in binary form must reproduce the above copyright
16  *    notice, this list of conditions and the following disclaimer in the
17  *    documentation and/or other materials provided with the distribution.
18  * 3. The name of the author may not be used to endorse or promote products
19  *    derived from this software without specific prior written permission.
20  *
21  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
22  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
23  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
24  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
25  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
26  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
27  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
28  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
29  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
30  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
31  */
32 
33 using System.Collections.Generic;
34 using Antlr.Runtime.Tree;
35 
36 using BigInteger = java.math.BigInteger;
37 using Console = System.Console;
38 
39 partial class DebugTreeGrammar
40 {
41     /** Points to functions tracked by tree builder. */
42     private List<CommonTree> functionDefinitions;
43 
44     /** Remember local variables. Currently, this is only the function parameter.
45      */
46     private readonly IDictionary<string, BigInteger> localMemory = new Dictionary<string, BigInteger>();
47 
48     /** Remember global variables set by =. */
49     private IDictionary<string, BigInteger> globalMemory = new Dictionary<string, BigInteger>();
50 
51     /** Set up an evaluator with a node stream; and a set of function definition ASTs. */
DebugTreeGrammar( CommonTreeNodeStream nodes, List<CommonTree> functionDefinitions )52     public DebugTreeGrammar( CommonTreeNodeStream nodes, List<CommonTree> functionDefinitions )
53         : this( nodes )
54     {
55         this.functionDefinitions = functionDefinitions;
56     }
57 
58     /** Set up a local evaluator for a nested function call. The evaluator gets the definition
59      *  tree of the function; the set of all defined functions (to find locally called ones); a
60      *  pointer to the global variable memory; and the value of the function parameter to be
61      *  added to the local memory.
62      */
DebugTreeGrammar( CommonTree function, List<CommonTree> functionDefinitions, IDictionary<string, BigInteger> globalMemory, BigInteger paramValue )63     private DebugTreeGrammar( CommonTree function,
64                  List<CommonTree> functionDefinitions,
65                  IDictionary<string, BigInteger> globalMemory,
66                  BigInteger paramValue )
67         // Expected tree for function: ^(FUNC ID ( INT | ID ) expr)
68         : this( new CommonTreeNodeStream( function.GetChild( 2 ) ), functionDefinitions )
69     {
70         this.globalMemory = globalMemory;
71         localMemory[function.GetChild( 1 ).Text] = paramValue;
72     }
73 
74     /** Find matching function definition for a function name and parameter
75      *  value. The first definition is returned where (a) the name matches
76      *  and (b) the formal parameter agrees if it is defined as constant.
77      */
findFunction( string name, BigInteger paramValue )78     private CommonTree findFunction( string name, BigInteger paramValue )
79     {
80         foreach ( CommonTree f in functionDefinitions )
81         {
82             // Expected tree for f: ^(FUNC ID (ID | INT) expr)
83             if ( f.GetChild( 0 ).Text.Equals( name ) )
84             {
85                 // Check whether parameter matches
86                 CommonTree formalPar = (CommonTree)f.GetChild( 1 );
87                 if ( formalPar.Token.Type == INT
88                     && !new BigInteger( formalPar.Token.Text ).Equals( paramValue ) )
89                 {
90                     // Constant in formalPar list does not match actual value -> no match.
91                     continue;
92                 }
93                 // Parameter (value for INT formal arg) as well as fct name agrees!
94                 return f;
95             }
96         }
97         return null;
98     }
99 
100     /** Get value of name up call stack. */
getValue( string name )101     internal BigInteger getValue( string name )
102     {
103         BigInteger value;
104         if ( localMemory.TryGetValue( name, out value ) && value != null )
105         {
106             return value;
107         }
108         if ( globalMemory.TryGetValue( name, out value ) && value != null )
109         {
110             return value;
111         }
112         // not found in local memory or global memory
113         Console.Error.WriteLine( "undefined variable " + name );
114         return new BigInteger( "0" );
115     }
116 }
117