src/org/xwt/js/Parser.java

   1 // Copyright 2003 Adam Megacz, see the COPYING file for licensing [GPL]
   2 package org.xwt.js;
   3
   4 import org.xwt.util.*;
   5 import java.io.*;
   6
   7 /**
   8  *  Parses a stream of lexed tokens into a tree of CompiledFunctionImpl's.
   9  *
  10  *  There are three kinds of things we parse: blocks, statements, and
  11  *  expressions.
  12  *
  13  *  - Expressions are a special type of statement that evaluates to a
  14  *    value (for example, "break" is not an expression, * but "3+2"
  15  *    is).  Some tokens sequences start expressions (for * example,
  16  *    literal numbers) and others continue an expression which * has
  17  *    already been begun (for example, '+').  Finally, some *
  18  *    expressions are valid targets for an assignment operation; after
  19  *    * each of these expressions, continueExprAfterAssignable() is
  20  *    called * to check for an assignment operation.
  21  *
  22  *  - A statement ends with a semicolon and does not return a value.
  23  *
  24  *  - A block is a single statement or a sequence of statements
  25  *    surrounded by curly braces.
  26  *
  27  *  Each parsing method saves the parserLine before doing its actual
  28  *  work and restores it afterwards.  This ensures that parsing a
  29  *  subexpression does not modify the line number until a token
  30  *  *after* the subexpression has been consumed by the parent
  31  *  expression.
  32  *
  33  *  Technically it would be a better design for this class to build an
  34  *  intermediate parse tree and use that to emit bytecode.  Here's the
  35  *  tradeoff:
  36  *
  37  *  Advantages of building a parse tree:
  38  *  - easier to apply optimizations
  39  *  - would let us handle more sophisticated languages than JavaScript
  40  *
  41  *  Advantages of leaving out the parse tree
  42  *  - faster compilation
  43  *  - less load on the garbage collector
  44  *  - much simpler code, easier to understand
  45  *  - less error-prone
  46  *
  47  *  Fortunately JS is such a simple language that we can get away with
  48  *  the half-assed approach and still produce a working, complete
  49  *  compiler.
  50  *
  51  *  The bytecode language emitted doesn't really cause any appreciable
  52  *  semantic loss, and is itself a parseable language very similar to
  53  *  Forth or a postfix variant of LISP.  This means that the bytecode
  54  *  can be transformed into a parse tree, which can be manipulated.
  55  *  So if we ever want to add an optimizer, it could easily be done by
  56  *  producing a parse tree from the bytecode, optimizing that tree,
  57  *  and then re-emitting the bytecode.  The parse tree node class
  58  *  would also be much simpler since the bytecode language has so few
  59  *  operators.
  60  *
  61  *  Actually, the above paragraph is slightly inaccurate -- there are
  62  *  places where we push a value and then perform an arbitrary number
  63  *  of operations using it before popping it; this doesn't parse well.
  64  *  But these cases are clearly marked and easy to change if we do
  65  *  need to move to a parse tree format.
  66  */
  67 class Parser extends Lexer implements ByteCodes {
  68
  69
  70     // Constructors //////////////////////////////////////////////////////
  71
  72     public Parser(Reader r, String sourceName, int line) throws IOException { super(r, sourceName, line); }
  73
  74     /** for debugging */
  75     public static void main(String[] s) throws Exception {
  76         CompiledFunctionImpl block = new JS.CompiledFunction("stdin", 0, new InputStreamReader(System.in), null);
  77         if (block == null) return;
  78         System.out.println(block);
  79     }
  80
  81
  82     // Statics ////////////////////////////////////////////////////////////
  83
  84     static byte[] precedence = new byte[MAX_TOKEN + 1];
  85     static boolean[] isRightAssociative = new boolean[MAX_TOKEN + 1];
  86     static {
  87         isRightAssociative[ASSIGN] =
  88             isRightAssociative[ASSIGN_BITOR] =
  89             isRightAssociative[ASSIGN_BITXOR] =
  90             isRightAssociative[ASSIGN_BITAND] =
  91             isRightAssociative[ASSIGN_LSH] =
  92             isRightAssociative[ASSIGN_RSH] =
  93             isRightAssociative[ASSIGN_URSH] =
  94             isRightAssociative[ASSIGN_ADD] =
  95             isRightAssociative[ASSIGN_SUB] =
  96             isRightAssociative[ASSIGN_MUL] =
  97             isRightAssociative[ASSIGN_DIV] =
  98             isRightAssociative[ASSIGN_MOD] = true;
  99
 100         precedence[ASSIGN] =
 101             precedence[ASSIGN_BITOR] =
 102             precedence[ASSIGN_BITXOR] =
 103             precedence[ASSIGN_BITAND] =
 104             precedence[ASSIGN_LSH] =
 105             precedence[ASSIGN_RSH] =
 106             precedence[ASSIGN_URSH] =
 107             precedence[ASSIGN_ADD] =
 108             precedence[ASSIGN_SUB] =
 109             precedence[ASSIGN_MUL] =
 110             precedence[ASSIGN_DIV] =
 111             precedence[ASSIGN_MOD] = 1;
 112         precedence[HOOK] = 2;
 113         precedence[COMMA] = 3;
 114         precedence[OR] = precedence[AND] = 4;
 115         precedence[GT] = precedence[GE] = 5;
 116         precedence[BITOR] = 6;
 117         precedence[BITXOR] = 7;
 118         precedence[BITAND] = 8;
 119         precedence[EQ] = precedence[NE] = 9;
 120         precedence[LT] = precedence[LE] = 10;
 121         precedence[SHEQ] = precedence[SHNE] = 11;
 122         precedence[LSH] = precedence[RSH] = precedence[URSH] = 12;
 123         precedence[ADD] = precedence[SUB] = 13;
 124         precedence[MUL] = precedence[DIV] = precedence[MOD] = 14;
 125         precedence[BITNOT] =  15;
 126         precedence[INC] = precedence[DEC] = 16;
 127         precedence[LP] = 17;
 128         precedence[DOT] = precedence[LB] = 18;
 129     }
 130
 131
 132     // Parsing Logic /////////////////////////////////////////////////////////
 133
 134     /** gets a token and throws an exception if it is not <tt>code</tt> */
 135     private void consume(int code) throws IOException {
 136         if (getToken() != code) throw pe("expected " + codeToString[code] + ", got " + (op == -1 ? "EOF" : codeToString[op]));
 137     }
 138
 139     /**
 140      *  Parse the largest possible expression containing no operators
 141      *  of precedence below <tt>minPrecedence</tt> and append the
 142      *  bytecodes for that expression to <tt>appendTo</tt>; the
 143      *  appended bytecodes MUST grow the stack by exactly one element.
 144      */
 145     private void startExpr(CompiledFunctionImpl appendTo, int minPrecedence) throws IOException {
 146         int saveParserLine = parserLine;
 147         _startExpr(appendTo, minPrecedence);
 148         parserLine = saveParserLine;
 149     }
 150     private void _startExpr(CompiledFunctionImpl appendTo, int minPrecedence) throws IOException {
 151         int tok = getToken();
 152         CompiledFunctionImpl b = appendTo;
 153
 154         switch (tok) {
 155         case -1: throw pe("expected expression");
 156
 157         // all of these simply push values onto the stack
 158         case NUMBER: b.add(parserLine, LITERAL, number); break;
 159         case STRING: b.add(parserLine, LITERAL, string); break;
 160         case THIS: b.add(parserLine, TOPSCOPE, null); break;
 161         case NULL: b.add(parserLine, LITERAL, null); break;
 162         case TRUE: case FALSE: b.add(parserLine, LITERAL, new Boolean(tok == TRUE)); break;
 163
 164         case LB: {
 165             b.add(parserLine, ARRAY, new Integer(0));                       // push an array onto the stack
 166             int size0 = b.size();
 167             int i = 0;
 168             if (peekToken() != RB)
 169                 while(true) {                                               // iterate over the initialization values
 170                     int size = b.size();
 171                     b.add(parserLine, LITERAL, new Integer(i++));           // push the index in the array to place it into
 172                     if (peekToken() == COMMA || peekToken() == RB)
 173                         b.add(parserLine, LITERAL, null);                   // for stuff like [1,,2,]
 174                     else
 175                         startExpr(b, -1);                                   // push the value onto the stack
 176                     b.add(parserLine, PUT);                                 // put it into the array
 177                     b.add(parserLine, POP);                                 // discard the value remaining on the stack
 178                     if (peekToken() == RB) break;
 179                     consume(COMMA);
 180                 }
 181             b.set(size0 - 1, new Integer(i));                               // back at the ARRAY instruction, write the size of the array
 182             consume(RB);
 183             break;
 184         }
 185         case SUB: {  // negative literal (like "3 * -1")
 186             consume(NUMBER);
 187             b.add(parserLine, LITERAL, new Double(number.doubleValue() * -1));
 188             break;
 189         }
 190         case LP: {  // grouping (not calling)
 191             startExpr(b, -1);
 192             consume(RP);
 193             break;
 194         }
 195         case INC: case DEC: {  // prefix (not postfix)
 196             startExpr(b, precedence[tok]);
 197             if (b.get(b.size() - 1) != GET)
 198                 throw pe("prefixed increment/decrement can only be performed on a valid assignment target");
 199             b.set(b.size() - 1, tok, new Boolean(true));
 200             break;
 201         }
 202         case BANG: case BITNOT: case TYPEOF: {
 203             startExpr(b, precedence[tok]);
 204             b.add(parserLine, tok);
 205             break;
 206         }
 207         case LC: { // object constructor
 208             b.add(parserLine, OBJECT, null);                                     // put an object on the stack
 209             if (peekToken() != RC)
 210                 while(true) {
 211                     if (peekToken() != NAME && peekToken() != STRING)
 212                         throw pe("expected NAME or STRING");
 213                     getToken();
 214                     b.add(parserLine, LITERAL, string);                          // grab the key
 215                     consume(COLON);
 216                     startExpr(b, -1);                                            // grab the value
 217                     b.add(parserLine, PUT);                                      // put the value into the object
 218                     b.add(parserLine, POP);                                      // discard the remaining value
 219                     if (peekToken() == RC) break;
 220                     consume(COMMA);
 221                     if (peekToken() == RC) break;                                // we permit {,,} -- I'm not sure if ECMA does
 222                 }
 223             consume(RC);
 224             break;
 225         }
 226         case NAME: {
 227             b.add(parserLine, TOPSCOPE);
 228             b.add(parserLine, LITERAL, string);
 229             continueExprAfterAssignable(b);
 230             break;
 231         }
 232         case FUNCTION: {
 233             consume(LP);
 234             int numArgs = 0;
 235             CompiledFunctionImpl b2 = new JS.CompiledFunction(sourceName, parserLine, null, null);
 236             b.add(parserLine, NEWFUNCTION, b2);
 237
 238             // function prelude; arguments array is already on the stack
 239             b2.add(parserLine, TOPSCOPE);                                                // push the scope onto the stack
 240             b2.add(parserLine, SWAP);                                                    // swap 'this' and 'arguments'
 241
 242             b2.add(parserLine, LITERAL, "arguments");                                    // declare arguments (equivalent to 'var arguments;')
 243             b2.add(parserLine, DECLARE);
 244
 245             b2.add(parserLine, LITERAL, "arguments");                                    // set this.arguments and leave the value on the stack
 246             b2.add(parserLine, SWAP);
 247             b2.add(parserLine, PUT);
 248             b2.add(parserLine, SWAP);
 249             b2.add(parserLine, POP);
 250
 251             while(peekToken() != RP) {                                    // run through the list of argument names
 252                 if (peekToken() == NAME) {
 253                     consume(NAME);                                        // a named argument
 254
 255                     b2.add(parserLine, LITERAL, string);                  // declare the name
 256                     b2.add(parserLine, DECLARE);
 257
 258                     b2.add(parserLine, LITERAL, new Integer(numArgs));    // retrieve it from the arguments array
 259                     b2.add(parserLine, GET_PRESERVE);
 260                     b2.add(parserLine, SWAP);
 261                     b2.add(parserLine, POP);
 262
 263                     b2.add(parserLine, TOPSCOPE);                         // put it to the current scope
 264                     b2.add(parserLine, SWAP);
 265                     b2.add(parserLine, LITERAL, string);
 266                     b2.add(parserLine, SWAP);
 267                     b2.add(parserLine, PUT);
 268
 269                     b2.add(parserLine, POP);                              // clean the stack
 270                     b2.add(parserLine, POP);
 271                 }
 272                 if (peekToken() == RP) break;
 273                 consume(COMMA);
 274                 numArgs++;
 275             }
 276             consume(RP);
 277
 278             b2.add(parserLine, POP);                                      // pop off the arguments array
 279
 280             parseStatement(b2, null);                                     // the function body
 281
 282             b2.add(parserLine, LITERAL, null);                            // in case we "fall out the bottom", return NULL
 283             b2.add(parserLine, RETURN);
 284
 285             break;
 286         }
 287         default: throw pe("expected expression, found " + codeToString[tok] + ", which cannot start an expression");
 288         }
 289
 290         // attempt to continue the expression
 291         continueExpr(b, minPrecedence);
 292     }
 293
 294
 295     /**
 296      *  Assuming that a complete assignable (lvalue) has just been
 297      *  parsed and the object and key are on the stack,
 298      *  <tt>continueExprAfterAssignable</tt> will attempt to parse an
 299      *  expression that modifies the assignable.  This method always
 300      *  decreases the stack depth by exactly one element.
 301      */
 302     private void continueExprAfterAssignable(CompiledFunctionImpl b) throws IOException {
 303         int saveParserLine = parserLine;
 304         _continueExprAfterAssignable(b);
 305         parserLine = saveParserLine;
 306     }
 307     private void _continueExprAfterAssignable(CompiledFunctionImpl b) throws IOException {
 308         if (b == null) throw new Error("got null b; this should never happen");
 309         int tok = getToken();
 310         switch(tok) {
 311         case ASSIGN_BITOR: case ASSIGN_BITXOR: case ASSIGN_BITAND: case ASSIGN_LSH: case ASSIGN_RSH: case ASSIGN_URSH:
 312         case ASSIGN_ADD: case ASSIGN_SUB: case ASSIGN_MUL: case ASSIGN_DIV: case ASSIGN_MOD: {
 313             b.add(parserLine, GET_PRESERVE);
 314             startExpr(b, -1);
 315             b.add(parserLine, tok - 1);
 316             b.add(parserLine, PUT);
 317             b.add(parserLine, SWAP);
 318             b.add(parserLine, POP);
 319             break;
 320         }
 321         case INC: case DEC: { // postfix
 322             b.add(parserLine, GET_PRESERVE);
 323             b.add(parserLine, LITERAL, new Integer(1));
 324             b.add(parserLine, tok == INC ? ADD : SUB);
 325             b.add(parserLine, PUT);
 326             b.add(parserLine, SWAP);
 327             b.add(parserLine, POP);
 328             b.add(parserLine, LITERAL, new Integer(1));
 329             b.add(parserLine, tok == INC ? SUB : ADD);
 330             break;
 331         }
 332         case ASSIGN: {
 333             startExpr(b, -1);
 334             b.add(parserLine, PUT);
 335             b.add(parserLine, SWAP);
 336             b.add(parserLine, POP);
 337             break;
 338         }
 339         default: {
 340             pushBackToken();
 341             b.add(parserLine, GET);
 342             return;
 343         }
 344         }
 345     }
 346
 347
 348     /**
 349      *  Assuming that a complete expression has just been parsed,
 350      *  <tt>continueExpr</tt> will attempt to extend this expression by
 351      *  parsing additional tokens and appending additional bytecodes.
 352      *
 353      *  No operators with precedence less than <tt>minPrecedence</tt>
 354      *  will be parsed.
 355      *
 356      *  If any bytecodes are appended, they will not alter the stack
 357      *  depth.
 358      */
 359     private void continueExpr(CompiledFunctionImpl b, int minPrecedence) throws IOException {
 360         int saveParserLine = parserLine;
 361         _continueExpr(b, minPrecedence);
 362         parserLine = saveParserLine;
 363     }
 364     private void _continueExpr(CompiledFunctionImpl b, int minPrecedence) throws IOException {
 365         if (b == null) throw new Error("got null b; this should never happen");
 366         int tok = getToken();
 367         if (tok == -1) return;
 368         if (minPrecedence != -1 && (precedence[tok] < minPrecedence || (precedence[tok] == minPrecedence && !isRightAssociative[tok]))) {
 369             pushBackToken();
 370             return;
 371         }
 372
 373         switch (tok) {
 374         case LP: {  // invocation (not grouping)
 375             int i = 0;
 376             while(peekToken() != RP) {
 377                 i++;
 378                 if (peekToken() != COMMA) {
 379                     startExpr(b, -1);
 380                     if (peekToken() == RP) break;
 381                 }
 382                 consume(COMMA);
 383             }
 384             consume(RP);
 385             b.add(parserLine, CALL, new Integer(i));
 386             break;
 387         }
 388         case BITOR: case BITXOR: case BITAND: case SHEQ: case SHNE: case LSH:
 389         case RSH: case URSH: case ADD: case MUL: case DIV: case MOD:
 390         case GT: case GE: case EQ: case NE: case LT: case LE: case SUB: {
 391             startExpr(b, precedence[tok]);
 392             b.add(parserLine, tok);
 393             break;
 394         }
 395         case OR: case AND: {
 396             b.add(parserLine, tok == AND ? b.JF : b.JT, new Integer(0));       // test to see if we can short-circuit
 397             int size = b.size();
 398             startExpr(b, precedence[tok]);                                     // otherwise check the second value
 399             b.add(parserLine, JMP, new Integer(2));                            // leave the second value on the stack and jump to the end
 400             b.add(parserLine, LITERAL, tok == AND ?
 401                   new Boolean(false) : new Boolean(true));                     // target of the short-circuit jump is here
 402             b.set(size - 1, new Integer(b.size() - size));                     // write the target of the short-circuit jump
 403             break;
 404         }
 405         case DOT: {
 406             consume(NAME);
 407             b.add(parserLine, LITERAL, string);
 408             continueExprAfterAssignable(b);
 409             break;
 410         }
 411         case LB: { // subscripting (not array constructor)
 412             startExpr(b, -1);
 413             consume(RB);
 414             continueExprAfterAssignable(b);
 415             break;
 416         }
 417         case HOOK: {
 418             b.add(parserLine, JF, new Integer(0));                // jump to the if-false expression
 419             int size = b.size();
 420             startExpr(b, -1);                                     // write the if-true expression
 421             b.add(parserLine, JMP, new Integer(0));               // if true, jump *over* the if-false expression
 422             b.set(size - 1, new Integer(b.size() - size + 1));    // now we know where the target of the jump is
 423             consume(COLON);
 424             size = b.size();
 425             startExpr(b, -1);                                     // write the if-false expression
 426             b.set(size - 1, new Integer(b.size() - size + 1));    // this is the end; jump to here
 427             break;
 428         }
 429         default: {
 430             pushBackToken();
 431             return;
 432         }
 433         }
 434
 435         continueExpr(b, minPrecedence);                           // try to continue the expression
 436     }
 437
 438     /** Parse a block of statements which must be surrounded by LC..RC. */
 439     void parseBlock(CompiledFunctionImpl b) throws IOException { parseBlock(b, null); }
 440     void parseBlock(CompiledFunctionImpl b, String label) throws IOException {
 441         int saveParserLine = parserLine;
 442         _parseBlock(b, label);
 443         parserLine = saveParserLine;
 444     }
 445     void _parseBlock(CompiledFunctionImpl b, String label) throws IOException {
 446         if (peekToken() == -1) return;
 447         else if (peekToken() != LC) parseStatement(b, null);
 448         else {
 449             consume(LC);
 450             while(peekToken() != RC && peekToken() != -1) parseStatement(b, null);
 451             consume(RC);
 452         }
 453     }
 454
 455     /** Parse a single statement, consuming the RC or SEMI which terminates it. */
 456     void parseStatement(CompiledFunctionImpl b, String label) throws IOException {
 457         int saveParserLine = parserLine;
 458         _parseStatement(b, label);
 459         parserLine = saveParserLine;
 460     }
 461     void _parseStatement(CompiledFunctionImpl b, String label) throws IOException {
 462         int tok = peekToken();
 463         if (tok == -1) return;
 464         switch(tok = getToken()) {
 465
 466         case THROW: case ASSERT: case RETURN: {
 467             if (tok == RETURN && peekToken() == SEMI)
 468                 b.add(parserLine, LITERAL, null);
 469             else
 470                 startExpr(b, -1);
 471             b.add(parserLine, tok);
 472             consume(SEMI);
 473             break;
 474         }
 475         case BREAK: case CONTINUE: {
 476             if (peekToken() == NAME) consume(NAME);
 477             b.add(parserLine, tok, string);
 478             consume(SEMI);
 479             break;
 480         }
 481         case VAR: {
 482             b.add(parserLine, TOPSCOPE);                         // push the current scope
 483             while(true) {
 484                 consume(NAME);
 485                 String name = string;
 486                 b.add(parserLine, LITERAL, name);                // push the name to be declared
 487                 b.add(parserLine, DECLARE);                      // declare it
 488                 if (peekToken() == ASSIGN) {                     // if there is an '=' after the variable name
 489                     b.add(parserLine, LITERAL, name);            // put the var name back on the stack
 490                     consume(ASSIGN);
 491                     startExpr(b, -1);
 492                     b.add(parserLine, PUT);                      // assign it
 493                     b.add(parserLine, POP);                      // clean the stack
 494                 }
 495                 if (peekToken() != COMMA) break;
 496                 consume(COMMA);
 497             }
 498             b.add(parserLine, POP);                              // pop off the topscope
 499             if ((mostRecentlyReadToken != RC || peekToken() == SEMI) && peekToken() != -1 && mostRecentlyReadToken != SEMI) consume(SEMI);
 500             break;
 501         }
 502         case IF: {
 503             consume(LP);
 504             startExpr(b, -1);
 505             consume(RP);
 506
 507             b.add(parserLine, JF, new Integer(0));                    // if false, jump to the else-block
 508             int size = b.size();
 509             parseStatement(b, null);
 510
 511             if (peekToken() == ELSE) {
 512                 consume(ELSE);
 513                 b.add(parserLine, JMP, new Integer(0));               // if we took the true-block, jump over the else-block
 514                 b.set(size - 1, new Integer(b.size() - size + 1));
 515                 size = b.size();
 516                 parseStatement(b, null);
 517             }
 518             b.set(size - 1, new Integer(b.size() - size + 1));        // regardless of which branch we took, b[size] needs to point here
 519             break;
 520         }
 521         case WHILE: {
 522             consume(LP);
 523             if (label != null) b.add(parserLine, LABEL, label);
 524             b.add(parserLine, LOOP);
 525             int size = b.size();
 526             b.add(parserLine, POP);                                   // discard the first-iteration indicator
 527             startExpr(b, -1);
 528             b.add(parserLine, JT, new Integer(2));                    // if the while() clause is true, jump over the BREAK
 529             b.add(parserLine, BREAK);
 530             consume(RP);
 531             parseStatement(b, null);
 532             b.add(parserLine, CONTINUE);                              // if we fall out of the end, definately continue
 533             b.set(size - 1, new Integer(b.size() - size + 1));        // end of the loop
 534             break;
 535         }
 536         case SWITCH: {
 537             consume(LP);
 538             if (label != null) b.add(parserLine, LABEL, label);
 539             b.add(parserLine, LOOP);
 540             int size0 = b.size();
 541             startExpr(b, -1);
 542             consume(RP);
 543             consume(LC);
 544             while(true)
 545                 if (peekToken() == CASE) {                         // we compile CASE statements like a bunch of if..else's
 546                     consume(CASE);
 547                     b.add(parserLine, DUP);                        // duplicate the switch() value; we'll consume one copy
 548                     startExpr(b, -1);
 549                     consume(COLON);
 550                     b.add(parserLine, EQ);                         // check if we should do this case-block
 551                     b.add(parserLine, JF, new Integer(0));         // if not, jump to the next one
 552                     int size = b.size();
 553                     while(peekToken() != CASE && peekToken() != DEFAULT && peekToken() != RC) parseStatement(b, null);
 554                     b.set(size - 1, new Integer(1 + b.size() - size));
 555                 } else if (peekToken() == DEFAULT) {
 556                     consume(DEFAULT);
 557                     consume(COLON);
 558                     while(peekToken() != CASE && peekToken() != DEFAULT && peekToken() != RC) parseStatement(b, null);
 559                 } else if (peekToken() == RC) {
 560                     consume(RC);
 561                     b.add(parserLine, BREAK);                      // break out of the loop if we 'fall through'
 562                     break;
 563                 } else {
 564                     throw pe("expected CASE, DEFAULT, or RC; got " + codeToString[peekToken()]);
 565                 }
 566             b.set(size0 - 1, new Integer(b.size() - size0 + 1));      // end of the loop
 567             break;
 568         }
 569
 570         case DO: {
 571             if (label != null) b.add(parserLine, LABEL, label);
 572             b.add(parserLine, LOOP);
 573             int size = b.size();
 574             parseStatement(b, null);
 575             consume(WHILE);
 576             consume(LP);
 577             startExpr(b, -1);
 578             b.add(parserLine, JT, new Integer(2));                  // check the while() clause; jump over the BREAK if true
 579             b.add(parserLine, BREAK);
 580             b.add(parserLine, CONTINUE);
 581             consume(RP);
 582             consume(SEMI);
 583             b.set(size - 1, new Integer(b.size() - size + 1));      // end of the loop; write this location to the LOOP instruction
 584             break;
 585         }
 586
 587         case TRY: {
 588             b.add(parserLine, TRY);
 589             int size = b.size();
 590             parseStatement(b, null);                                 // parse the expression to be TRYed
 591             b.add(parserLine, POP);                                  // pop the TryMarker
 592             b.add(parserLine, JMP);                                  // jump forward to the end of the catch block
 593             int size2 = b.size();
 594             b.set(size - 1, new Integer(b.size() - size + 1));       // the TRY argument points at the start of the CATCH block
 595
 596             if (peekToken() == CATCH) {
 597                 getToken();
 598                 consume(LP);
 599                 consume(NAME);
 600                 consume(RP);
 601                 b.add(parserLine, TOPSCOPE);                        // the exception is on top of the stack; put it to the chosen name
 602                 b.add(parserLine, SWAP);
 603                 b.add(parserLine, LITERAL);
 604                 b.add(parserLine, SWAP);
 605                 b.add(parserLine, PUT);
 606                 b.add(parserLine, POP);
 607                 b.add(parserLine, POP);
 608                 parseStatement(b, null);
 609             }
 610
 611             // jump here if no exception was thrown
 612             b.set(size2 - 1, new Integer(b.size() - size2 + 1));
 613
 614             // FIXME: not implemented correctly
 615             if (peekToken() == FINALLY) {
 616                 consume(FINALLY);
 617                 parseStatement(b, null);
 618             }
 619             break;
 620         }
 621
 622         case FOR: {
 623             consume(LP);
 624
 625             tok = getToken();
 626             boolean hadVar = false;                                      // if it's a for..in, we ignore the VAR
 627             if (tok == VAR) { hadVar = true; tok = getToken(); }
 628             String varName = string;
 629             boolean forIn = peekToken() == IN;                           // determine if this is a for..in loop or not
 630             pushBackToken(tok, varName);
 631
 632             if (forIn) {
 633                 b.add(parserLine, NEWSCOPE);                             // for-loops always create new scopes
 634                 b.add(parserLine, LITERAL, varName);                     // declare the new variable
 635                 b.add(parserLine, DECLARE);
 636
 637                 b.add(parserLine, LOOP);                                 // we actually only add this to ensure that BREAK works
 638                 b.add(parserLine, POP);                                  // discard the first-iteration indicator
 639                 int size = b.size();
 640                 consume(NAME);
 641                 consume(IN);
 642                 startExpr(b, -1);
 643                 b.add(parserLine, PUSHKEYS);                             // push the keys as an array; check the length
 644                 b.add(parserLine, LITERAL, "length");
 645                 b.add(parserLine, GET);
 646                 consume(RP);
 647
 648                 b.add(parserLine, LITERAL, new Integer(1));              // decrement the length
 649                 b.add(parserLine, SUB);
 650                 b.add(parserLine, DUP);
 651                 b.add(parserLine, LITERAL, new Integer(0));              // see if we've exhausted all the elements
 652                 b.add(parserLine, LT);
 653                 b.add(parserLine, JF, new Integer(2));
 654                 b.add(parserLine, BREAK);                                // if we have, then BREAK
 655                 b.add(parserLine, GET_PRESERVE);                         // get the key out of the keys array
 656                 b.add(parserLine, LITERAL, varName);
 657                 b.add(parserLine, PUT);                                  // write it to this[varName]
 658                 parseStatement(b, null);                                 // do some stuff
 659                 b.add(parserLine, CONTINUE);                             // continue if we fall out the bottom
 660
 661                 b.set(size - 1, new Integer(b.size() - size + 1));       // BREAK to here
 662                 b.add(parserLine, OLDSCOPE);                             // restore the scope
 663
 664             } else {
 665                 if (hadVar) pushBackToken(VAR, null);                    // yeah, this actually matters
 666                 b.add(parserLine, NEWSCOPE);                             // grab a fresh scope
 667
 668                 parseStatement(b, null);                                 // initializer
 669                 CompiledFunctionImpl e2 =                                    // we need to put the incrementor before the test
 670                     new JS.CompiledFunction(sourceName, parserLine, null, null);  // so we save the test here
 671                 if (peekToken() != SEMI)
 672                     startExpr(e2, -1);
 673                 else
 674                     e2.add(parserLine, b.LITERAL, Boolean.TRUE);         // handle the for(foo;;foo) case
 675                 consume(SEMI);
 676                 if (label != null) b.add(parserLine, LABEL, label);
 677                 b.add(parserLine, LOOP);
 678                 int size2 = b.size();
 679
 680                 b.add(parserLine, JT, new Integer(0));                   // if we're on the first iteration, jump over the incrementor
 681                 int size = b.size();
 682                 if (peekToken() != RP) {                                 // do the increment thing
 683                     startExpr(b, -1);
 684                     b.add(parserLine, POP);
 685                 }
 686                 b.set(size - 1, new Integer(b.size() - size + 1));
 687                 consume(RP);
 688
 689                 b.paste(e2);                                             // ok, *now* test if we're done yet
 690                 b.add(parserLine, JT, new Integer(2));                   // break out if we don't meet the test
 691                 b.add(parserLine, BREAK);
 692                 parseStatement(b, null);
 693                 b.add(parserLine, CONTINUE);                             // if we fall out the bottom, CONTINUE
 694                 b.set(size2 - 1, new Integer(b.size() - size2 + 1));     // end of the loop
 695
 696                 b.add(parserLine, OLDSCOPE);                             // get our scope back
 697             }
 698             break;
 699         }
 700
 701         case NAME: {  // either a label or an identifier; this is the one place we're not LL(1)
 702             String possiblyTheLabel = string;
 703             if (peekToken() == COLON) {      // label
 704                 consume(COLON);
 705                 parseStatement(b, possiblyTheLabel);
 706                 break;
 707             } else {                         // expression
 708                 pushBackToken(NAME, possiblyTheLabel);
 709                 startExpr(b, -1);
 710                 b.add(parserLine, POP);
 711                 if ((mostRecentlyReadToken != RC || peekToken() == SEMI) && peekToken() != -1 && mostRecentlyReadToken != SEMI) consume(SEMI);
 712                 break;
 713             }
 714         }
 715
 716         case SEMI: return;                                               // yep, the null statement is valid
 717
 718         case LC: {  // blocks are statements too
 719             pushBackToken();
 720             b.add(parserLine, NEWSCOPE);
 721             parseBlock(b, label);
 722             b.add(parserLine, OLDSCOPE);
 723             break;
 724         }
 725
 726         default: {  // hope that it's an expression
 727             pushBackToken();
 728             startExpr(b, -1);
 729             b.add(parserLine, POP);
 730             if ((mostRecentlyReadToken != RC || peekToken() == SEMI) && peekToken() != -1 && mostRecentlyReadToken != SEMI) consume(SEMI);
 731             break;
 732         }
 733         }
 734     }
 735
 736
 737     // ParserException //////////////////////////////////////////////////////////////////////
 738     private IOException pe(String s) { return new IOException(sourceName + ":" + parserLine + " " + s); }
 739
 740 }
 741