3 * Copyright (c) 1991-1994, Larry Wall
5 * You may distribute under the terms of either the GNU General Public
6 * License or the Artistic License, as specified in the README file.
11 * 'I see,' laughed Strider. 'I look foul and feel fair. Is that it?
12 * All that is gold does not glitter, not all those that wander are lost.'
22 deprecate("\"do\" to call subroutines");
38 %token <opval> WORD METHOD FUNCMETH THING PMFUNC PRIVATEREF
39 %token <opval> FUNC0SUB UNIOPSUB LSTOPSUB
41 %token <ival> FORMAT SUB ANONSUB PACKAGE USE
42 %token <ival> WHILE UNTIL IF UNLESS ELSE ELSIF CONTINUE FOR
43 %token <ival> LOOPEX DOTDOT
44 %token <ival> FUNC0 FUNC1 FUNC
45 %token <ival> RELOP EQOP MULOP ADDOP
46 %token <ival> DOLSHARP DO HASHBRACK NOAMP
49 %type <ival> prog decl local format startsub remember mremember '&'
50 %type <opval> block mblock lineseq line loop cond else
51 %type <opval> expr term scalar ary hsh arylen star amper sideff
52 %type <opval> argexpr nexpr texpr iexpr mexpr mnexpr mtexpr miexpr
53 %type <opval> listexpr listexprcom indirob
54 %type <opval> listop method proto cont my_scalar
60 %nonassoc <ival> LSTOP
62 %right <ival> ASSIGNOP
71 %nonassoc <ival> UNIOP
76 %right '!' '~' UMINUS REFGEN
78 %nonassoc PREINC PREDEC POSTINC POSTDEC
86 #if defined(YYDEBUG) && defined(DEBUGGING)
87 yydebug = (debug & 1);
95 block : '{' remember lineseq '}'
96 { $$ = block_end($1,$2,$3); }
99 remember: /* NULL */ /* start a full lexical scope */
100 { $$ = block_start(TRUE); }
103 mblock : '{' mremember lineseq '}'
104 { $$ = block_end($1,$2,$3); }
107 mremember: /* NULL */ /* start a partial lexical scope */
108 { $$ = block_start(FALSE); }
116 { $$ = append_list(OP_LINESEQ,
117 (LISTOP*)$1, (LISTOP*)$2);
118 pad_reset_pending = TRUE;
119 if ($1 && $2) hints |= HINT_BLOCK_SCOPE; }
123 { $$ = newSTATEOP(0, $1, $2); }
124 | loop /* loops add their own labels */
126 { if ($1 != Nullch) {
127 $$ = newSTATEOP(0, $1, newOP(OP_NULL, 0));
135 { $$ = newSTATEOP(0, $1, $2);
144 { $$ = newLOGOP(OP_AND, 0, $3, $1); }
146 { $$ = newLOGOP(OP_OR, 0, $3, $1); }
148 { $$ = newLOOPOP(OPf_PARENS, 1, scalar($3), $1); }
150 { $$ = newLOOPOP(OPf_PARENS, 1, $3, $1);}
157 | ELSIF '(' mexpr ')' mblock else
159 $$ = newSTATEOP(0, Nullch,
160 newCONDOP(0, $3, scope($5), $6));
161 hints |= HINT_BLOCK_SCOPE; }
164 cond : IF '(' remember mexpr ')' mblock else
166 $$ = block_end($1, $3,
167 newCONDOP(0, $4, scope($6), $7)); }
168 | UNLESS '(' remember miexpr ')' mblock else
170 $$ = block_end($1, $3,
171 newCONDOP(0, $4, scope($6), $7)); }
172 | IF block block else
174 deprecate("if BLOCK BLOCK");
175 $$ = newCONDOP(0, scope($2), scope($3), $4); }
176 | UNLESS block block else
178 deprecate("unless BLOCK BLOCK");
179 $$ = newCONDOP(0, invert(scalar(scope($2))),
189 loop : label WHILE '(' remember mtexpr ')' mblock cont
191 $$ = block_end($2, $4,
193 newWHILEOP(0, 1, (LOOP*)Nullop,
195 | label UNTIL '(' remember miexpr ')' mblock cont
197 $$ = block_end($2, $4,
199 newWHILEOP(0, 1, (LOOP*)Nullop,
201 | label WHILE block block cont
203 $$ = newWHILEOP(0, 1, (LOOP*)Nullop,
204 scope($3), $4, $5); }
205 | label UNTIL block block cont
207 $$ = newWHILEOP(0, 1, (LOOP*)Nullop,
208 invert(scalar(scope($3))),
210 | label FOR MY remember my_scalar '(' mexpr ')' mblock cont
211 { $$ = block_end($2, $4,
212 newFOROP(0, $1, $2, $5, $7, $9, $10)); }
213 | label FOR scalar '(' remember mexpr ')' mblock cont
214 { $$ = block_end($2, $5,
215 newFOROP(0, $1, $2, mod($3, OP_ENTERLOOP),
217 | label FOR '(' remember mexpr ')' mblock cont
218 { $$ = block_end($2, $4,
219 newFOROP(0, $1, $2, Nullop, $5, $7, $8)); }
220 | label FOR '(' remember mnexpr ';' mtexpr ';' mnexpr ')' mblock
221 /* basically fake up an initialize-while lineseq */
223 $$ = block_end($2, $4,
224 append_elem(OP_LINESEQ, scalar($5),
226 newWHILEOP(0, 1, (LOOP*)Nullop,
228 $11, scalar($9))))); }
229 | label block cont /* a block is a loop that happens once */
231 $1, newWHILEOP(0, 1, (LOOP*)Nullop,
240 texpr : /* NULL means true */
241 { (void)scan_num("1"); $$ = yylval.opval; }
246 { $$ = invert(scalar($1)); }
250 { $$ = $1; intro_my(); }
254 { $$ = $1; intro_my(); }
258 { $$ = $1; intro_my(); }
262 { $$ = $1; intro_my(); }
280 format : FORMAT startsub WORD block
281 { newFORM($2, $3, $4); }
282 | FORMAT startsub block
283 { newFORM($2, Nullop, $3); }
286 subrout : SUB startsub WORD proto block
287 { newSUB($2, $3, $4, $5); }
288 | SUB startsub WORD proto ';'
289 { newSUB($2, $3, $4, Nullop); expect = XSTATE; }
297 startsub: /* NULL */ /* start a subroutine scope */
298 { $$ = start_subparse(); }
301 package : PACKAGE WORD ';'
307 use : USE startsub WORD WORD listexpr ';'
308 { utilize($1, $2, $3, $4, $5); }
311 expr : expr ANDOP expr
312 { $$ = newLOGOP(OP_AND, 0, $1, $3); }
314 { $$ = newLOGOP($2, 0, $1, $3); }
318 argexpr : argexpr ','
321 { $$ = append_elem(OP_LIST, $1, $3); }
325 listop : LSTOP indirob argexpr
326 { $$ = convert($1, OPf_STACKED,
327 prepend_elem(OP_LIST, newGVREF($1,$2), $3) ); }
328 | FUNC '(' indirob expr ')'
329 { $$ = convert($1, OPf_STACKED,
330 prepend_elem(OP_LIST, newGVREF($1,$3), $4) ); }
331 | term ARROW method '(' listexprcom ')'
332 { $$ = convert(OP_ENTERSUB, OPf_STACKED,
334 prepend_elem(OP_LIST, scalar($1), $5),
335 newUNOP(OP_METHOD, 0, $3))); }
336 | METHOD indirob listexpr
337 { $$ = convert(OP_ENTERSUB, OPf_STACKED,
339 prepend_elem(OP_LIST, $2, $3),
340 newUNOP(OP_METHOD, 0, $1))); }
341 | FUNCMETH indirob '(' listexprcom ')'
342 { $$ = convert(OP_ENTERSUB, OPf_STACKED,
344 prepend_elem(OP_LIST, $2, $4),
345 newUNOP(OP_METHOD, 0, $1))); }
347 { $$ = convert($1, 0, $2); }
348 | FUNC '(' listexprcom ')'
349 { $$ = convert($1, 0, $3); }
350 | LSTOPSUB startsub block listexpr %prec LSTOP
351 { $$ = newUNOP(OP_ENTERSUB, OPf_STACKED,
353 prepend_elem(OP_LIST, newANONSUB($2, 0, $3), $4),
361 term : term ASSIGNOP term
362 { $$ = newASSIGNOP(OPf_STACKED, $1, $2, $3); }
364 { $$ = newBINOP($2, 0, scalar($1), scalar($3)); }
366 { if ($2 != OP_REPEAT)
368 $$ = newBINOP($2, 0, $1, scalar($3)); }
370 { $$ = newBINOP($2, 0, scalar($1), scalar($3)); }
372 { $$ = newBINOP($2, 0, scalar($1), scalar($3)); }
374 { $$ = newBINOP($2, 0, scalar($1), scalar($3)); }
376 { $$ = newBINOP($2, 0, scalar($1), scalar($3)); }
378 { $$ = newBINOP($2, 0, scalar($1), scalar($3)); }
380 { $$ = newBINOP($2, 0, scalar($1), scalar($3)); }
382 { $$ = newRANGE($2, scalar($1), scalar($3));}
384 { $$ = newLOGOP(OP_AND, 0, $1, $3); }
386 { $$ = newLOGOP(OP_OR, 0, $1, $3); }
387 | term '?' term ':' term
388 { $$ = newCONDOP(0, $1, $3, $5); }
390 { $$ = bind_match($2, $1, $3); }
392 | '-' term %prec UMINUS
393 { $$ = newUNOP(OP_NEGATE, 0, scalar($2)); }
394 | '+' term %prec UMINUS
397 { $$ = newUNOP(OP_NOT, 0, scalar($2)); }
399 { $$ = newUNOP(OP_COMPLEMENT, 0, scalar($2));}
401 { $$ = newUNOP(OP_REFGEN, 0, mod($2,OP_REFGEN)); }
403 { $$ = newUNOP(OP_POSTINC, 0,
404 mod(scalar($1), OP_POSTINC)); }
406 { $$ = newUNOP(OP_POSTDEC, 0,
407 mod(scalar($1), OP_POSTDEC)); }
409 { $$ = newUNOP(OP_PREINC, 0,
410 mod(scalar($2), OP_PREINC)); }
412 { $$ = newUNOP(OP_PREDEC, 0,
413 mod(scalar($2), OP_PREDEC)); }
414 | local term %prec UNIOP
415 { $$ = localize($2,$1); }
417 { $$ = sawparens($2); }
419 { $$ = sawparens(newNULLLIST()); }
420 | '[' expr ']' %prec '('
421 { $$ = newANONLIST($2); }
423 { $$ = newANONLIST(Nullop); }
424 | HASHBRACK expr ';' '}' %prec '('
425 { $$ = newANONHASH($2); }
426 | HASHBRACK ';' '}' %prec '('
427 { $$ = newANONHASH(Nullop); }
428 | ANONSUB startsub proto block %prec '('
429 { $$ = newANONSUB($2, $3, $4); }
432 | star '{' expr ';' '}'
433 { $$ = newBINOP(OP_GELEM, 0, newGVREF(0,$1), $3); }
436 | scalar '[' expr ']' %prec '('
437 { $$ = newBINOP(OP_AELEM, 0, oopsAV($1), scalar($3)); }
438 | term ARROW '[' expr ']' %prec '('
439 { $$ = newBINOP(OP_AELEM, 0,
440 ref(newAVREF($1),OP_RV2AV),
442 | term '[' expr ']' %prec '('
443 { assertref($1); $$ = newBINOP(OP_AELEM, 0,
444 ref(newAVREF($1),OP_RV2AV),
451 { $$ = newUNOP(OP_AV2ARYLEN, 0, ref($1, OP_AV2ARYLEN));}
452 | scalar '{' expr ';' '}' %prec '('
453 { $$ = newBINOP(OP_HELEM, 0, oopsHV($1), jmaybe($3));
454 expect = XOPERATOR; }
455 | term ARROW '{' expr ';' '}' %prec '('
456 { $$ = newBINOP(OP_HELEM, 0,
457 ref(newHVREF($1),OP_RV2HV),
459 expect = XOPERATOR; }
460 | term '{' expr ';' '}' %prec '('
461 { assertref($1); $$ = newBINOP(OP_HELEM, 0,
462 ref(newHVREF($1),OP_RV2HV),
464 expect = XOPERATOR; }
465 | '(' expr ')' '[' expr ']' %prec '('
466 { $$ = newSLICEOP(0, $5, $2); }
467 | '(' ')' '[' expr ']' %prec '('
468 { $$ = newSLICEOP(0, $4, Nullop); }
469 | ary '[' expr ']' %prec '('
470 { $$ = prepend_elem(OP_ASLICE,
471 newOP(OP_PUSHMARK, 0),
472 newLISTOP(OP_ASLICE, 0,
474 ref($1, OP_ASLICE))); }
475 | ary '{' expr ';' '}' %prec '('
476 { $$ = prepend_elem(OP_HSLICE,
477 newOP(OP_PUSHMARK, 0),
478 newLISTOP(OP_HSLICE, 0,
480 ref(oopsHV($1), OP_HSLICE)));
481 expect = XOPERATOR; }
485 { $$ = newUNOP(OP_ENTERSUB, 0, scalar($1)); }
487 { $$ = newUNOP(OP_ENTERSUB, OPf_STACKED, scalar($1)); }
489 { $$ = newUNOP(OP_ENTERSUB, OPf_STACKED,
490 append_elem(OP_LIST, $3, scalar($1))); }
491 | NOAMP WORD listexpr
492 { $$ = newUNOP(OP_ENTERSUB, OPf_STACKED,
493 append_elem(OP_LIST, $3, scalar($2))); }
494 | DO term %prec UNIOP
495 { $$ = newUNOP(OP_DOFILE, 0, scalar($2)); }
497 { $$ = newUNOP(OP_NULL, OPf_SPECIAL, scope($2)); }
499 { $$ = newUNOP(OP_ENTERSUB,
500 OPf_SPECIAL|OPf_STACKED,
501 prepend_elem(OP_LIST,
503 (OPpENTERSUB_AMPER<<8),
506 | DO WORD '(' expr ')'
507 { $$ = newUNOP(OP_ENTERSUB,
508 OPf_SPECIAL|OPf_STACKED,
512 (OPpENTERSUB_AMPER<<8),
516 { $$ = newUNOP(OP_ENTERSUB, OPf_SPECIAL|OPf_STACKED,
517 prepend_elem(OP_LIST,
518 scalar(newCVREF(0,scalar($2))), Nullop)); dep();}
519 | DO scalar '(' expr ')'
520 { $$ = newUNOP(OP_ENTERSUB, OPf_SPECIAL|OPf_STACKED,
521 prepend_elem(OP_LIST,
523 scalar(newCVREF(0,scalar($2))))); dep();}
525 { $$ = newOP($1, OPf_SPECIAL);
526 hints |= HINT_BLOCK_SCOPE; }
528 { $$ = newLOOPEX($1,$2); }
530 { $$ = newUNOP(OP_NOT, 0, scalar($2)); }
532 { $$ = newOP($1, 0); }
534 { $$ = newUNOP($1, 0, $2); }
536 { $$ = newUNOP($1, 0, $2); }
538 { $$ = newUNOP(OP_ENTERSUB, OPf_STACKED,
539 append_elem(OP_LIST, $2, scalar($1))); }
541 { $$ = newOP($1, 0); }
543 { $$ = newOP($1, 0); }
545 { $$ = newUNOP(OP_ENTERSUB, 0,
548 { $$ = newOP($1, OPf_SPECIAL); }
550 { $$ = newUNOP($1, 0, $3); }
551 | PMFUNC '(' term ')'
552 { $$ = pmruntime($1, $3, Nullop); }
553 | PMFUNC '(' term ',' term ')'
554 { $$ = pmruntime($1, $3, $5); }
565 listexprcom: /* NULL */
573 local : LOCAL { $$ = 0; }
578 { in_my = 0; $$ = my($1); }
582 { $$ = newCVREF($1,$2); }
586 { $$ = newSVREF($2); }
590 { $$ = newAVREF($2); }
594 { $$ = newHVREF($2); }
597 arylen : DOLSHARP indirob
598 { $$ = newAVREF($2); }
602 { $$ = newGVREF(0,$2); }