3 * Copyright (c) 1991-1997, 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 who wander are lost.'
22 deprecate("\"do\" to call subroutines");
46 %token <opval> WORD METHOD FUNCMETH THING PMFUNC PRIVATEREF
47 %token <opval> FUNC0SUB UNIOPSUB LSTOPSUB
49 %token <ival> FORMAT SUB ANONSUB PACKAGE USE
50 %token <ival> WHILE UNTIL IF UNLESS ELSE ELSIF CONTINUE FOR
51 %token <ival> LOOPEX DOTDOT
52 %token <ival> FUNC0 FUNC1 FUNC UNIOP LSTOP
53 %token <ival> RELOP EQOP MULOP ADDOP
54 %token <ival> DOLSHARP DO HASHBRACK NOAMP
57 %type <ival> prog decl local format startsub startanonsub startformsub
58 %type <ival> remember mremember '&'
59 %type <opval> block mblock lineseq line loop cond else
60 %type <opval> expr term scalar ary hsh arylen star amper sideff
61 %type <opval> argexpr nexpr texpr iexpr mexpr mnexpr mtexpr miexpr
62 %type <opval> listexpr listexprcom indirob listop method
63 %type <opval> formname subname proto subbody cont my_scalar
69 %nonassoc LSTOP LSTOPSUB
71 %right <ival> ASSIGNOP
80 %nonassoc UNIOP UNIOPSUB
85 %right '!' '~' UMINUS REFGEN
87 %nonassoc PREINC PREDEC POSTINC POSTDEC
95 #if defined(YYDEBUG) && defined(DEBUGGING)
96 yydebug = (PL_debug & 1);
100 /*CONTINUED*/ lineseq
104 block : '{' remember lineseq '}'
105 { if (PL_copline > (line_t)$1)
107 $$ = block_end($2, $3); }
110 remember: /* NULL */ /* start a full lexical scope */
111 { $$ = block_start(TRUE); }
114 mblock : '{' mremember lineseq '}'
115 { if (PL_copline > (line_t)$1)
117 $$ = block_end($2, $3); }
120 mremember: /* NULL */ /* start a partial lexical scope */
121 { $$ = block_start(FALSE); }
129 { $$ = append_list(OP_LINESEQ,
130 (LISTOP*)$1, (LISTOP*)$2);
131 PL_pad_reset_pending = TRUE;
132 if ($1 && $2) PL_hints |= HINT_BLOCK_SCOPE; }
136 { $$ = newSTATEOP(0, $1, $2); }
137 | loop /* loops add their own labels */
139 { if ($1 != Nullch) {
140 $$ = newSTATEOP(0, $1, newOP(OP_NULL, 0));
146 PL_expect = XSTATE; }
148 { $$ = newSTATEOP(0, $1, $2);
149 PL_expect = XSTATE; }
157 { $$ = newLOGOP(OP_AND, 0, $3, $1); }
159 { $$ = newLOGOP(OP_OR, 0, $3, $1); }
161 { $$ = newLOOPOP(OPf_PARENS, 1, scalar($3), $1); }
163 { $$ = newLOOPOP(OPf_PARENS, 1, $3, $1);}
165 { $$ = newFOROP(0, Nullch, $2,
166 Nullop, $3, $1, Nullop); }
173 | ELSIF '(' mexpr ')' mblock else
175 $$ = newSTATEOP(0, Nullch,
176 newCONDOP(0, $3, scope($5), $6));
177 PL_hints |= HINT_BLOCK_SCOPE; }
180 cond : IF '(' remember mexpr ')' mblock else
183 newCONDOP(0, $4, scope($6), $7)); }
184 | UNLESS '(' remember miexpr ')' mblock else
187 newCONDOP(0, $4, scope($6), $7)); }
196 loop : label WHILE '(' remember mtexpr ')' mblock cont
200 newWHILEOP(0, 1, (LOOP*)Nullop,
202 | label UNTIL '(' remember miexpr ')' mblock cont
206 newWHILEOP(0, 1, (LOOP*)Nullop,
208 | label FOR MY remember my_scalar '(' mexpr ')' mblock cont
210 newFOROP(0, $1, $2, $5, $7, $9, $10)); }
211 | label FOR scalar '(' remember mexpr ')' mblock cont
213 newFOROP(0, $1, $2, mod($3, OP_ENTERLOOP),
215 | label FOR '(' remember mexpr ')' mblock cont
217 newFOROP(0, $1, $2, Nullop, $5, $7, $8)); }
218 | label FOR '(' remember mnexpr ';' mtexpr ';' mnexpr ')' mblock
219 /* basically fake up an initialize-while lineseq */
220 { OP *forop = append_elem(OP_LINESEQ,
222 newWHILEOP(0, 1, (LOOP*)Nullop,
226 $$ = block_end($4, newSTATEOP(0, $1, forop)); }
227 | label block cont /* a block is a loop that happens once */
228 { $$ = newSTATEOP(0, $1,
229 newWHILEOP(0, 1, (LOOP*)Nullop,
230 NOLINE, Nullop, $2, $3)); }
238 texpr : /* NULL means true */
239 { (void)scan_num("1"); $$ = yylval.opval; }
244 { $$ = invert(scalar($1)); }
248 { $$ = $1; intro_my(); }
252 { $$ = $1; intro_my(); }
256 { $$ = $1; intro_my(); }
260 { $$ = $1; intro_my(); }
278 format : FORMAT startformsub formname block
279 { newFORM($2, $3, $4); }
282 formname: WORD { $$ = $1; }
283 | /* NULL */ { $$ = Nullop; }
286 subrout : SUB startsub subname proto subbody
287 { newSUB($2, $3, $4, $5); }
290 startsub: /* NULL */ /* start a regular subroutine scope */
291 { $$ = start_subparse(FALSE, 0); }
294 startanonsub: /* NULL */ /* start an anonymous subroutine scope */
295 { $$ = start_subparse(FALSE, CVf_ANON); }
298 startformsub: /* NULL */ /* start a format subroutine scope */
299 { $$ = start_subparse(TRUE, 0); }
302 subname : WORD { char *name = SvPV(((SVOP*)$1)->op_sv, PL_na);
303 if (strEQ(name, "BEGIN") || strEQ(name, "END")
304 || strEQ(name, "INIT"))
305 CvUNIQUE_on(PL_compcv);
314 subbody : block { $$ = $1; }
315 | ';' { $$ = Nullop; PL_expect = XSTATE; }
318 package : PACKAGE WORD ';'
325 { CvUNIQUE_on(PL_compcv); /* It's a BEGIN {} */ }
326 WORD WORD listexpr ';'
327 { utilize($1, $2, $4, $5, $6); }
330 expr : expr ANDOP expr
331 { $$ = newLOGOP(OP_AND, 0, $1, $3); }
333 { $$ = newLOGOP($2, 0, $1, $3); }
337 argexpr : argexpr ','
340 { $$ = append_elem(OP_LIST, $1, $3); }
344 listop : LSTOP indirob argexpr
345 { $$ = convert($1, OPf_STACKED,
346 prepend_elem(OP_LIST, newGVREF($1,$2), $3) ); }
347 | FUNC '(' indirob expr ')'
348 { $$ = convert($1, OPf_STACKED,
349 prepend_elem(OP_LIST, newGVREF($1,$3), $4) ); }
350 | term ARROW method '(' listexprcom ')'
351 { $$ = convert(OP_ENTERSUB, OPf_STACKED,
353 prepend_elem(OP_LIST, scalar($1), $5),
354 newUNOP(OP_METHOD, 0, $3))); }
355 | METHOD indirob listexpr
356 { $$ = convert(OP_ENTERSUB, OPf_STACKED,
358 prepend_elem(OP_LIST, $2, $3),
359 newUNOP(OP_METHOD, 0, $1))); }
360 | FUNCMETH indirob '(' listexprcom ')'
361 { $$ = convert(OP_ENTERSUB, OPf_STACKED,
363 prepend_elem(OP_LIST, $2, $4),
364 newUNOP(OP_METHOD, 0, $1))); }
366 { $$ = convert($1, 0, $2); }
367 | FUNC '(' listexprcom ')'
368 { $$ = convert($1, 0, $3); }
369 | LSTOPSUB startanonsub block
370 { $3 = newANONSUB($2, 0, $3); }
372 { $$ = newUNOP(OP_ENTERSUB, OPf_STACKED,
374 prepend_elem(OP_LIST, $3, $5), $1)); }
381 term : term ASSIGNOP term
382 { $$ = newASSIGNOP(OPf_STACKED, $1, $2, $3); }
384 { $$ = newBINOP($2, 0, scalar($1), scalar($3)); }
386 { if ($2 != OP_REPEAT)
388 $$ = newBINOP($2, 0, $1, scalar($3)); }
390 { $$ = newBINOP($2, 0, scalar($1), scalar($3)); }
392 { $$ = newBINOP($2, 0, scalar($1), scalar($3)); }
394 { $$ = newBINOP($2, 0, scalar($1), scalar($3)); }
396 { $$ = newBINOP($2, 0, scalar($1), scalar($3)); }
398 { $$ = newBINOP($2, 0, scalar($1), scalar($3)); }
400 { $$ = newBINOP($2, 0, scalar($1), scalar($3)); }
402 { $$ = newRANGE($2, scalar($1), scalar($3));}
404 { $$ = newLOGOP(OP_AND, 0, $1, $3); }
406 { $$ = newLOGOP(OP_OR, 0, $1, $3); }
407 | term '?' term ':' term
408 { $$ = newCONDOP(0, $1, $3, $5); }
410 { $$ = bind_match($2, $1, $3); }
412 | '-' term %prec UMINUS
413 { $$ = newUNOP(OP_NEGATE, 0, scalar($2)); }
414 | '+' term %prec UMINUS
417 { $$ = newUNOP(OP_NOT, 0, scalar($2)); }
419 { $$ = newUNOP(OP_COMPLEMENT, 0, scalar($2));}
421 { $$ = newUNOP(OP_REFGEN, 0, mod($2,OP_REFGEN)); }
423 { $$ = newUNOP(OP_POSTINC, 0,
424 mod(scalar($1), OP_POSTINC)); }
426 { $$ = newUNOP(OP_POSTDEC, 0,
427 mod(scalar($1), OP_POSTDEC)); }
429 { $$ = newUNOP(OP_PREINC, 0,
430 mod(scalar($2), OP_PREINC)); }
432 { $$ = newUNOP(OP_PREDEC, 0,
433 mod(scalar($2), OP_PREDEC)); }
434 | local term %prec UNIOP
435 { $$ = localize($2,$1); }
437 { $$ = sawparens($2); }
439 { $$ = sawparens(newNULLLIST()); }
440 | '[' expr ']' %prec '('
441 { $$ = newANONLIST($2); }
443 { $$ = newANONLIST(Nullop); }
444 | HASHBRACK expr ';' '}' %prec '('
445 { $$ = newANONHASH($2); }
446 | HASHBRACK ';' '}' %prec '('
447 { $$ = newANONHASH(Nullop); }
448 | ANONSUB startanonsub proto block %prec '('
449 { $$ = newANONSUB($2, $3, $4); }
452 | star '{' expr ';' '}'
453 { $$ = newBINOP(OP_GELEM, 0, $1, scalar($3)); }
456 | scalar '[' expr ']' %prec '('
457 { $$ = newBINOP(OP_AELEM, 0, oopsAV($1), scalar($3)); }
458 | term ARROW '[' expr ']' %prec '('
459 { $$ = newBINOP(OP_AELEM, 0,
460 ref(newAVREF($1),OP_RV2AV),
462 | term '[' expr ']' %prec '('
463 { assertref($1); $$ = newBINOP(OP_AELEM, 0,
464 ref(newAVREF($1),OP_RV2AV),
471 { $$ = newUNOP(OP_AV2ARYLEN, 0, ref($1, OP_AV2ARYLEN));}
472 | scalar '{' expr ';' '}' %prec '('
473 { $$ = newBINOP(OP_HELEM, 0, oopsHV($1), jmaybe($3));
474 PL_expect = XOPERATOR; }
475 | term ARROW '{' expr ';' '}' %prec '('
476 { $$ = newBINOP(OP_HELEM, 0,
477 ref(newHVREF($1),OP_RV2HV),
479 PL_expect = XOPERATOR; }
480 | term '{' expr ';' '}' %prec '('
481 { assertref($1); $$ = newBINOP(OP_HELEM, 0,
482 ref(newHVREF($1),OP_RV2HV),
484 PL_expect = XOPERATOR; }
485 | '(' expr ')' '[' expr ']' %prec '('
486 { $$ = newSLICEOP(0, $5, $2); }
487 | '(' ')' '[' expr ']' %prec '('
488 { $$ = newSLICEOP(0, $4, Nullop); }
489 | ary '[' expr ']' %prec '('
490 { $$ = prepend_elem(OP_ASLICE,
491 newOP(OP_PUSHMARK, 0),
492 newLISTOP(OP_ASLICE, 0,
494 ref($1, OP_ASLICE))); }
495 | ary '{' expr ';' '}' %prec '('
496 { $$ = prepend_elem(OP_HSLICE,
497 newOP(OP_PUSHMARK, 0),
498 newLISTOP(OP_HSLICE, 0,
500 ref(oopsHV($1), OP_HSLICE)));
501 PL_expect = XOPERATOR; }
505 { $$ = newUNOP(OP_ENTERSUB, 0, scalar($1)); }
507 { $$ = newUNOP(OP_ENTERSUB, OPf_STACKED, scalar($1)); }
509 { $$ = newUNOP(OP_ENTERSUB, OPf_STACKED,
510 append_elem(OP_LIST, $3, scalar($1))); }
511 | NOAMP WORD listexpr
512 { $$ = newUNOP(OP_ENTERSUB, OPf_STACKED,
513 append_elem(OP_LIST, $3, scalar($2))); }
514 | DO term %prec UNIOP
517 { $$ = newUNOP(OP_NULL, OPf_SPECIAL, scope($2)); }
519 { $$ = newUNOP(OP_ENTERSUB,
520 OPf_SPECIAL|OPf_STACKED,
521 prepend_elem(OP_LIST,
523 (OPpENTERSUB_AMPER<<8),
526 | DO WORD '(' expr ')'
527 { $$ = newUNOP(OP_ENTERSUB,
528 OPf_SPECIAL|OPf_STACKED,
532 (OPpENTERSUB_AMPER<<8),
536 { $$ = newUNOP(OP_ENTERSUB, OPf_SPECIAL|OPf_STACKED,
537 prepend_elem(OP_LIST,
538 scalar(newCVREF(0,scalar($2))), Nullop)); dep();}
539 | DO scalar '(' expr ')'
540 { $$ = newUNOP(OP_ENTERSUB, OPf_SPECIAL|OPf_STACKED,
541 prepend_elem(OP_LIST,
543 scalar(newCVREF(0,scalar($2))))); dep();}
544 | term ARROW '(' ')' %prec '('
545 { $$ = newUNOP(OP_ENTERSUB, OPf_STACKED,
546 newCVREF(0, scalar($1))); }
547 | term ARROW '(' expr ')' %prec '('
548 { $$ = newUNOP(OP_ENTERSUB, OPf_STACKED,
549 append_elem(OP_LIST, $4,
550 newCVREF(0, scalar($1)))); }
552 { $$ = newOP($1, OPf_SPECIAL);
553 PL_hints |= HINT_BLOCK_SCOPE; }
555 { $$ = newLOOPEX($1,$2); }
557 { $$ = newUNOP(OP_NOT, 0, scalar($2)); }
559 { $$ = newOP($1, 0); }
561 { $$ = newUNOP($1, 0, $2); }
563 { $$ = newUNOP($1, 0, $2); }
565 { $$ = newUNOP(OP_ENTERSUB, OPf_STACKED,
566 append_elem(OP_LIST, $2, scalar($1))); }
568 { $$ = newOP($1, 0); }
570 { $$ = newOP($1, 0); }
572 { $$ = newUNOP(OP_ENTERSUB, OPf_STACKED,
575 { $$ = newOP($1, OPf_SPECIAL); }
577 { $$ = newUNOP($1, 0, $3); }
578 | PMFUNC '(' term ')'
579 { $$ = pmruntime($1, $3, Nullop); }
580 | PMFUNC '(' term ',' term ')'
581 { $$ = pmruntime($1, $3, $5); }
592 listexprcom: /* NULL */
600 local : LOCAL { $$ = 0; }
605 { PL_in_my = 0; $$ = my($1); }
609 { $$ = newCVREF($1,$2); }
613 { $$ = newSVREF($2); }
617 { $$ = newAVREF($2); }
621 { $$ = newHVREF($2); }
624 arylen : DOLSHARP indirob
625 { $$ = newAVREF($2); }
629 { $$ = newGVREF(0,$2); }