File: README

package info (click to toggle)
icmake 13.05.01-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 7,132 kB
  • sloc: cpp: 11,595; fortran: 883; makefile: 853; sh: 546; pascal: 342
file content (115 lines) | stat: -rw-r--r-- 2,878 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
Polymorphic semantic types are

    EXPRPTR:    Expr *;
    SIZE_T:     size_t; 
    STMNTPTR:   Statement *;
    STRING:     std::string;


UPtrExpr is std::unique_ptr<Expr>


The grammar expects >= variable or function definitions (defVarOrFun)

syntaxX rules are all defined in the inc/syntax file. They preset the Error
message to the next error if it is encountered following successfully parsing
a rule. E.g., 
            syntaxExpression:
            {
                Error::set(Error::EXPRESSION);
            }


d_lastType holds the last received type specification. 


defVarOrFun:    

    either a variable definition (varsDef) or a function definition
    (functionDef).

    this rule merely defines, and returns nothing

varsDef:

    varType varsDefList ';'

    returns an Expr * (EXPRPTR)

functionDef:

    this rule merely defines, and returns nothing


varType:

    assigns d_lastType.

    returns the corresponding INT, STRINGTYPE or LIST token.

varsDefList:

    initializes an Args object with the number and if provided intialization
    values of a list of variables. If an initialization (var = expr) was
    provided for a global variable then the initialization is stored in the
    Symtab's global intialization vector s_initialization.

functionDef:
    
functionDef:

    fdHead_  openCurly  statements  closeCurly
    {
        completeFunction($3);
    }

    defines a function. 
        * the symbol table starts the next level of var. defs.
        * comma separated 'type params' are stored
        * the function is defined by Function::functionHead
        * all statements (including local var. defs.) are collected
        * the function is completed by adding the statements' code.
            (completeFunction: Function.complete(), Symtab resets to only
             global variables)

statements:

statements:
    statements  statement
    {
        $$ = pushStatement($1, $2);
    }
|
    {
        $$ = new CompoundStatement{};
    }
;

    statements are statement sequences embedded in a compound statement 

    CompoundStatement:
        a compound statement contains a vector of statements, and a bool
        d_aceept which is set to false once a statement is a
        return/break/continue, whereafter additional stmnts are no longer
        added to the compound stmnt

    The CompundStatement is derived from Statement, and is not the same as the
    syntax rule 'statementCompound'

returnStatement:
    
    retLeave_  syntaxExpression  retExpr_
    {
        $$ = semicolAfter(new ReturnStatement{ $1, $3 });
    }

    retLeave_ returns an expression or a NullExpr for e_void: a plain
    return; returns e_void, other expressions return the type of the
    expression (int, string, list)

    'semicolAfter' returns the statement received as argument and sets Error
    to SEMICOL: a ; must follow next.