cval/README.md

C-val Compiler

Lexical Spec

• LBRACK [
• RBRACK ]
• LCURLY {
• RCURLY }
• LPAREN (
• RPAREN )
• ID [any character without whitespace]+
• SEMI ;
• COMMA ,
• ARROW ->
• STAR *
• ANDREF &
• DOLLAR $
• COMMENT //
• NUM [0-9]*
• VAL
• STRING "{any}"

Syntax Spec

program     := defn*

defn        := VAL type ID ;
             | VAL type ID expr ;

type        := ID | type STAR
             | LBRACK RBRACK | LBRACK type RBRACK
             | LBRACK type* ARROW type? RBRACK

expr        := atom atom*

atom        := ID
             | NUM
             | STR
             | lambda
             | compound
             | STAR
             | ANDREF

stmt        := defn               // defn statement
             | expr ;             // expr statement
             | return expr ;      // return statement
             | DOLLAR ID expr ;   // assignment statement
             | if expr compound ;               // if statement
             | if expr compound else compound ; // if-else statement

param_list  := LPAREN (type ID)* RPAREN

lambda      := param_list compound

compound    := LCURLY (stmt)* expr? RCURLY

AST Node Spec

NODE_PROGRAM:
    token: PROGRAM
    children: NODE_DEFN*
NODE_DEFN:
    token: VAL
    children: NODE_TYPE, ID, NODE_EXPR?
NODE_TYPE:
    token: ID | COMPLEX_TYPE
    children: NODE_TYPE, NODE_TYPE
            | NODE_TYPE
NODE_EXPR:
    token: EXPR
    children: NODE_ATOM*

// ATOM
NODE_NUM:
    token: NUM
    children: none
NODE_ID:
    token: ID
    children: none
NODE_STR:
    token: STR
    children: none
NODE_LAMBDA:
    token: LAMBDA
    children: NODE_PARAM_LIST, NODE_COMPOUND
NODE_PARAM_LIST:
    token: PARAM_LIST
    children: (NODE_PARAM)*
NODE_PARAM:
    token: PARAM
    children: NODE_TYPE, ID
NODE_COMPOUND:
    token: COMPOUND
    children: NODE_STMT*, NODE_EXPR?