This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
0eb032d484703e23688126d172c7b655b63fa1fa
[perl5.git] / pp_ctl.c
1 /*    pp_ctl.c
2  *
3  *    Copyright (C) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
4  *    2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 by Larry Wall and others
5  *
6  *    You may distribute under the terms of either the GNU General Public
7  *    License or the Artistic License, as specified in the README file.
8  *
9  */
10
11 /*
12  *      Now far ahead the Road has gone,
13  *          And I must follow, if I can,
14  *      Pursuing it with eager feet,
15  *          Until it joins some larger way
16  *      Where many paths and errands meet.
17  *          And whither then?  I cannot say.
18  *
19  *     [Bilbo on p.35 of _The Lord of the Rings_, I/i: "A Long-Expected Party"]
20  */
21
22 /* This file contains control-oriented pp ("push/pop") functions that
23  * execute the opcodes that make up a perl program. A typical pp function
24  * expects to find its arguments on the stack, and usually pushes its
25  * results onto the stack, hence the 'pp' terminology. Each OP structure
26  * contains a pointer to the relevant pp_foo() function.
27  *
28  * Control-oriented means things like pp_enteriter() and pp_next(), which
29  * alter the flow of control of the program.
30  */
31
32
33 #include "EXTERN.h"
34 #define PERL_IN_PP_CTL_C
35 #include "perl.h"
36
37 #define DOCATCH(o) ((CATCH_GET == TRUE) ? docatch(o) : (o))
38
39 #define dopoptosub(plop)        dopoptosub_at(cxstack, (plop))
40
41 PP(pp_wantarray)
42 {
43     dSP;
44     I32 cxix;
45     const PERL_CONTEXT *cx;
46     EXTEND(SP, 1);
47
48     if (PL_op->op_private & OPpOFFBYONE) {
49         if (!(cx = caller_cx(1,NULL))) RETPUSHUNDEF;
50     }
51     else {
52       cxix = dopoptosub(cxstack_ix);
53       if (cxix < 0)
54         RETPUSHUNDEF;
55       cx = &cxstack[cxix];
56     }
57
58     switch (cx->blk_gimme) {
59     case G_ARRAY:
60         RETPUSHYES;
61     case G_SCALAR:
62         RETPUSHNO;
63     default:
64         RETPUSHUNDEF;
65     }
66 }
67
68 PP(pp_regcreset)
69 {
70     TAINT_NOT;
71     return NORMAL;
72 }
73
74 PP(pp_regcomp)
75 {
76     dSP;
77     PMOP *pm = (PMOP*)cLOGOP->op_other;
78     SV **args;
79     int nargs;
80     REGEXP *re = NULL;
81     REGEXP *new_re;
82     const regexp_engine *eng;
83     bool is_bare_re= FALSE;
84
85     if (PL_op->op_flags & OPf_STACKED) {
86         dMARK;
87         nargs = SP - MARK;
88         args  = ++MARK;
89     }
90     else {
91         nargs = 1;
92         args  = SP;
93     }
94
95     /* prevent recompiling under /o and ithreads. */
96 #if defined(USE_ITHREADS)
97     if (pm->op_pmflags & PMf_KEEP && PM_GETRE(pm)) {
98         SP = args-1;
99         RETURN;
100     }
101 #endif
102
103     re = PM_GETRE(pm);
104     assert (re != (REGEXP*) &PL_sv_undef);
105     eng = re ? RX_ENGINE(re) : current_re_engine();
106
107     new_re = (eng->op_comp
108                     ? eng->op_comp
109                     : &Perl_re_op_compile
110             )(aTHX_ args, nargs, pm->op_code_list, eng, re,
111                 &is_bare_re,
112                 (pm->op_pmflags & RXf_PMf_FLAGCOPYMASK),
113                 pm->op_pmflags |
114                     (PL_op->op_flags & OPf_SPECIAL ? PMf_USE_RE_EVAL : 0));
115
116     if (pm->op_pmflags & PMf_HAS_CV)
117         ReANY(new_re)->qr_anoncv
118                         = (CV*) SvREFCNT_inc(PAD_SV(PL_op->op_targ));
119
120     if (is_bare_re) {
121         REGEXP *tmp;
122         /* The match's LHS's get-magic might need to access this op's regexp
123            (e.g. $' =~ /$re/ while foo; see bug 70764).  So we must call
124            get-magic now before we replace the regexp. Hopefully this hack can
125            be replaced with the approach described at
126            http://www.nntp.perl.org/group/perl.perl5.porters/2007/03/msg122415.html
127            some day. */
128         if (pm->op_type == OP_MATCH) {
129             SV *lhs;
130             const bool was_tainted = TAINT_get;
131             if (pm->op_flags & OPf_STACKED)
132                 lhs = args[-1];
133             else if (pm->op_targ)
134                 lhs = PAD_SV(pm->op_targ);
135             else lhs = DEFSV;
136             SvGETMAGIC(lhs);
137             /* Restore the previous value of PL_tainted (which may have been
138                modified by get-magic), to avoid incorrectly setting the
139                RXf_TAINTED flag with RX_TAINT_on further down. */
140             TAINT_set(was_tainted);
141 #ifdef NO_TAINT_SUPPORT
142             PERL_UNUSED_VAR(was_tainted);
143 #endif
144         }
145         tmp = reg_temp_copy(NULL, new_re);
146         ReREFCNT_dec(new_re);
147         new_re = tmp;
148     }
149
150     if (re != new_re) {
151         ReREFCNT_dec(re);
152         PM_SETRE(pm, new_re);
153     }
154
155
156     assert(TAINTING_get || !TAINT_get);
157     if (TAINT_get) {
158         SvTAINTED_on((SV*)new_re);
159         RX_TAINT_on(new_re);
160     }
161
162 #if !defined(USE_ITHREADS)
163     /* can't change the optree at runtime either */
164     /* PMf_KEEP is handled differently under threads to avoid these problems */
165     /* Handle empty pattern */
166     if (!RX_PRELEN(PM_GETRE(pm)) && PL_curpm) {
167         if (PL_curpm == PL_reg_curpm)
168             Perl_croak(aTHX_ "Use of the empty pattern inside of "
169                   "a regex code block is forbidden");
170         pm = PL_curpm;
171     }
172     if (pm->op_pmflags & PMf_KEEP) {
173         pm->op_private &= ~OPpRUNTIME;  /* no point compiling again */
174         cLOGOP->op_first->op_next = PL_op->op_next;
175     }
176 #endif
177
178     SP = args-1;
179     RETURN;
180 }
181
182
183 PP(pp_substcont)
184 {
185     dSP;
186     PERL_CONTEXT *cx = CX_CUR();
187     PMOP * const pm = (PMOP*) cLOGOP->op_other;
188     SV * const dstr = cx->sb_dstr;
189     char *s = cx->sb_s;
190     char *m = cx->sb_m;
191     char *orig = cx->sb_orig;
192     REGEXP * const rx = cx->sb_rx;
193     SV *nsv = NULL;
194     REGEXP *old = PM_GETRE(pm);
195
196     PERL_ASYNC_CHECK();
197
198     if(old != rx) {
199         if(old)
200             ReREFCNT_dec(old);
201         PM_SETRE(pm,ReREFCNT_inc(rx));
202     }
203
204     rxres_restore(&cx->sb_rxres, rx);
205
206     if (cx->sb_iters++) {
207         const SSize_t saviters = cx->sb_iters;
208         if (cx->sb_iters > cx->sb_maxiters)
209             DIE(aTHX_ "Substitution loop");
210
211         SvGETMAGIC(TOPs); /* possibly clear taint on $1 etc: #67962 */
212
213         /* See "how taint works" above pp_subst() */
214         if (SvTAINTED(TOPs))
215             cx->sb_rxtainted |= SUBST_TAINT_REPL;
216         sv_catsv_nomg(dstr, POPs);
217         if (CxONCE(cx) || s < orig ||
218                 !CALLREGEXEC(rx, s, cx->sb_strend, orig,
219                              (s == m), cx->sb_targ, NULL,
220                     (REXEC_IGNOREPOS|REXEC_NOT_FIRST|REXEC_FAIL_ON_UNDERFLOW)))
221         {
222             SV *targ = cx->sb_targ;
223
224             assert(cx->sb_strend >= s);
225             if(cx->sb_strend > s) {
226                  if (DO_UTF8(dstr) && !SvUTF8(targ))
227                       sv_catpvn_nomg_utf8_upgrade(dstr, s, cx->sb_strend - s, nsv);
228                  else
229                       sv_catpvn_nomg(dstr, s, cx->sb_strend - s);
230             }
231             if (RX_MATCH_TAINTED(rx)) /* run time pattern taint, eg locale */
232                 cx->sb_rxtainted |= SUBST_TAINT_PAT;
233
234             if (pm->op_pmflags & PMf_NONDESTRUCT) {
235                 PUSHs(dstr);
236                 /* From here on down we're using the copy, and leaving the
237                    original untouched.  */
238                 targ = dstr;
239             }
240             else {
241                 SV_CHECK_THINKFIRST_COW_DROP(targ);
242                 if (isGV(targ)) Perl_croak_no_modify();
243                 SvPV_free(targ);
244                 SvPV_set(targ, SvPVX(dstr));
245                 SvCUR_set(targ, SvCUR(dstr));
246                 SvLEN_set(targ, SvLEN(dstr));
247                 if (DO_UTF8(dstr))
248                     SvUTF8_on(targ);
249                 SvPV_set(dstr, NULL);
250
251                 PL_tainted = 0;
252                 mPUSHi(saviters - 1);
253
254                 (void)SvPOK_only_UTF8(targ);
255             }
256
257             /* update the taint state of various various variables in
258              * preparation for final exit.
259              * See "how taint works" above pp_subst() */
260             if (TAINTING_get) {
261                 if ((cx->sb_rxtainted & SUBST_TAINT_PAT) ||
262                     ((cx->sb_rxtainted & (SUBST_TAINT_STR|SUBST_TAINT_RETAINT))
263                                     == (SUBST_TAINT_STR|SUBST_TAINT_RETAINT))
264                 )
265                     (RX_MATCH_TAINTED_on(rx)); /* taint $1 et al */
266
267                 if (!(cx->sb_rxtainted & SUBST_TAINT_BOOLRET)
268                     && (cx->sb_rxtainted & (SUBST_TAINT_STR|SUBST_TAINT_PAT))
269                 )
270                     SvTAINTED_on(TOPs);  /* taint return value */
271                 /* needed for mg_set below */
272                 TAINT_set(
273                     cBOOL(cx->sb_rxtainted &
274                           (SUBST_TAINT_STR|SUBST_TAINT_PAT|SUBST_TAINT_REPL))
275                 );
276                 SvTAINT(TARG);
277             }
278             /* PL_tainted must be correctly set for this mg_set */
279             SvSETMAGIC(TARG);
280             TAINT_NOT;
281
282             CX_LEAVE_SCOPE(cx);
283             CX_POPSUBST(cx);
284             CX_POP(cx);
285
286             PERL_ASYNC_CHECK();
287             RETURNOP(pm->op_next);
288             NOT_REACHED; /* NOTREACHED */
289         }
290         cx->sb_iters = saviters;
291     }
292     if (RX_MATCH_COPIED(rx) && RX_SUBBEG(rx) != orig) {
293         m = s;
294         s = orig;
295         assert(!RX_SUBOFFSET(rx));
296         cx->sb_orig = orig = RX_SUBBEG(rx);
297         s = orig + (m - s);
298         cx->sb_strend = s + (cx->sb_strend - m);
299     }
300     cx->sb_m = m = RX_OFFS(rx)[0].start + orig;
301     if (m > s) {
302         if (DO_UTF8(dstr) && !SvUTF8(cx->sb_targ))
303             sv_catpvn_nomg_utf8_upgrade(dstr, s, m - s, nsv);
304         else
305             sv_catpvn_nomg(dstr, s, m-s);
306     }
307     cx->sb_s = RX_OFFS(rx)[0].end + orig;
308     { /* Update the pos() information. */
309         SV * const sv
310             = (pm->op_pmflags & PMf_NONDESTRUCT) ? cx->sb_dstr : cx->sb_targ;
311         MAGIC *mg;
312
313         /* the string being matched against may no longer be a string,
314          * e.g. $_=0; s/.../$_++/ge */
315
316         if (!SvPOK(sv))
317             SvPV_force_nomg_nolen(sv);
318
319         if (!(mg = mg_find_mglob(sv))) {
320             mg = sv_magicext_mglob(sv);
321         }
322         MgBYTEPOS_set(mg, sv, SvPVX(sv), m - orig);
323     }
324     if (old != rx)
325         (void)ReREFCNT_inc(rx);
326     /* update the taint state of various various variables in preparation
327      * for calling the code block.
328      * See "how taint works" above pp_subst() */
329     if (TAINTING_get) {
330         if (RX_MATCH_TAINTED(rx)) /* run time pattern taint, eg locale */
331             cx->sb_rxtainted |= SUBST_TAINT_PAT;
332
333         if ((cx->sb_rxtainted & SUBST_TAINT_PAT) ||
334             ((cx->sb_rxtainted & (SUBST_TAINT_STR|SUBST_TAINT_RETAINT))
335                             == (SUBST_TAINT_STR|SUBST_TAINT_RETAINT))
336         )
337             (RX_MATCH_TAINTED_on(rx)); /* taint $1 et al */
338
339         if (cx->sb_iters > 1 && (cx->sb_rxtainted & 
340                         (SUBST_TAINT_STR|SUBST_TAINT_PAT|SUBST_TAINT_REPL)))
341             SvTAINTED_on((pm->op_pmflags & PMf_NONDESTRUCT)
342                          ? cx->sb_dstr : cx->sb_targ);
343         TAINT_NOT;
344     }
345     rxres_save(&cx->sb_rxres, rx);
346     PL_curpm = pm;
347     RETURNOP(pm->op_pmstashstartu.op_pmreplstart);
348 }
349
350 void
351 Perl_rxres_save(pTHX_ void **rsp, REGEXP *rx)
352 {
353     UV *p = (UV*)*rsp;
354     U32 i;
355
356     PERL_ARGS_ASSERT_RXRES_SAVE;
357     PERL_UNUSED_CONTEXT;
358
359     if (!p || p[1] < RX_NPARENS(rx)) {
360 #ifdef PERL_ANY_COW
361         i = 7 + (RX_NPARENS(rx)+1) * 2;
362 #else
363         i = 6 + (RX_NPARENS(rx)+1) * 2;
364 #endif
365         if (!p)
366             Newx(p, i, UV);
367         else
368             Renew(p, i, UV);
369         *rsp = (void*)p;
370     }
371
372     /* what (if anything) to free on croak */
373     *p++ = PTR2UV(RX_MATCH_COPIED(rx) ? RX_SUBBEG(rx) : NULL);
374     RX_MATCH_COPIED_off(rx);
375     *p++ = RX_NPARENS(rx);
376
377 #ifdef PERL_ANY_COW
378     *p++ = PTR2UV(RX_SAVED_COPY(rx));
379     RX_SAVED_COPY(rx) = NULL;
380 #endif
381
382     *p++ = PTR2UV(RX_SUBBEG(rx));
383     *p++ = (UV)RX_SUBLEN(rx);
384     *p++ = (UV)RX_SUBOFFSET(rx);
385     *p++ = (UV)RX_SUBCOFFSET(rx);
386     for (i = 0; i <= RX_NPARENS(rx); ++i) {
387         *p++ = (UV)RX_OFFS(rx)[i].start;
388         *p++ = (UV)RX_OFFS(rx)[i].end;
389     }
390 }
391
392 static void
393 S_rxres_restore(pTHX_ void **rsp, REGEXP *rx)
394 {
395     UV *p = (UV*)*rsp;
396     U32 i;
397
398     PERL_ARGS_ASSERT_RXRES_RESTORE;
399     PERL_UNUSED_CONTEXT;
400
401     RX_MATCH_COPY_FREE(rx);
402     RX_MATCH_COPIED_set(rx, *p);
403     *p++ = 0;
404     RX_NPARENS(rx) = *p++;
405
406 #ifdef PERL_ANY_COW
407     if (RX_SAVED_COPY(rx))
408         SvREFCNT_dec (RX_SAVED_COPY(rx));
409     RX_SAVED_COPY(rx) = INT2PTR(SV*,*p);
410     *p++ = 0;
411 #endif
412
413     RX_SUBBEG(rx) = INT2PTR(char*,*p++);
414     RX_SUBLEN(rx) = (I32)(*p++);
415     RX_SUBOFFSET(rx) = (I32)*p++;
416     RX_SUBCOFFSET(rx) = (I32)*p++;
417     for (i = 0; i <= RX_NPARENS(rx); ++i) {
418         RX_OFFS(rx)[i].start = (I32)(*p++);
419         RX_OFFS(rx)[i].end = (I32)(*p++);
420     }
421 }
422
423 static void
424 S_rxres_free(pTHX_ void **rsp)
425 {
426     UV * const p = (UV*)*rsp;
427
428     PERL_ARGS_ASSERT_RXRES_FREE;
429     PERL_UNUSED_CONTEXT;
430
431     if (p) {
432         void *tmp = INT2PTR(char*,*p);
433 #ifdef PERL_POISON
434 #ifdef PERL_ANY_COW
435         U32 i = 9 + p[1] * 2;
436 #else
437         U32 i = 8 + p[1] * 2;
438 #endif
439 #endif
440
441 #ifdef PERL_ANY_COW
442         SvREFCNT_dec (INT2PTR(SV*,p[2]));
443 #endif
444 #ifdef PERL_POISON
445         PoisonFree(p, i, sizeof(UV));
446 #endif
447
448         Safefree(tmp);
449         Safefree(p);
450         *rsp = NULL;
451     }
452 }
453
454 #define FORM_NUM_BLANK (1<<30)
455 #define FORM_NUM_POINT (1<<29)
456
457 PP(pp_formline)
458 {
459     dSP; dMARK; dORIGMARK;
460     SV * const tmpForm = *++MARK;
461     SV *formsv;             /* contains text of original format */
462     U32 *fpc;       /* format ops program counter */
463     char *t;        /* current append position in target string */
464     const char *f;          /* current position in format string */
465     I32 arg;
466     SV *sv = NULL; /* current item */
467     const char *item = NULL;/* string value of current item */
468     I32 itemsize  = 0;      /* length (chars) of item, possibly truncated */
469     I32 itembytes = 0;      /* as itemsize, but length in bytes */
470     I32 fieldsize = 0;      /* width of current field */
471     I32 lines = 0;          /* number of lines that have been output */
472     bool chopspace = (strchr(PL_chopset, ' ') != NULL); /* does $: have space */
473     const char *chophere = NULL; /* where to chop current item */
474     STRLEN linemark = 0;    /* pos of start of line in output */
475     NV value;
476     bool gotsome = FALSE;   /* seen at least one non-blank item on this line */
477     STRLEN len;             /* length of current sv */
478     STRLEN linemax;         /* estimate of output size in bytes */
479     bool item_is_utf8 = FALSE;
480     bool targ_is_utf8 = FALSE;
481     const char *fmt;
482     MAGIC *mg = NULL;
483     U8 *source;             /* source of bytes to append */
484     STRLEN to_copy;         /* how may bytes to append */
485     char trans;             /* what chars to translate */
486
487     mg = doparseform(tmpForm);
488
489     fpc = (U32*)mg->mg_ptr;
490     /* the actual string the format was compiled from.
491      * with overload etc, this may not match tmpForm */
492     formsv = mg->mg_obj;
493
494
495     SvPV_force(PL_formtarget, len);
496     if (SvTAINTED(tmpForm) || SvTAINTED(formsv))
497         SvTAINTED_on(PL_formtarget);
498     if (DO_UTF8(PL_formtarget))
499         targ_is_utf8 = TRUE;
500     linemax = (SvCUR(formsv) * (IN_BYTES ? 1 : 3) + 1);
501     t = SvGROW(PL_formtarget, len + linemax + 1);
502     /* XXX from now onwards, SvCUR(PL_formtarget) is invalid */
503     t += len;
504     f = SvPV_const(formsv, len);
505
506     for (;;) {
507         DEBUG_f( {
508             const char *name = "???";
509             arg = -1;
510             switch (*fpc) {
511             case FF_LITERAL:    arg = fpc[1]; name = "LITERAL"; break;
512             case FF_BLANK:      arg = fpc[1]; name = "BLANK";   break;
513             case FF_SKIP:       arg = fpc[1]; name = "SKIP";    break;
514             case FF_FETCH:      arg = fpc[1]; name = "FETCH";   break;
515             case FF_DECIMAL:    arg = fpc[1]; name = "DECIMAL"; break;
516
517             case FF_CHECKNL:    name = "CHECKNL";       break;
518             case FF_CHECKCHOP:  name = "CHECKCHOP";     break;
519             case FF_SPACE:      name = "SPACE";         break;
520             case FF_HALFSPACE:  name = "HALFSPACE";     break;
521             case FF_ITEM:       name = "ITEM";          break;
522             case FF_CHOP:       name = "CHOP";          break;
523             case FF_LINEGLOB:   name = "LINEGLOB";      break;
524             case FF_NEWLINE:    name = "NEWLINE";       break;
525             case FF_MORE:       name = "MORE";          break;
526             case FF_LINEMARK:   name = "LINEMARK";      break;
527             case FF_END:        name = "END";           break;
528             case FF_0DECIMAL:   name = "0DECIMAL";      break;
529             case FF_LINESNGL:   name = "LINESNGL";      break;
530             }
531             if (arg >= 0)
532                 PerlIO_printf(Perl_debug_log, "%-16s%ld\n", name, (long) arg);
533             else
534                 PerlIO_printf(Perl_debug_log, "%-16s\n", name);
535         } );
536         switch (*fpc++) {
537         case FF_LINEMARK: /* start (or end) of a line */
538             linemark = t - SvPVX(PL_formtarget);
539             lines++;
540             gotsome = FALSE;
541             break;
542
543         case FF_LITERAL: /* append <arg> literal chars */
544             to_copy = *fpc++;
545             source = (U8 *)f;
546             f += to_copy;
547             trans = '~';
548             item_is_utf8 = targ_is_utf8 ? !!DO_UTF8(formsv) : !!SvUTF8(formsv);
549             goto append;
550
551         case FF_SKIP: /* skip <arg> chars in format */
552             f += *fpc++;
553             break;
554
555         case FF_FETCH: /* get next item and set field size to <arg> */
556             arg = *fpc++;
557             f += arg;
558             fieldsize = arg;
559
560             if (MARK < SP)
561                 sv = *++MARK;
562             else {
563                 sv = &PL_sv_no;
564                 Perl_ck_warner(aTHX_ packWARN(WARN_SYNTAX), "Not enough format arguments");
565             }
566             if (SvTAINTED(sv))
567                 SvTAINTED_on(PL_formtarget);
568             break;
569
570         case FF_CHECKNL: /* find max len of item (up to \n) that fits field */
571             {
572                 const char *s = item = SvPV_const(sv, len);
573                 const char *send = s + len;
574
575                 itemsize = 0;
576                 item_is_utf8 = DO_UTF8(sv);
577                 while (s < send) {
578                     if (!isCNTRL(*s))
579                         gotsome = TRUE;
580                     else if (*s == '\n')
581                         break;
582
583                     if (item_is_utf8)
584                         s += UTF8SKIP(s);
585                     else
586                         s++;
587                     itemsize++;
588                     if (itemsize == fieldsize)
589                         break;
590                 }
591                 itembytes = s - item;
592                 chophere = s;
593                 break;
594             }
595
596         case FF_CHECKCHOP: /* like CHECKNL, but up to highest split point */
597             {
598                 const char *s = item = SvPV_const(sv, len);
599                 const char *send = s + len;
600                 I32 size = 0;
601
602                 chophere = NULL;
603                 item_is_utf8 = DO_UTF8(sv);
604                 while (s < send) {
605                     /* look for a legal split position */
606                     if (isSPACE(*s)) {
607                         if (*s == '\r') {
608                             chophere = s;
609                             itemsize = size;
610                             break;
611                         }
612                         if (chopspace) {
613                             /* provisional split point */
614                             chophere = s;
615                             itemsize = size;
616                         }
617                         /* we delay testing fieldsize until after we've
618                          * processed the possible split char directly
619                          * following the last field char; so if fieldsize=3
620                          * and item="a b cdef", we consume "a b", not "a".
621                          * Ditto further down.
622                          */
623                         if (size == fieldsize)
624                             break;
625                     }
626                     else {
627                         if (strchr(PL_chopset, *s)) {
628                             /* provisional split point */
629                             /* for a non-space split char, we include
630                              * the split char; hence the '+1' */
631                             chophere = s + 1;
632                             itemsize = size;
633                         }
634                         if (size == fieldsize)
635                             break;
636                         if (!isCNTRL(*s))
637                             gotsome = TRUE;
638                     }
639
640                     if (item_is_utf8)
641                         s += UTF8SKIP(s);
642                     else
643                         s++;
644                     size++;
645                 }
646                 if (!chophere || s == send) {
647                     chophere = s;
648                     itemsize = size;
649                 }
650                 itembytes = chophere - item;
651
652                 break;
653             }
654
655         case FF_SPACE: /* append padding space (diff of field, item size) */
656             arg = fieldsize - itemsize;
657             if (arg) {
658                 fieldsize -= arg;
659                 while (arg-- > 0)
660                     *t++ = ' ';
661             }
662             break;
663
664         case FF_HALFSPACE: /* like FF_SPACE, but only append half as many */
665             arg = fieldsize - itemsize;
666             if (arg) {
667                 arg /= 2;
668                 fieldsize -= arg;
669                 while (arg-- > 0)
670                     *t++ = ' ';
671             }
672             break;
673
674         case FF_ITEM: /* append a text item, while blanking ctrl chars */
675             to_copy = itembytes;
676             source = (U8 *)item;
677             trans = 1;
678             goto append;
679
680         case FF_CHOP: /* (for ^*) chop the current item */
681             if (sv != &PL_sv_no) {
682                 const char *s = chophere;
683                 if (chopspace) {
684                     while (isSPACE(*s))
685                         s++;
686                 }
687                 if (SvPOKp(sv))
688                     sv_chop(sv,s);
689                 else
690                     /* tied, overloaded or similar strangeness.
691                      * Do it the hard way */
692                     sv_setpvn(sv, s, len - (s-item));
693                 SvSETMAGIC(sv);
694                 break;
695             }
696
697         case FF_LINESNGL: /* process ^*  */
698             chopspace = 0;
699             /* FALLTHROUGH */
700
701         case FF_LINEGLOB: /* process @*  */
702             {
703                 const bool oneline = fpc[-1] == FF_LINESNGL;
704                 const char *s = item = SvPV_const(sv, len);
705                 const char *const send = s + len;
706
707                 item_is_utf8 = DO_UTF8(sv);
708                 chophere = s + len;
709                 if (!len)
710                     break;
711                 trans = 0;
712                 gotsome = TRUE;
713                 source = (U8 *) s;
714                 to_copy = len;
715                 while (s < send) {
716                     if (*s++ == '\n') {
717                         if (oneline) {
718                             to_copy = s - item - 1;
719                             chophere = s;
720                             break;
721                         } else {
722                             if (s == send) {
723                                 to_copy--;
724                             } else
725                                 lines++;
726                         }
727                     }
728                 }
729             }
730
731         append:
732             /* append to_copy bytes from source to PL_formstring.
733              * item_is_utf8 implies source is utf8.
734              * if trans, translate certain characters during the copy */
735             {
736                 U8 *tmp = NULL;
737                 STRLEN grow = 0;
738
739                 SvCUR_set(PL_formtarget,
740                           t - SvPVX_const(PL_formtarget));
741
742                 if (targ_is_utf8 && !item_is_utf8) {
743                     source = tmp = bytes_to_utf8(source, &to_copy);
744                 } else {
745                     if (item_is_utf8 && !targ_is_utf8) {
746                         U8 *s;
747                         /* Upgrade targ to UTF8, and then we reduce it to
748                            a problem we have a simple solution for.
749                            Don't need get magic.  */
750                         sv_utf8_upgrade_nomg(PL_formtarget);
751                         targ_is_utf8 = TRUE;
752                         /* re-calculate linemark */
753                         s = (U8*)SvPVX(PL_formtarget);
754                         /* the bytes we initially allocated to append the
755                          * whole line may have been gobbled up during the
756                          * upgrade, so allocate a whole new line's worth
757                          * for safety */
758                         grow = linemax;
759                         while (linemark--)
760                             s += UTF8SKIP(s);
761                         linemark = s - (U8*)SvPVX(PL_formtarget);
762                     }
763                     /* Easy. They agree.  */
764                     assert (item_is_utf8 == targ_is_utf8);
765                 }
766                 if (!trans)
767                     /* @* and ^* are the only things that can exceed
768                      * the linemax, so grow by the output size, plus
769                      * a whole new form's worth in case of any further
770                      * output */
771                     grow = linemax + to_copy;
772                 if (grow)
773                     SvGROW(PL_formtarget, SvCUR(PL_formtarget) + grow + 1);
774                 t = SvPVX(PL_formtarget) + SvCUR(PL_formtarget);
775
776                 Copy(source, t, to_copy, char);
777                 if (trans) {
778                     /* blank out ~ or control chars, depending on trans.
779                      * works on bytes not chars, so relies on not
780                      * matching utf8 continuation bytes */
781                     U8 *s = (U8*)t;
782                     U8 *send = s + to_copy;
783                     while (s < send) {
784                         const int ch = *s;
785                         if (trans == '~' ? (ch == '~') : isCNTRL(ch))
786                             *s = ' ';
787                         s++;
788                     }
789                 }
790
791                 t += to_copy;
792                 SvCUR_set(PL_formtarget, SvCUR(PL_formtarget) + to_copy);
793                 if (tmp)
794                     Safefree(tmp);
795                 break;
796             }
797
798         case FF_0DECIMAL: /* like FF_DECIMAL but for 0### */
799             arg = *fpc++;
800             fmt = (const char *)
801                 ((arg & FORM_NUM_POINT) ? "%#0*.*" NVff : "%0*.*" NVff);
802             goto ff_dec;
803
804         case FF_DECIMAL: /* do @##, ^##, where <arg>=(precision|flags) */
805             arg = *fpc++;
806             fmt = (const char *)
807                 ((arg & FORM_NUM_POINT) ? "%#*.*" NVff : "%*.*" NVff);
808         ff_dec:
809             /* If the field is marked with ^ and the value is undefined,
810                blank it out. */
811             if ((arg & FORM_NUM_BLANK) && !SvOK(sv)) {
812                 arg = fieldsize;
813                 while (arg--)
814                     *t++ = ' ';
815                 break;
816             }
817             gotsome = TRUE;
818             value = SvNV(sv);
819             /* overflow evidence */
820             if (num_overflow(value, fieldsize, arg)) {
821                 arg = fieldsize;
822                 while (arg--)
823                     *t++ = '#';
824                 break;
825             }
826             /* Formats aren't yet marked for locales, so assume "yes". */
827             {
828                 Size_t max = SvLEN(PL_formtarget) - (t - SvPVX(PL_formtarget));
829                 int len;
830                 DECLARATION_FOR_LC_NUMERIC_MANIPULATION;
831                 STORE_LC_NUMERIC_SET_TO_NEEDED();
832                 arg &= ~(FORM_NUM_POINT|FORM_NUM_BLANK);
833 #ifdef USE_QUADMATH
834                 {
835                     const char* qfmt = quadmath_format_single(fmt);
836                     int len;
837                     if (!qfmt)
838                         Perl_croak_nocontext("panic: quadmath invalid format \"%s\"", fmt);
839                     len = quadmath_snprintf(t, max, qfmt, (int) fieldsize, (int) arg, value);
840                     if (len == -1)
841                         Perl_croak_nocontext("panic: quadmath_snprintf failed, format \"%s\"", qfmt);
842                     if (qfmt != fmt)
843                         Safefree(fmt);
844                 }
845 #else
846                 /* we generate fmt ourselves so it is safe */
847                 GCC_DIAG_IGNORE(-Wformat-nonliteral);
848                 len = my_snprintf(t, max, fmt, (int) fieldsize, (int) arg, value);
849                 GCC_DIAG_RESTORE;
850 #endif
851                 PERL_MY_SNPRINTF_POST_GUARD(len, max);
852                 RESTORE_LC_NUMERIC();
853             }
854             t += fieldsize;
855             break;
856
857         case FF_NEWLINE: /* delete trailing spaces, then append \n */
858             f++;
859             while (t-- > (SvPVX(PL_formtarget) + linemark) && *t == ' ') ;
860             t++;
861             *t++ = '\n';
862             break;
863
864         case FF_BLANK: /* for arg==0: do '~'; for arg>0 : do '~~' */
865             arg = *fpc++;
866             if (gotsome) {
867                 if (arg) {              /* repeat until fields exhausted? */
868                     fpc--;
869                     goto end;
870                 }
871             }
872             else {
873                 t = SvPVX(PL_formtarget) + linemark;
874                 lines--;
875             }
876             break;
877
878         case FF_MORE: /* replace long end of string with '...' */
879             {
880                 const char *s = chophere;
881                 const char *send = item + len;
882                 if (chopspace) {
883                     while (isSPACE(*s) && (s < send))
884                         s++;
885                 }
886                 if (s < send) {
887                     char *s1;
888                     arg = fieldsize - itemsize;
889                     if (arg) {
890                         fieldsize -= arg;
891                         while (arg-- > 0)
892                             *t++ = ' ';
893                     }
894                     s1 = t - 3;
895                     if (strnEQ(s1,"   ",3)) {
896                         while (s1 > SvPVX_const(PL_formtarget) && isSPACE(s1[-1]))
897                             s1--;
898                     }
899                     *s1++ = '.';
900                     *s1++ = '.';
901                     *s1++ = '.';
902                 }
903                 break;
904             }
905
906         case FF_END: /* tidy up, then return */
907         end:
908             assert(t < SvPVX_const(PL_formtarget) + SvLEN(PL_formtarget));
909             *t = '\0';
910             SvCUR_set(PL_formtarget, t - SvPVX_const(PL_formtarget));
911             if (targ_is_utf8)
912                 SvUTF8_on(PL_formtarget);
913             FmLINES(PL_formtarget) += lines;
914             SP = ORIGMARK;
915             if (fpc[-1] == FF_BLANK)
916                 RETURNOP(cLISTOP->op_first);
917             else
918                 RETPUSHYES;
919         }
920     }
921 }
922
923 /* also used for: pp_mapstart() */
924 PP(pp_grepstart)
925 {
926     dSP;
927     SV *src;
928
929     if (PL_stack_base + TOPMARK == SP) {
930         (void)POPMARK;
931         if (GIMME_V == G_SCALAR)
932             mXPUSHi(0);
933         RETURNOP(PL_op->op_next->op_next);
934     }
935     PL_stack_sp = PL_stack_base + TOPMARK + 1;
936     Perl_pp_pushmark(aTHX);                             /* push dst */
937     Perl_pp_pushmark(aTHX);                             /* push src */
938     ENTER_with_name("grep");                                    /* enter outer scope */
939
940     SAVETMPS;
941     SAVE_DEFSV;
942     ENTER_with_name("grep_item");                                       /* enter inner scope */
943     SAVEVPTR(PL_curpm);
944
945     src = PL_stack_base[TOPMARK];
946     if (SvPADTMP(src)) {
947         src = PL_stack_base[TOPMARK] = sv_mortalcopy(src);
948         PL_tmps_floor++;
949     }
950     SvTEMP_off(src);
951     DEFSV_set(src);
952
953     PUTBACK;
954     if (PL_op->op_type == OP_MAPSTART)
955         Perl_pp_pushmark(aTHX);                 /* push top */
956     return ((LOGOP*)PL_op->op_next)->op_other;
957 }
958
959 PP(pp_mapwhile)
960 {
961     dSP;
962     const U8 gimme = GIMME_V;
963     I32 items = (SP - PL_stack_base) - TOPMARK; /* how many new items */
964     I32 count;
965     I32 shift;
966     SV** src;
967     SV** dst;
968
969     /* first, move source pointer to the next item in the source list */
970     ++PL_markstack_ptr[-1];
971
972     /* if there are new items, push them into the destination list */
973     if (items && gimme != G_VOID) {
974         /* might need to make room back there first */
975         if (items > PL_markstack_ptr[-1] - PL_markstack_ptr[-2]) {
976             /* XXX this implementation is very pessimal because the stack
977              * is repeatedly extended for every set of items.  Is possible
978              * to do this without any stack extension or copying at all
979              * by maintaining a separate list over which the map iterates
980              * (like foreach does). --gsar */
981
982             /* everything in the stack after the destination list moves
983              * towards the end the stack by the amount of room needed */
984             shift = items - (PL_markstack_ptr[-1] - PL_markstack_ptr[-2]);
985
986             /* items to shift up (accounting for the moved source pointer) */
987             count = (SP - PL_stack_base) - (PL_markstack_ptr[-1] - 1);
988
989             /* This optimization is by Ben Tilly and it does
990              * things differently from what Sarathy (gsar)
991              * is describing.  The downside of this optimization is
992              * that leaves "holes" (uninitialized and hopefully unused areas)
993              * to the Perl stack, but on the other hand this
994              * shouldn't be a problem.  If Sarathy's idea gets
995              * implemented, this optimization should become
996              * irrelevant.  --jhi */
997             if (shift < count)
998                 shift = count; /* Avoid shifting too often --Ben Tilly */
999
1000             EXTEND(SP,shift);
1001             src = SP;
1002             dst = (SP += shift);
1003             PL_markstack_ptr[-1] += shift;
1004             *PL_markstack_ptr += shift;
1005             while (count--)
1006                 *dst-- = *src--;
1007         }
1008         /* copy the new items down to the destination list */
1009         dst = PL_stack_base + (PL_markstack_ptr[-2] += items) - 1;
1010         if (gimme == G_ARRAY) {
1011             /* add returned items to the collection (making mortal copies
1012              * if necessary), then clear the current temps stack frame
1013              * *except* for those items. We do this splicing the items
1014              * into the start of the tmps frame (so some items may be on
1015              * the tmps stack twice), then moving PL_tmps_floor above
1016              * them, then freeing the frame. That way, the only tmps that
1017              * accumulate over iterations are the return values for map.
1018              * We have to do to this way so that everything gets correctly
1019              * freed if we die during the map.
1020              */
1021             I32 tmpsbase;
1022             I32 i = items;
1023             /* make space for the slice */
1024             EXTEND_MORTAL(items);
1025             tmpsbase = PL_tmps_floor + 1;
1026             Move(PL_tmps_stack + tmpsbase,
1027                  PL_tmps_stack + tmpsbase + items,
1028                  PL_tmps_ix - PL_tmps_floor,
1029                  SV*);
1030             PL_tmps_ix += items;
1031
1032             while (i-- > 0) {
1033                 SV *sv = POPs;
1034                 if (!SvTEMP(sv))
1035                     sv = sv_mortalcopy(sv);
1036                 *dst-- = sv;
1037                 PL_tmps_stack[tmpsbase++] = SvREFCNT_inc_simple(sv);
1038             }
1039             /* clear the stack frame except for the items */
1040             PL_tmps_floor += items;
1041             FREETMPS;
1042             /* FREETMPS may have cleared the TEMP flag on some of the items */
1043             i = items;
1044             while (i-- > 0)
1045                 SvTEMP_on(PL_tmps_stack[--tmpsbase]);
1046         }
1047         else {
1048             /* scalar context: we don't care about which values map returns
1049              * (we use undef here). And so we certainly don't want to do mortal
1050              * copies of meaningless values. */
1051             while (items-- > 0) {
1052                 (void)POPs;
1053                 *dst-- = &PL_sv_undef;
1054             }
1055             FREETMPS;
1056         }
1057     }
1058     else {
1059         FREETMPS;
1060     }
1061     LEAVE_with_name("grep_item");                                       /* exit inner scope */
1062
1063     /* All done yet? */
1064     if (PL_markstack_ptr[-1] > TOPMARK) {
1065
1066         (void)POPMARK;                          /* pop top */
1067         LEAVE_with_name("grep");                                        /* exit outer scope */
1068         (void)POPMARK;                          /* pop src */
1069         items = --*PL_markstack_ptr - PL_markstack_ptr[-1];
1070         (void)POPMARK;                          /* pop dst */
1071         SP = PL_stack_base + POPMARK;           /* pop original mark */
1072         if (gimme == G_SCALAR) {
1073                 dTARGET;
1074                 XPUSHi(items);
1075         }
1076         else if (gimme == G_ARRAY)
1077             SP += items;
1078         RETURN;
1079     }
1080     else {
1081         SV *src;
1082
1083         ENTER_with_name("grep_item");                                   /* enter inner scope */
1084         SAVEVPTR(PL_curpm);
1085
1086         /* set $_ to the new source item */
1087         src = PL_stack_base[PL_markstack_ptr[-1]];
1088         if (SvPADTMP(src)) {
1089             src = sv_mortalcopy(src);
1090         }
1091         SvTEMP_off(src);
1092         DEFSV_set(src);
1093
1094         RETURNOP(cLOGOP->op_other);
1095     }
1096 }
1097
1098 /* Range stuff. */
1099
1100 PP(pp_range)
1101 {
1102     if (GIMME_V == G_ARRAY)
1103         return NORMAL;
1104     if (SvTRUEx(PAD_SV(PL_op->op_targ)))
1105         return cLOGOP->op_other;
1106     else
1107         return NORMAL;
1108 }
1109
1110 PP(pp_flip)
1111 {
1112     dSP;
1113
1114     if (GIMME_V == G_ARRAY) {
1115         RETURNOP(((LOGOP*)cUNOP->op_first)->op_other);
1116     }
1117     else {
1118         dTOPss;
1119         SV * const targ = PAD_SV(PL_op->op_targ);
1120         int flip = 0;
1121
1122         if (PL_op->op_private & OPpFLIP_LINENUM) {
1123             if (GvIO(PL_last_in_gv)) {
1124                 flip = SvIV(sv) == (IV)IoLINES(GvIOp(PL_last_in_gv));
1125             }
1126             else {
1127                 GV * const gv = gv_fetchpvs(".", GV_ADD|GV_NOTQUAL, SVt_PV);
1128                 if (gv && GvSV(gv))
1129                     flip = SvIV(sv) == SvIV(GvSV(gv));
1130             }
1131         } else {
1132             flip = SvTRUE(sv);
1133         }
1134         if (flip) {
1135             sv_setiv(PAD_SV(cUNOP->op_first->op_targ), 1);
1136             if (PL_op->op_flags & OPf_SPECIAL) {
1137                 sv_setiv(targ, 1);
1138                 SETs(targ);
1139                 RETURN;
1140             }
1141             else {
1142                 sv_setiv(targ, 0);
1143                 SP--;
1144                 RETURNOP(((LOGOP*)cUNOP->op_first)->op_other);
1145             }
1146         }
1147         SvPVCLEAR(TARG);
1148         SETs(targ);
1149         RETURN;
1150     }
1151 }
1152
1153 /* This code tries to decide if "$left .. $right" should use the
1154    magical string increment, or if the range is numeric (we make
1155    an exception for .."0" [#18165]). AMS 20021031. */
1156
1157 #define RANGE_IS_NUMERIC(left,right) ( \
1158         SvNIOKp(left)  || (SvOK(left)  && !SvPOKp(left))  || \
1159         SvNIOKp(right) || (SvOK(right) && !SvPOKp(right)) || \
1160         (((!SvOK(left) && SvOK(right)) || ((!SvOK(left) || \
1161           looks_like_number(left)) && SvPOKp(left) && *SvPVX_const(left) != '0')) \
1162          && (!SvOK(right) || looks_like_number(right))))
1163
1164 PP(pp_flop)
1165 {
1166     dSP;
1167
1168     if (GIMME_V == G_ARRAY) {
1169         dPOPPOPssrl;
1170
1171         SvGETMAGIC(left);
1172         SvGETMAGIC(right);
1173
1174         if (RANGE_IS_NUMERIC(left,right)) {
1175             IV i, j, n;
1176             if ((SvOK(left) && !SvIOK(left) && SvNV_nomg(left) < IV_MIN) ||
1177                 (SvOK(right) && (SvIOK(right)
1178                                  ? SvIsUV(right) && SvUV(right) > IV_MAX
1179                                  : SvNV_nomg(right) > IV_MAX)))
1180                 DIE(aTHX_ "Range iterator outside integer range");
1181             i = SvIV_nomg(left);
1182             j = SvIV_nomg(right);
1183             if (j >= i) {
1184                 /* Dance carefully around signed max. */
1185                 bool overflow = (i <= 0 && j > SSize_t_MAX + i - 1);
1186                 if (!overflow) {
1187                     n = j - i + 1;
1188                     /* The wraparound of signed integers is undefined
1189                      * behavior, but here we aim for count >=1, and
1190                      * negative count is just wrong. */
1191                     if (n < 1
1192 #if IVSIZE > Size_t_size
1193                         || n > SSize_t_MAX
1194 #endif
1195                         )
1196                         overflow = TRUE;
1197                 }
1198                 if (overflow)
1199                     Perl_croak(aTHX_ "Out of memory during list extend");
1200                 EXTEND_MORTAL(n);
1201                 EXTEND(SP, n);
1202             }
1203             else
1204                 n = 0;
1205             while (n--) {
1206                 SV * const sv = sv_2mortal(newSViv(i));
1207                 PUSHs(sv);
1208                 if (n) /* avoid incrementing above IV_MAX */
1209                     i++;
1210             }
1211         }
1212         else {
1213             STRLEN len, llen;
1214             const char * const lpv = SvPV_nomg_const(left, llen);
1215             const char * const tmps = SvPV_nomg_const(right, len);
1216
1217             SV *sv = newSVpvn_flags(lpv, llen, SvUTF8(left)|SVs_TEMP);
1218             while (!SvNIOKp(sv) && SvCUR(sv) <= len) {
1219                 XPUSHs(sv);
1220                 if (strEQ(SvPVX_const(sv),tmps))
1221                     break;
1222                 sv = sv_2mortal(newSVsv(sv));
1223                 sv_inc(sv);
1224             }
1225         }
1226     }
1227     else {
1228         dTOPss;
1229         SV * const targ = PAD_SV(cUNOP->op_first->op_targ);
1230         int flop = 0;
1231         sv_inc(targ);
1232
1233         if (PL_op->op_private & OPpFLIP_LINENUM) {
1234             if (GvIO(PL_last_in_gv)) {
1235                 flop = SvIV(sv) == (IV)IoLINES(GvIOp(PL_last_in_gv));
1236             }
1237             else {
1238                 GV * const gv = gv_fetchpvs(".", GV_ADD|GV_NOTQUAL, SVt_PV);
1239                 if (gv && GvSV(gv)) flop = SvIV(sv) == SvIV(GvSV(gv));
1240             }
1241         }
1242         else {
1243             flop = SvTRUE(sv);
1244         }
1245
1246         if (flop) {
1247             sv_setiv(PAD_SV(((UNOP*)cUNOP->op_first)->op_first->op_targ), 0);
1248             sv_catpvs(targ, "E0");
1249         }
1250         SETs(targ);
1251     }
1252
1253     RETURN;
1254 }
1255
1256 /* Control. */
1257
1258 static const char * const context_name[] = {
1259     "pseudo-block",
1260     NULL, /* CXt_WHEN never actually needs "block" */
1261     NULL, /* CXt_BLOCK never actually needs "block" */
1262     NULL, /* CXt_GIVEN never actually needs "block" */
1263     NULL, /* CXt_LOOP_PLAIN never actually needs "loop" */
1264     NULL, /* CXt_LOOP_LAZYIV never actually needs "loop" */
1265     NULL, /* CXt_LOOP_LAZYSV never actually needs "loop" */
1266     NULL, /* CXt_LOOP_LIST never actually needs "loop" */
1267     NULL, /* CXt_LOOP_ARY never actually needs "loop" */
1268     "subroutine",
1269     "format",
1270     "eval",
1271     "substitution",
1272 };
1273
1274 STATIC I32
1275 S_dopoptolabel(pTHX_ const char *label, STRLEN len, U32 flags)
1276 {
1277     I32 i;
1278
1279     PERL_ARGS_ASSERT_DOPOPTOLABEL;
1280
1281     for (i = cxstack_ix; i >= 0; i--) {
1282         const PERL_CONTEXT * const cx = &cxstack[i];
1283         switch (CxTYPE(cx)) {
1284         case CXt_SUBST:
1285         case CXt_SUB:
1286         case CXt_FORMAT:
1287         case CXt_EVAL:
1288         case CXt_NULL:
1289             /* diag_listed_as: Exiting subroutine via %s */
1290             Perl_ck_warner(aTHX_ packWARN(WARN_EXITING), "Exiting %s via %s",
1291                            context_name[CxTYPE(cx)], OP_NAME(PL_op));
1292             if (CxTYPE(cx) == CXt_NULL) /* sort BLOCK */
1293                 return -1;
1294             break;
1295         case CXt_LOOP_PLAIN:
1296         case CXt_LOOP_LAZYIV:
1297         case CXt_LOOP_LAZYSV:
1298         case CXt_LOOP_LIST:
1299         case CXt_LOOP_ARY:
1300           {
1301             STRLEN cx_label_len = 0;
1302             U32 cx_label_flags = 0;
1303             const char *cx_label = CxLABEL_len_flags(cx, &cx_label_len, &cx_label_flags);
1304             if (!cx_label || !(
1305                     ( (cx_label_flags & SVf_UTF8) != (flags & SVf_UTF8) ) ?
1306                         (flags & SVf_UTF8)
1307                             ? (bytes_cmp_utf8(
1308                                         (const U8*)cx_label, cx_label_len,
1309                                         (const U8*)label, len) == 0)
1310                             : (bytes_cmp_utf8(
1311                                         (const U8*)label, len,
1312                                         (const U8*)cx_label, cx_label_len) == 0)
1313                     : (len == cx_label_len && ((cx_label == label)
1314                                     || memEQ(cx_label, label, len))) )) {
1315                 DEBUG_l(Perl_deb(aTHX_ "(poptolabel(): skipping label at cx=%ld %s)\n",
1316                         (long)i, cx_label));
1317                 continue;
1318             }
1319             DEBUG_l( Perl_deb(aTHX_ "(poptolabel(): found label at cx=%ld %s)\n", (long)i, label));
1320             return i;
1321           }
1322         }
1323     }
1324     return i;
1325 }
1326
1327
1328
1329 U8
1330 Perl_dowantarray(pTHX)
1331 {
1332     const U8 gimme = block_gimme();
1333     return (gimme == G_VOID) ? G_SCALAR : gimme;
1334 }
1335
1336 U8
1337 Perl_block_gimme(pTHX)
1338 {
1339     const I32 cxix = dopoptosub(cxstack_ix);
1340     U8 gimme;
1341     if (cxix < 0)
1342         return G_VOID;
1343
1344     gimme = (cxstack[cxix].blk_gimme & G_WANT);
1345     if (!gimme)
1346         Perl_croak(aTHX_ "panic: bad gimme: %d\n", gimme);
1347     return gimme;
1348 }
1349
1350
1351 I32
1352 Perl_is_lvalue_sub(pTHX)
1353 {
1354     const I32 cxix = dopoptosub(cxstack_ix);
1355     assert(cxix >= 0);  /* We should only be called from inside subs */
1356
1357     if (CxLVAL(cxstack + cxix) && CvLVALUE(cxstack[cxix].blk_sub.cv))
1358         return CxLVAL(cxstack + cxix);
1359     else
1360         return 0;
1361 }
1362
1363 /* only used by cx_pushsub() */
1364 I32
1365 Perl_was_lvalue_sub(pTHX)
1366 {
1367     const I32 cxix = dopoptosub(cxstack_ix-1);
1368     assert(cxix >= 0);  /* We should only be called from inside subs */
1369
1370     if (CxLVAL(cxstack + cxix) && CvLVALUE(cxstack[cxix].blk_sub.cv))
1371         return CxLVAL(cxstack + cxix);
1372     else
1373         return 0;
1374 }
1375
1376 STATIC I32
1377 S_dopoptosub_at(pTHX_ const PERL_CONTEXT *cxstk, I32 startingblock)
1378 {
1379     I32 i;
1380
1381     PERL_ARGS_ASSERT_DOPOPTOSUB_AT;
1382 #ifndef DEBUGGING
1383     PERL_UNUSED_CONTEXT;
1384 #endif
1385
1386     for (i = startingblock; i >= 0; i--) {
1387         const PERL_CONTEXT * const cx = &cxstk[i];
1388         switch (CxTYPE(cx)) {
1389         default:
1390             continue;
1391         case CXt_SUB:
1392             /* in sub foo { /(?{...})/ }, foo ends up on the CX stack
1393              * twice; the first for the normal foo() call, and the second
1394              * for a faked up re-entry into the sub to execute the
1395              * code block. Hide this faked entry from the world. */
1396             if (cx->cx_type & CXp_SUB_RE_FAKE)
1397                 continue;
1398             /* FALLTHROUGH */
1399         case CXt_EVAL:
1400         case CXt_FORMAT:
1401             DEBUG_l( Perl_deb(aTHX_ "(dopoptosub_at(): found sub at cx=%ld)\n", (long)i));
1402             return i;
1403         }
1404     }
1405     return i;
1406 }
1407
1408 STATIC I32
1409 S_dopoptoeval(pTHX_ I32 startingblock)
1410 {
1411     I32 i;
1412     for (i = startingblock; i >= 0; i--) {
1413         const PERL_CONTEXT *cx = &cxstack[i];
1414         switch (CxTYPE(cx)) {
1415         default:
1416             continue;
1417         case CXt_EVAL:
1418             DEBUG_l( Perl_deb(aTHX_ "(dopoptoeval(): found eval at cx=%ld)\n", (long)i));
1419             return i;
1420         }
1421     }
1422     return i;
1423 }
1424
1425 STATIC I32
1426 S_dopoptoloop(pTHX_ I32 startingblock)
1427 {
1428     I32 i;
1429     for (i = startingblock; i >= 0; i--) {
1430         const PERL_CONTEXT * const cx = &cxstack[i];
1431         switch (CxTYPE(cx)) {
1432         case CXt_SUBST:
1433         case CXt_SUB:
1434         case CXt_FORMAT:
1435         case CXt_EVAL:
1436         case CXt_NULL:
1437             /* diag_listed_as: Exiting subroutine via %s */
1438             Perl_ck_warner(aTHX_ packWARN(WARN_EXITING), "Exiting %s via %s",
1439                            context_name[CxTYPE(cx)], OP_NAME(PL_op));
1440             if ((CxTYPE(cx)) == CXt_NULL) /* sort BLOCK */
1441                 return -1;
1442             break;
1443         case CXt_LOOP_PLAIN:
1444         case CXt_LOOP_LAZYIV:
1445         case CXt_LOOP_LAZYSV:
1446         case CXt_LOOP_LIST:
1447         case CXt_LOOP_ARY:
1448             DEBUG_l( Perl_deb(aTHX_ "(dopoptoloop(): found loop at cx=%ld)\n", (long)i));
1449             return i;
1450         }
1451     }
1452     return i;
1453 }
1454
1455 /* find the next GIVEN or FOR (with implicit $_) loop context block */
1456
1457 STATIC I32
1458 S_dopoptogivenfor(pTHX_ I32 startingblock)
1459 {
1460     I32 i;
1461     for (i = startingblock; i >= 0; i--) {
1462         const PERL_CONTEXT *cx = &cxstack[i];
1463         switch (CxTYPE(cx)) {
1464         default:
1465             continue;
1466         case CXt_GIVEN:
1467             DEBUG_l( Perl_deb(aTHX_ "(dopoptogivenfor(): found given at cx=%ld)\n", (long)i));
1468             return i;
1469         case CXt_LOOP_PLAIN:
1470             assert(!(cx->cx_type & CXp_FOR_DEF));
1471             break;
1472         case CXt_LOOP_LAZYIV:
1473         case CXt_LOOP_LAZYSV:
1474         case CXt_LOOP_LIST:
1475         case CXt_LOOP_ARY:
1476             if (cx->cx_type & CXp_FOR_DEF) {
1477                 DEBUG_l( Perl_deb(aTHX_ "(dopoptogivenfor(): found foreach at cx=%ld)\n", (long)i));
1478                 return i;
1479             }
1480         }
1481     }
1482     return i;
1483 }
1484
1485 STATIC I32
1486 S_dopoptowhen(pTHX_ I32 startingblock)
1487 {
1488     I32 i;
1489     for (i = startingblock; i >= 0; i--) {
1490         const PERL_CONTEXT *cx = &cxstack[i];
1491         switch (CxTYPE(cx)) {
1492         default:
1493             continue;
1494         case CXt_WHEN:
1495             DEBUG_l( Perl_deb(aTHX_ "(dopoptowhen(): found when at cx=%ld)\n", (long)i));
1496             return i;
1497         }
1498     }
1499     return i;
1500 }
1501
1502 /* dounwind(): pop all contexts above (but not including) cxix.
1503  * Note that it clears the savestack frame associated with each popped
1504  * context entry, but doesn't free any temps.
1505  * It does a cx_popblock() of the last frame that it pops, and leaves
1506  * cxstack_ix equal to cxix.
1507  */
1508
1509 void
1510 Perl_dounwind(pTHX_ I32 cxix)
1511 {
1512     if (!PL_curstackinfo) /* can happen if die during thread cloning */
1513         return;
1514
1515     while (cxstack_ix > cxix) {
1516         PERL_CONTEXT *cx = CX_CUR();
1517
1518         CX_DEBUG(cx, "UNWIND");
1519         /* Note: we don't need to restore the base context info till the end. */
1520
1521         CX_LEAVE_SCOPE(cx);
1522
1523         switch (CxTYPE(cx)) {
1524         case CXt_SUBST:
1525             CX_POPSUBST(cx);
1526             break;
1527         case CXt_SUB:
1528             cx_popsub(cx);
1529             break;
1530         case CXt_EVAL:
1531             cx_popeval(cx);
1532             break;
1533         case CXt_LOOP_PLAIN:
1534         case CXt_LOOP_LAZYIV:
1535         case CXt_LOOP_LAZYSV:
1536         case CXt_LOOP_LIST:
1537         case CXt_LOOP_ARY:
1538             cx_poploop(cx);
1539             break;
1540         case CXt_WHEN:
1541             cx_popwhen(cx);
1542             break;
1543         case CXt_GIVEN:
1544             cx_popgiven(cx);
1545             break;
1546         case CXt_BLOCK:
1547         case CXt_NULL:
1548             /* these two don't have a POPFOO() */
1549             break;
1550         case CXt_FORMAT:
1551             cx_popformat(cx);
1552             break;
1553         }
1554         if (cxstack_ix == cxix + 1) {
1555             cx_popblock(cx);
1556         }
1557         cxstack_ix--;
1558     }
1559
1560 }
1561
1562 void
1563 Perl_qerror(pTHX_ SV *err)
1564 {
1565     PERL_ARGS_ASSERT_QERROR;
1566
1567     if (PL_in_eval) {
1568         if (PL_in_eval & EVAL_KEEPERR) {
1569                 Perl_ck_warner(aTHX_ packWARN(WARN_MISC), "\t(in cleanup) %"SVf,
1570                                                     SVfARG(err));
1571         }
1572         else
1573             sv_catsv(ERRSV, err);
1574     }
1575     else if (PL_errors)
1576         sv_catsv(PL_errors, err);
1577     else
1578         Perl_warn(aTHX_ "%"SVf, SVfARG(err));
1579     if (PL_parser)
1580         ++PL_parser->error_count;
1581 }
1582
1583
1584
1585 /* pop a CXt_EVAL context and in addition, if it was a require then
1586  * based on action:
1587  *     0: do nothing extra;
1588  *     1: undef  $INC{$name}; croak "$name did not return a true value";
1589  *     2: delete $INC{$name}; croak "$errsv: Compilation failed in require"
1590  */
1591
1592 static void
1593 S_pop_eval_context_maybe_croak(pTHX_ PERL_CONTEXT *cx, SV *errsv, int action)
1594 {
1595     SV  *namesv = NULL; /* init to avoid dumb compiler warning */
1596     bool do_croak;
1597
1598     CX_LEAVE_SCOPE(cx);
1599     do_croak = action && (CxOLD_OP_TYPE(cx) == OP_REQUIRE);
1600     if (do_croak) {
1601         /* keep namesv alive after cx_popeval() */
1602         namesv = cx->blk_eval.old_namesv;
1603         cx->blk_eval.old_namesv = NULL;
1604         sv_2mortal(namesv);
1605     }
1606     cx_popeval(cx);
1607     cx_popblock(cx);
1608     CX_POP(cx);
1609
1610     if (do_croak) {
1611         const char *fmt;
1612         HV *inc_hv = GvHVn(PL_incgv);
1613         I32  klen  = SvUTF8(namesv) ? -(I32)SvCUR(namesv) : (I32)SvCUR(namesv);
1614         const char *key = SvPVX_const(namesv);
1615
1616         if (action == 1) {
1617             (void)hv_delete(inc_hv, key, klen, G_DISCARD);
1618             fmt = "%"SVf" did not return a true value";
1619             errsv = namesv;
1620         }
1621         else {
1622             (void)hv_store(inc_hv, key, klen, &PL_sv_undef, 0);
1623             fmt = "%"SVf"Compilation failed in require";
1624             if (!errsv)
1625                 errsv = newSVpvs_flags("Unknown error\n", SVs_TEMP);
1626         }
1627
1628         Perl_croak(aTHX_ fmt, SVfARG(errsv));
1629     }
1630 }
1631
1632
1633 /* die_unwind(): this is the final destination for the various croak()
1634  * functions. If we're in an eval, unwind the context and other stacks
1635  * back to the top-most CXt_EVAL and set $@ to msv; otherwise print msv
1636  * to STDERR and initiate an exit. Note that if the CXt_EVAL popped back
1637  * to is a require the exception will be rethrown, as requires don't
1638  * actually trap exceptions.
1639  */
1640
1641 void
1642 Perl_die_unwind(pTHX_ SV *msv)
1643 {
1644     SV *exceptsv = msv;
1645     U8 in_eval = PL_in_eval;
1646     PERL_ARGS_ASSERT_DIE_UNWIND;
1647
1648     if (in_eval) {
1649         I32 cxix;
1650
1651         exceptsv = sv_2mortal(SvREFCNT_inc_simple_NN(exceptsv));
1652
1653         /*
1654          * Historically, perl used to set ERRSV ($@) early in the die
1655          * process and rely on it not getting clobbered during unwinding.
1656          * That sucked, because it was liable to get clobbered, so the
1657          * setting of ERRSV used to emit the exception from eval{} has
1658          * been moved to much later, after unwinding (see just before
1659          * JMPENV_JUMP below).  However, some modules were relying on the
1660          * early setting, by examining $@ during unwinding to use it as
1661          * a flag indicating whether the current unwinding was caused by
1662          * an exception.  It was never a reliable flag for that purpose,
1663          * being totally open to false positives even without actual
1664          * clobberage, but was useful enough for production code to
1665          * semantically rely on it.
1666          *
1667          * We'd like to have a proper introspective interface that
1668          * explicitly describes the reason for whatever unwinding
1669          * operations are currently in progress, so that those modules
1670          * work reliably and $@ isn't further overloaded.  But we don't
1671          * have one yet.  In its absence, as a stopgap measure, ERRSV is
1672          * now *additionally* set here, before unwinding, to serve as the
1673          * (unreliable) flag that it used to.
1674          *
1675          * This behaviour is temporary, and should be removed when a
1676          * proper way to detect exceptional unwinding has been developed.
1677          * As of 2010-12, the authors of modules relying on the hack
1678          * are aware of the issue, because the modules failed on
1679          * perls 5.13.{1..7} which had late setting of $@ without this
1680          * early-setting hack.
1681          */
1682         if (!(in_eval & EVAL_KEEPERR))
1683             sv_setsv_flags(ERRSV, exceptsv,
1684                         (SV_GMAGIC|SV_DO_COW_SVSETSV|SV_NOSTEAL));
1685
1686         if (in_eval & EVAL_KEEPERR) {
1687             Perl_ck_warner(aTHX_ packWARN(WARN_MISC), "\t(in cleanup) %"SVf,
1688                            SVfARG(exceptsv));
1689         }
1690
1691         while ((cxix = dopoptoeval(cxstack_ix)) < 0
1692                && PL_curstackinfo->si_prev)
1693         {
1694             dounwind(-1);
1695             POPSTACK;
1696         }
1697
1698         if (cxix >= 0) {
1699             PERL_CONTEXT *cx;
1700             SV **oldsp;
1701             U8 gimme;
1702             JMPENV *restartjmpenv;
1703             OP *restartop;
1704
1705             if (cxix < cxstack_ix)
1706                 dounwind(cxix);
1707
1708             cx = CX_CUR();
1709             assert(CxTYPE(cx) == CXt_EVAL);
1710
1711             /* return false to the caller of eval */
1712             oldsp = PL_stack_base + cx->blk_oldsp;
1713             gimme = cx->blk_gimme;
1714             if (gimme == G_SCALAR)
1715                 *++oldsp = &PL_sv_undef;
1716             PL_stack_sp = oldsp;
1717
1718             restartjmpenv = cx->blk_eval.cur_top_env;
1719             restartop     = cx->blk_eval.retop;
1720             /* Note that unlike pp_entereval, pp_require isn't supposed to
1721              * trap errors. So if we're a require, after we pop the
1722              * CXt_EVAL that pp_require pushed, rethrow the error with
1723              * croak(exceptsv). This is all handled by the call below when
1724              * action == 2.
1725              */
1726             S_pop_eval_context_maybe_croak(aTHX_ cx, exceptsv, 2);
1727
1728             if (!(in_eval & EVAL_KEEPERR))
1729                 sv_setsv(ERRSV, exceptsv);
1730             PL_restartjmpenv = restartjmpenv;
1731             PL_restartop = restartop;
1732             JMPENV_JUMP(3);
1733             NOT_REACHED; /* NOTREACHED */
1734         }
1735     }
1736
1737     write_to_stderr(exceptsv);
1738     my_failure_exit();
1739     NOT_REACHED; /* NOTREACHED */
1740 }
1741
1742 PP(pp_xor)
1743 {
1744     dSP; dPOPTOPssrl;
1745     if (SvTRUE(left) != SvTRUE(right))
1746         RETSETYES;
1747     else
1748         RETSETNO;
1749 }
1750
1751 /*
1752
1753 =head1 CV Manipulation Functions
1754
1755 =for apidoc caller_cx
1756
1757 The XSUB-writer's equivalent of L<caller()|perlfunc/caller>.  The
1758 returned C<PERL_CONTEXT> structure can be interrogated to find all the
1759 information returned to Perl by C<caller>.  Note that XSUBs don't get a
1760 stack frame, so C<caller_cx(0, NULL)> will return information for the
1761 immediately-surrounding Perl code.
1762
1763 This function skips over the automatic calls to C<&DB::sub> made on the
1764 behalf of the debugger.  If the stack frame requested was a sub called by
1765 C<DB::sub>, the return value will be the frame for the call to
1766 C<DB::sub>, since that has the correct line number/etc. for the call
1767 site.  If I<dbcxp> is non-C<NULL>, it will be set to a pointer to the
1768 frame for the sub call itself.
1769
1770 =cut
1771 */
1772
1773 const PERL_CONTEXT *
1774 Perl_caller_cx(pTHX_ I32 count, const PERL_CONTEXT **dbcxp)
1775 {
1776     I32 cxix = dopoptosub(cxstack_ix);
1777     const PERL_CONTEXT *cx;
1778     const PERL_CONTEXT *ccstack = cxstack;
1779     const PERL_SI *top_si = PL_curstackinfo;
1780
1781     for (;;) {
1782         /* we may be in a higher stacklevel, so dig down deeper */
1783         while (cxix < 0 && top_si->si_type != PERLSI_MAIN) {
1784             top_si = top_si->si_prev;
1785             ccstack = top_si->si_cxstack;
1786             cxix = dopoptosub_at(ccstack, top_si->si_cxix);
1787         }
1788         if (cxix < 0)
1789             return NULL;
1790         /* caller() should not report the automatic calls to &DB::sub */
1791         if (PL_DBsub && GvCV(PL_DBsub) && cxix >= 0 &&
1792                 ccstack[cxix].blk_sub.cv == GvCV(PL_DBsub))
1793             count++;
1794         if (!count--)
1795             break;
1796         cxix = dopoptosub_at(ccstack, cxix - 1);
1797     }
1798
1799     cx = &ccstack[cxix];
1800     if (dbcxp) *dbcxp = cx;
1801
1802     if (CxTYPE(cx) == CXt_SUB || CxTYPE(cx) == CXt_FORMAT) {
1803         const I32 dbcxix = dopoptosub_at(ccstack, cxix - 1);
1804         /* We expect that ccstack[dbcxix] is CXt_SUB, anyway, the
1805            field below is defined for any cx. */
1806         /* caller() should not report the automatic calls to &DB::sub */
1807         if (PL_DBsub && GvCV(PL_DBsub) && dbcxix >= 0 && ccstack[dbcxix].blk_sub.cv == GvCV(PL_DBsub))
1808             cx = &ccstack[dbcxix];
1809     }
1810
1811     return cx;
1812 }
1813
1814 PP(pp_caller)
1815 {
1816     dSP;
1817     const PERL_CONTEXT *cx;
1818     const PERL_CONTEXT *dbcx;
1819     U8 gimme = GIMME_V;
1820     const HEK *stash_hek;
1821     I32 count = 0;
1822     bool has_arg = MAXARG && TOPs;
1823     const COP *lcop;
1824
1825     if (MAXARG) {
1826       if (has_arg)
1827         count = POPi;
1828       else (void)POPs;
1829     }
1830
1831     cx = caller_cx(count + !!(PL_op->op_private & OPpOFFBYONE), &dbcx);
1832     if (!cx) {
1833         if (gimme != G_ARRAY) {
1834             EXTEND(SP, 1);
1835             RETPUSHUNDEF;
1836         }
1837         RETURN;
1838     }
1839
1840     CX_DEBUG(cx, "CALLER");
1841     assert(CopSTASH(cx->blk_oldcop));
1842     stash_hek = SvTYPE(CopSTASH(cx->blk_oldcop)) == SVt_PVHV
1843       ? HvNAME_HEK((HV*)CopSTASH(cx->blk_oldcop))
1844       : NULL;
1845     if (gimme != G_ARRAY) {
1846         EXTEND(SP, 1);
1847         if (!stash_hek)
1848             PUSHs(&PL_sv_undef);
1849         else {
1850             dTARGET;
1851             sv_sethek(TARG, stash_hek);
1852             PUSHs(TARG);
1853         }
1854         RETURN;
1855     }
1856
1857     EXTEND(SP, 11);
1858
1859     if (!stash_hek)
1860         PUSHs(&PL_sv_undef);
1861     else {
1862         dTARGET;
1863         sv_sethek(TARG, stash_hek);
1864         PUSHTARG;
1865     }
1866     mPUSHs(newSVpv(OutCopFILE(cx->blk_oldcop), 0));
1867     lcop = closest_cop(cx->blk_oldcop, OpSIBLING(cx->blk_oldcop),
1868                        cx->blk_sub.retop, TRUE);
1869     if (!lcop)
1870         lcop = cx->blk_oldcop;
1871     mPUSHu(CopLINE(lcop));
1872     if (!has_arg)
1873         RETURN;
1874     if (CxTYPE(cx) == CXt_SUB || CxTYPE(cx) == CXt_FORMAT) {
1875         /* So is ccstack[dbcxix]. */
1876         if (CvHASGV(dbcx->blk_sub.cv)) {
1877             PUSHs(cv_name(dbcx->blk_sub.cv, 0, 0));
1878             PUSHs(boolSV(CxHASARGS(cx)));
1879         }
1880         else {
1881             PUSHs(newSVpvs_flags("(unknown)", SVs_TEMP));
1882             PUSHs(boolSV(CxHASARGS(cx)));
1883         }
1884     }
1885     else {
1886         PUSHs(newSVpvs_flags("(eval)", SVs_TEMP));
1887         mPUSHi(0);
1888     }
1889     gimme = cx->blk_gimme;
1890     if (gimme == G_VOID)
1891         PUSHs(&PL_sv_undef);
1892     else
1893         PUSHs(boolSV((gimme & G_WANT) == G_ARRAY));
1894     if (CxTYPE(cx) == CXt_EVAL) {
1895         /* eval STRING */
1896         if (CxOLD_OP_TYPE(cx) == OP_ENTEREVAL) {
1897             SV *cur_text = cx->blk_eval.cur_text;
1898             if (SvCUR(cur_text) >= 2) {
1899                 PUSHs(newSVpvn_flags(SvPVX(cur_text), SvCUR(cur_text)-2,
1900                                      SvUTF8(cur_text)|SVs_TEMP));
1901             }
1902             else {
1903                 /* I think this is will always be "", but be sure */
1904                 PUSHs(sv_2mortal(newSVsv(cur_text)));
1905             }
1906
1907             PUSHs(&PL_sv_no);
1908         }
1909         /* require */
1910         else if (cx->blk_eval.old_namesv) {
1911             mPUSHs(newSVsv(cx->blk_eval.old_namesv));
1912             PUSHs(&PL_sv_yes);
1913         }
1914         /* eval BLOCK (try blocks have old_namesv == 0) */
1915         else {
1916             PUSHs(&PL_sv_undef);
1917             PUSHs(&PL_sv_undef);
1918         }
1919     }
1920     else {
1921         PUSHs(&PL_sv_undef);
1922         PUSHs(&PL_sv_undef);
1923     }
1924     if (CxTYPE(cx) == CXt_SUB && CxHASARGS(cx)
1925         && CopSTASH_eq(PL_curcop, PL_debstash))
1926     {
1927         /* slot 0 of the pad contains the original @_ */
1928         AV * const ary = MUTABLE_AV(AvARRAY(MUTABLE_AV(
1929                             PadlistARRAY(CvPADLIST(cx->blk_sub.cv))[
1930                                 cx->blk_sub.olddepth+1]))[0]);
1931         const SSize_t off = AvARRAY(ary) - AvALLOC(ary);
1932
1933         Perl_init_dbargs(aTHX);
1934
1935         if (AvMAX(PL_dbargs) < AvFILLp(ary) + off)
1936             av_extend(PL_dbargs, AvFILLp(ary) + off);
1937         Copy(AvALLOC(ary), AvARRAY(PL_dbargs), AvFILLp(ary) + 1 + off, SV*);
1938         AvFILLp(PL_dbargs) = AvFILLp(ary) + off;
1939     }
1940     mPUSHi(CopHINTS_get(cx->blk_oldcop));
1941     {
1942         SV * mask ;
1943         STRLEN * const old_warnings = cx->blk_oldcop->cop_warnings ;
1944
1945         if  (old_warnings == pWARN_NONE)
1946             mask = newSVpvn(WARN_NONEstring, WARNsize) ;
1947         else if (old_warnings == pWARN_STD && (PL_dowarn & G_WARN_ON) == 0)
1948             mask = &PL_sv_undef ;
1949         else if (old_warnings == pWARN_ALL ||
1950                   (old_warnings == pWARN_STD && PL_dowarn & G_WARN_ON)) {
1951             /* Get the bit mask for $warnings::Bits{all}, because
1952              * it could have been extended by warnings::register */
1953             SV **bits_all;
1954             HV * const bits = get_hv("warnings::Bits", 0);
1955             if (bits && (bits_all=hv_fetchs(bits, "all", FALSE))) {
1956                 mask = newSVsv(*bits_all);
1957             }
1958             else {
1959                 mask = newSVpvn(WARN_ALLstring, WARNsize) ;
1960             }
1961         }
1962         else
1963             mask = newSVpvn((char *) (old_warnings + 1), old_warnings[0]);
1964         mPUSHs(mask);
1965     }
1966
1967     PUSHs(cx->blk_oldcop->cop_hints_hash ?
1968           sv_2mortal(newRV_noinc(MUTABLE_SV(cop_hints_2hv(cx->blk_oldcop, 0))))
1969           : &PL_sv_undef);
1970     RETURN;
1971 }
1972
1973 PP(pp_reset)
1974 {
1975     dSP;
1976     const char * tmps;
1977     STRLEN len = 0;
1978     if (MAXARG < 1 || (!TOPs && !POPs))
1979         tmps = NULL, len = 0;
1980     else
1981         tmps = SvPVx_const(POPs, len);
1982     sv_resetpvn(tmps, len, CopSTASH(PL_curcop));
1983     PUSHs(&PL_sv_yes);
1984     RETURN;
1985 }
1986
1987 /* like pp_nextstate, but used instead when the debugger is active */
1988
1989 PP(pp_dbstate)
1990 {
1991     PL_curcop = (COP*)PL_op;
1992     TAINT_NOT;          /* Each statement is presumed innocent */
1993     PL_stack_sp = PL_stack_base + CX_CUR()->blk_oldsp;
1994     FREETMPS;
1995
1996     PERL_ASYNC_CHECK();
1997
1998     if (PL_op->op_flags & OPf_SPECIAL /* breakpoint */
1999             || PL_DBsingle_iv || PL_DBsignal_iv || PL_DBtrace_iv)
2000     {
2001         dSP;
2002         PERL_CONTEXT *cx;
2003         const U8 gimme = G_ARRAY;
2004         GV * const gv = PL_DBgv;
2005         CV * cv = NULL;
2006
2007         if (gv && isGV_with_GP(gv))
2008             cv = GvCV(gv);
2009
2010         if (!cv || (!CvROOT(cv) && !CvXSUB(cv)))
2011             DIE(aTHX_ "No DB::DB routine defined");
2012
2013         if (CvDEPTH(cv) >= 1 && !(PL_debug & DEBUG_DB_RECURSE_FLAG))
2014             /* don't do recursive DB::DB call */
2015             return NORMAL;
2016
2017         if (CvISXSUB(cv)) {
2018             ENTER;
2019             SAVEI32(PL_debug);
2020             PL_debug = 0;
2021             SAVESTACK_POS();
2022             SAVETMPS;
2023             PUSHMARK(SP);
2024             (void)(*CvXSUB(cv))(aTHX_ cv);
2025             FREETMPS;
2026             LEAVE;
2027             return NORMAL;
2028         }
2029         else {
2030             cx = cx_pushblock(CXt_SUB, gimme, SP, PL_savestack_ix);
2031             cx_pushsub(cx, cv, PL_op->op_next, 0);
2032             /* OP_DBSTATE's op_private holds hint bits rather than
2033              * the lvalue-ish flags seen in OP_ENTERSUB. So cancel
2034              * any CxLVAL() flags that have now been mis-calculated */
2035             cx->blk_u16 = 0;
2036
2037             SAVEI32(PL_debug);
2038             PL_debug = 0;
2039             SAVESTACK_POS();
2040             CvDEPTH(cv)++;
2041             if (CvDEPTH(cv) >= 2)
2042                 pad_push(CvPADLIST(cv), CvDEPTH(cv));
2043             PAD_SET_CUR_NOSAVE(CvPADLIST(cv), CvDEPTH(cv));
2044             RETURNOP(CvSTART(cv));
2045         }
2046     }
2047     else
2048         return NORMAL;
2049 }
2050
2051
2052 PP(pp_enter)
2053 {
2054     U8 gimme = GIMME_V;
2055
2056     (void)cx_pushblock(CXt_BLOCK, gimme, PL_stack_sp, PL_savestack_ix);
2057     return NORMAL;
2058 }
2059
2060
2061 PP(pp_leave)
2062 {
2063     PERL_CONTEXT *cx;
2064     SV **oldsp;
2065     U8 gimme;
2066
2067     cx = CX_CUR();
2068     assert(CxTYPE(cx) == CXt_BLOCK);
2069
2070     if (PL_op->op_flags & OPf_SPECIAL)
2071         /* fake block should preserve $1 et al; e.g.  /(...)/ while ...; */
2072         cx->blk_oldpm = PL_curpm;
2073
2074     oldsp = PL_stack_base + cx->blk_oldsp;
2075     gimme = cx->blk_gimme;
2076
2077     if (gimme == G_VOID)
2078         PL_stack_sp = oldsp;
2079     else
2080         leave_adjust_stacks(oldsp, oldsp, gimme,
2081                                 PL_op->op_private & OPpLVALUE ? 3 : 1);
2082
2083     CX_LEAVE_SCOPE(cx);
2084     cx_popblock(cx);
2085     CX_POP(cx);
2086
2087     return NORMAL;
2088 }
2089
2090 static bool
2091 S_outside_integer(pTHX_ SV *sv)
2092 {
2093   if (SvOK(sv)) {
2094     const NV nv = SvNV_nomg(sv);
2095     if (Perl_isinfnan(nv))
2096       return TRUE;
2097 #ifdef NV_PRESERVES_UV
2098     if (nv < (NV)IV_MIN || nv > (NV)IV_MAX)
2099       return TRUE;
2100 #else
2101     if (nv <= (NV)IV_MIN)
2102       return TRUE;
2103     if ((nv > 0) &&
2104         ((nv > (NV)UV_MAX ||
2105           SvUV_nomg(sv) > (UV)IV_MAX)))
2106       return TRUE;
2107 #endif
2108   }
2109   return FALSE;
2110 }
2111
2112 PP(pp_enteriter)
2113 {
2114     dSP; dMARK;
2115     PERL_CONTEXT *cx;
2116     const U8 gimme = GIMME_V;
2117     void *itervarp; /* GV or pad slot of the iteration variable */
2118     SV   *itersave; /* the old var in the iterator var slot */
2119     U8 cxflags = 0;
2120
2121     if (PL_op->op_targ) {                        /* "my" variable */
2122         itervarp = &PAD_SVl(PL_op->op_targ);
2123         itersave = *(SV**)itervarp;
2124         assert(itersave);
2125         if (PL_op->op_private & OPpLVAL_INTRO) {        /* for my $x (...) */
2126             /* the SV currently in the pad slot is never live during
2127              * iteration (the slot is always aliased to one of the items)
2128              * so it's always stale */
2129             SvPADSTALE_on(itersave);
2130         }
2131         SvREFCNT_inc_simple_void_NN(itersave);
2132         cxflags = CXp_FOR_PAD;
2133     }
2134     else {
2135         SV * const sv = POPs;
2136         itervarp = (void *)sv;
2137         if (LIKELY(isGV(sv))) {         /* symbol table variable */
2138             itersave = GvSV(sv);
2139             SvREFCNT_inc_simple_void(itersave);
2140             cxflags = CXp_FOR_GV;
2141             if (PL_op->op_private & OPpITER_DEF)
2142                 cxflags |= CXp_FOR_DEF;
2143         }
2144         else {                          /* LV ref: for \$foo (...) */
2145             assert(SvTYPE(sv) == SVt_PVMG);
2146             assert(SvMAGIC(sv));
2147             assert(SvMAGIC(sv)->mg_type == PERL_MAGIC_lvref);
2148             itersave = NULL;
2149             cxflags = CXp_FOR_LVREF;
2150         }
2151     }
2152     /* OPpITER_DEF (implicit $_) should only occur with a GV iter var */
2153     assert((cxflags & CXp_FOR_GV) || !(PL_op->op_private & OPpITER_DEF));
2154
2155     /* Note that this context is initially set as CXt_NULL. Further on
2156      * down it's changed to one of the CXt_LOOP_*. Before it's changed,
2157      * there mustn't be anything in the blk_loop substruct that requires
2158      * freeing or undoing, in case we die in the meantime. And vice-versa.
2159      */
2160     cx = cx_pushblock(cxflags, gimme, MARK, PL_savestack_ix);
2161     cx_pushloop_for(cx, itervarp, itersave);
2162
2163     if (PL_op->op_flags & OPf_STACKED) {
2164         /* OPf_STACKED implies either a single array: for(@), with a
2165          * single AV on the stack, or a range: for (1..5), with 1 and 5 on
2166          * the stack */
2167         SV *maybe_ary = POPs;
2168         if (SvTYPE(maybe_ary) != SVt_PVAV) {
2169             /* range */
2170             dPOPss;
2171             SV * const right = maybe_ary;
2172             if (UNLIKELY(cxflags & CXp_FOR_LVREF))
2173                 DIE(aTHX_ "Assigned value is not a reference");
2174             SvGETMAGIC(sv);
2175             SvGETMAGIC(right);
2176             if (RANGE_IS_NUMERIC(sv,right)) {
2177                 cx->cx_type |= CXt_LOOP_LAZYIV;
2178                 if (S_outside_integer(aTHX_ sv) ||
2179                     S_outside_integer(aTHX_ right))
2180                     DIE(aTHX_ "Range iterator outside integer range");
2181                 cx->blk_loop.state_u.lazyiv.cur = SvIV_nomg(sv);
2182                 cx->blk_loop.state_u.lazyiv.end = SvIV_nomg(right);
2183             }
2184             else {
2185                 cx->cx_type |= CXt_LOOP_LAZYSV;
2186                 cx->blk_loop.state_u.lazysv.cur = newSVsv(sv);
2187                 cx->blk_loop.state_u.lazysv.end = right;
2188                 SvREFCNT_inc_simple_void_NN(right);
2189                 (void) SvPV_force_nolen(cx->blk_loop.state_u.lazysv.cur);
2190                 /* This will do the upgrade to SVt_PV, and warn if the value
2191                    is uninitialised.  */
2192                 (void) SvPV_nolen_const(right);
2193                 /* Doing this avoids a check every time in pp_iter in pp_hot.c
2194                    to replace !SvOK() with a pointer to "".  */
2195                 if (!SvOK(right)) {
2196                     SvREFCNT_dec(right);
2197                     cx->blk_loop.state_u.lazysv.end = &PL_sv_no;
2198                 }
2199             }
2200         }
2201         else /* SvTYPE(maybe_ary) == SVt_PVAV */ {
2202             /* for (@array) {} */
2203             cx->cx_type |= CXt_LOOP_ARY;
2204             cx->blk_loop.state_u.ary.ary = MUTABLE_AV(maybe_ary);
2205             SvREFCNT_inc_simple_void_NN(maybe_ary);
2206             cx->blk_loop.state_u.ary.ix =
2207                 (PL_op->op_private & OPpITER_REVERSED) ?
2208                 AvFILL(cx->blk_loop.state_u.ary.ary) + 1 :
2209                 -1;
2210         }
2211         /* EXTEND(SP, 1) not needed in this branch because we just did POPs */
2212     }
2213     else { /* iterating over items on the stack */
2214         cx->cx_type |= CXt_LOOP_LIST;
2215         cx->blk_oldsp = SP - PL_stack_base;
2216         cx->blk_loop.state_u.stack.basesp = MARK - PL_stack_base;
2217         cx->blk_loop.state_u.stack.ix =
2218             (PL_op->op_private & OPpITER_REVERSED)
2219                 ? cx->blk_oldsp + 1
2220                 : cx->blk_loop.state_u.stack.basesp;
2221         /* pre-extend stack so pp_iter doesn't have to check every time
2222          * it pushes yes/no */
2223         EXTEND(SP, 1);
2224     }
2225
2226     RETURN;
2227 }
2228
2229 PP(pp_enterloop)
2230 {
2231     PERL_CONTEXT *cx;
2232     const U8 gimme = GIMME_V;
2233
2234     cx = cx_pushblock(CXt_LOOP_PLAIN, gimme, PL_stack_sp, PL_savestack_ix);
2235     cx_pushloop_plain(cx);
2236     return NORMAL;
2237 }
2238
2239
2240 PP(pp_leaveloop)
2241 {
2242     PERL_CONTEXT *cx;
2243     U8 gimme;
2244     SV **base;
2245     SV **oldsp;
2246
2247     cx = CX_CUR();
2248     assert(CxTYPE_is_LOOP(cx));
2249     oldsp = PL_stack_base + cx->blk_oldsp;
2250     base = CxTYPE(cx) == CXt_LOOP_LIST
2251                 ? PL_stack_base + cx->blk_loop.state_u.stack.basesp
2252                 : oldsp;
2253     gimme = cx->blk_gimme;
2254
2255     if (gimme == G_VOID)
2256         PL_stack_sp = base;
2257     else
2258         leave_adjust_stacks(oldsp, base, gimme,
2259                                 PL_op->op_private & OPpLVALUE ? 3 : 1);
2260
2261     CX_LEAVE_SCOPE(cx);
2262     cx_poploop(cx);     /* Stack values are safe: release loop vars ... */
2263     cx_popblock(cx);
2264     CX_POP(cx);
2265
2266     return NORMAL;
2267 }
2268
2269
2270 /* This duplicates most of pp_leavesub, but with additional code to handle
2271  * return args in lvalue context. It was forked from pp_leavesub to
2272  * avoid slowing down that function any further.
2273  *
2274  * Any changes made to this function may need to be copied to pp_leavesub
2275  * and vice-versa.
2276  *
2277  * also tail-called by pp_return
2278  */
2279
2280 PP(pp_leavesublv)
2281 {
2282     U8 gimme;
2283     PERL_CONTEXT *cx;
2284     SV **oldsp;
2285     OP *retop;
2286
2287     cx = CX_CUR();
2288     assert(CxTYPE(cx) == CXt_SUB);
2289
2290     if (CxMULTICALL(cx)) {
2291         /* entry zero of a stack is always PL_sv_undef, which
2292          * simplifies converting a '()' return into undef in scalar context */
2293         assert(PL_stack_sp > PL_stack_base || *PL_stack_base == &PL_sv_undef);
2294         return 0;
2295     }
2296
2297     gimme = cx->blk_gimme;
2298     oldsp = PL_stack_base + cx->blk_oldsp; /* last arg of previous frame */
2299
2300     if (gimme == G_VOID)
2301         PL_stack_sp = oldsp;
2302     else {
2303         U8   lval    = CxLVAL(cx);
2304         bool is_lval = (lval && !(lval & OPpENTERSUB_INARGS));
2305         const char *what = NULL;
2306
2307         if (gimme == G_SCALAR) {
2308             if (is_lval) {
2309                 /* check for bad return arg */
2310                 if (oldsp < PL_stack_sp) {
2311                     SV *sv = *PL_stack_sp;
2312                     if ((SvPADTMP(sv) || SvREADONLY(sv))) {
2313                         what =
2314                             SvREADONLY(sv) ? (sv == &PL_sv_undef) ? "undef"
2315                             : "a readonly value" : "a temporary";
2316                     }
2317                     else goto ok;
2318                 }
2319                 else {
2320                     /* sub:lvalue{} will take us here. */
2321                     what = "undef";
2322                 }
2323               croak:
2324                 Perl_croak(aTHX_
2325                           "Can't return %s from lvalue subroutine", what);
2326             }
2327
2328           ok:
2329             leave_adjust_stacks(oldsp, oldsp, gimme, is_lval ? 3 : 2);
2330
2331             if (lval & OPpDEREF) {
2332                 /* lval_sub()->{...} and similar */
2333                 dSP;
2334                 SvGETMAGIC(TOPs);
2335                 if (!SvOK(TOPs)) {
2336                     TOPs = vivify_ref(TOPs, CxLVAL(cx) & OPpDEREF);
2337                 }
2338                 PUTBACK;
2339             }
2340         }
2341         else {
2342             assert(gimme == G_ARRAY);
2343             assert (!(lval & OPpDEREF));
2344
2345             if (is_lval) {
2346                 /* scan for bad return args */
2347                 SV **p;
2348                 for (p = PL_stack_sp; p > oldsp; p--) {
2349                     SV *sv = *p;
2350                     /* the PL_sv_undef exception is to allow things like
2351                      * this to work, where PL_sv_undef acts as 'skip'
2352                      * placeholder on the LHS of list assigns:
2353                      *    sub foo :lvalue { undef }
2354                      *    ($a, undef, foo(), $b) = 1..4;
2355                      */
2356                     if (sv != &PL_sv_undef && (SvPADTMP(sv) || SvREADONLY(sv)))
2357                     {
2358                         /* Might be flattened array after $#array =  */
2359                         what = SvREADONLY(sv)
2360                                 ? "a readonly value" : "a temporary";
2361                         goto croak;
2362                     }
2363                 }
2364             }
2365
2366             leave_adjust_stacks(oldsp, oldsp, gimme, is_lval ? 3 : 2);
2367         }
2368     }
2369
2370     CX_LEAVE_SCOPE(cx);
2371     cx_popsub(cx);      /* Stack values are safe: release CV and @_ ... */
2372     cx_popblock(cx);
2373     retop =  cx->blk_sub.retop;
2374     CX_POP(cx);
2375
2376     return retop;
2377 }
2378
2379
2380 PP(pp_return)
2381 {
2382     dSP; dMARK;
2383     PERL_CONTEXT *cx;
2384     const I32 cxix = dopoptosub(cxstack_ix);
2385
2386     assert(cxstack_ix >= 0);
2387     if (cxix < cxstack_ix) {
2388         if (cxix < 0) {
2389             if (!(       PL_curstackinfo->si_type == PERLSI_SORT
2390                   || (   PL_curstackinfo->si_type == PERLSI_MULTICALL
2391                       && (cxstack[0].cx_type & CXp_SUB_RE_FAKE))
2392                  )
2393             )
2394                 DIE(aTHX_ "Can't return outside a subroutine");
2395             /* We must be in:
2396              *  a sort block, which is a CXt_NULL not a CXt_SUB;
2397              *  or a /(?{...})/ block.
2398              * Handle specially. */
2399             assert(CxTYPE(&cxstack[0]) == CXt_NULL
2400                     || (   CxTYPE(&cxstack[0]) == CXt_SUB
2401                         && (cxstack[0].cx_type & CXp_SUB_RE_FAKE)));
2402             if (cxstack_ix > 0) {
2403                 /* See comment below about context popping. Since we know
2404                  * we're scalar and not lvalue, we can preserve the return
2405                  * value in a simpler fashion than there. */
2406                 SV *sv = *SP;
2407                 assert(cxstack[0].blk_gimme == G_SCALAR);
2408                 if (   (sp != PL_stack_base)
2409                     && !(SvFLAGS(sv) & (SVs_TEMP|SVs_PADTMP))
2410                 )
2411                     *SP = sv_mortalcopy(sv);
2412                 dounwind(0);
2413             }
2414             /* caller responsible for popping cxstack[0] */
2415             return 0;
2416         }
2417
2418         /* There are contexts that need popping. Doing this may free the
2419          * return value(s), so preserve them first: e.g. popping the plain
2420          * loop here would free $x:
2421          *     sub f {  { my $x = 1; return $x } }
2422          * We may also need to shift the args down; for example,
2423          *    for (1,2) { return 3,4 }
2424          * leaves 1,2,3,4 on the stack. Both these actions will be done by
2425          * leave_adjust_stacks(), along with freeing any temps. Note that
2426          * whoever we tail-call (e.g. pp_leaveeval) will also call
2427          * leave_adjust_stacks(); however, the second call is likely to
2428          * just see a bunch of SvTEMPs with a ref count of 1, and so just
2429          * pass them through, rather than copying them again. So this
2430          * isn't as inefficient as it sounds.
2431          */
2432         cx = &cxstack[cxix];
2433         PUTBACK;
2434         if (cx->blk_gimme != G_VOID)
2435             leave_adjust_stacks(MARK, PL_stack_base + cx->blk_oldsp,
2436                     cx->blk_gimme,
2437                     CxTYPE(cx) == CXt_SUB && CvLVALUE(cx->blk_sub.cv)
2438                         ? 3 : 0);
2439         SPAGAIN;
2440         dounwind(cxix);
2441         cx = &cxstack[cxix]; /* CX stack may have been realloced */
2442     }
2443     else {
2444         /* Like in the branch above, we need to handle any extra junk on
2445          * the stack. But because we're not also popping extra contexts, we
2446          * don't have to worry about prematurely freeing args. So we just
2447          * need to do the bare minimum to handle junk, and leave the main
2448          * arg processing in the function we tail call, e.g. pp_leavesub.
2449          * In list context we have to splice out the junk; in scalar
2450          * context we can leave as-is (pp_leavesub will later return the
2451          * top stack element). But for an  empty arg list, e.g.
2452          *    for (1,2) { return }
2453          * we need to set sp = oldsp so that pp_leavesub knows to push
2454          * &PL_sv_undef onto the stack.
2455          */
2456         SV **oldsp;
2457         cx = &cxstack[cxix];
2458         oldsp = PL_stack_base + cx->blk_oldsp;
2459         if (oldsp != MARK) {
2460             SSize_t nargs = SP - MARK;
2461             if (nargs) {
2462                 if (cx->blk_gimme == G_ARRAY) {
2463                     /* shift return args to base of call stack frame */
2464                     Move(MARK + 1, oldsp + 1, nargs, SV*);
2465                     PL_stack_sp  = oldsp + nargs;
2466                 }
2467             }
2468             else
2469                 PL_stack_sp  = oldsp;
2470         }
2471     }
2472
2473     /* fall through to a normal exit */
2474     switch (CxTYPE(cx)) {
2475     case CXt_EVAL:
2476         return CxTRYBLOCK(cx)
2477             ? Perl_pp_leavetry(aTHX)
2478             : Perl_pp_leaveeval(aTHX);
2479     case CXt_SUB:
2480         return CvLVALUE(cx->blk_sub.cv)
2481             ? Perl_pp_leavesublv(aTHX)
2482             : Perl_pp_leavesub(aTHX);
2483     case CXt_FORMAT:
2484         return Perl_pp_leavewrite(aTHX);
2485     default:
2486         DIE(aTHX_ "panic: return, type=%u", (unsigned) CxTYPE(cx));
2487     }
2488 }
2489
2490 /* find the enclosing loop or labelled loop and dounwind() back to it. */
2491
2492 static PERL_CONTEXT *
2493 S_unwind_loop(pTHX)
2494 {
2495     I32 cxix;
2496     if (PL_op->op_flags & OPf_SPECIAL) {
2497         cxix = dopoptoloop(cxstack_ix);
2498         if (cxix < 0)
2499             /* diag_listed_as: Can't "last" outside a loop block */
2500             Perl_croak(aTHX_ "Can't \"%s\" outside a loop block",
2501                 OP_NAME(PL_op));
2502     }
2503     else {
2504         dSP;
2505         STRLEN label_len;
2506         const char * const label =
2507             PL_op->op_flags & OPf_STACKED
2508                 ? SvPV(TOPs,label_len)
2509                 : (label_len = strlen(cPVOP->op_pv), cPVOP->op_pv);
2510         const U32 label_flags =
2511             PL_op->op_flags & OPf_STACKED
2512                 ? SvUTF8(POPs)
2513                 : (cPVOP->op_private & OPpPV_IS_UTF8) ? SVf_UTF8 : 0;
2514         PUTBACK;
2515         cxix = dopoptolabel(label, label_len, label_flags);
2516         if (cxix < 0)
2517             /* diag_listed_as: Label not found for "last %s" */
2518             Perl_croak(aTHX_ "Label not found for \"%s %"SVf"\"",
2519                                        OP_NAME(PL_op),
2520                                        SVfARG(PL_op->op_flags & OPf_STACKED
2521                                               && !SvGMAGICAL(TOPp1s)
2522                                               ? TOPp1s
2523                                               : newSVpvn_flags(label,
2524                                                     label_len,
2525                                                     label_flags | SVs_TEMP)));
2526     }
2527     if (cxix < cxstack_ix)
2528         dounwind(cxix);
2529     return &cxstack[cxix];
2530 }
2531
2532
2533 PP(pp_last)
2534 {
2535     PERL_CONTEXT *cx;
2536     OP* nextop;
2537
2538     cx = S_unwind_loop(aTHX);
2539
2540     assert(CxTYPE_is_LOOP(cx));
2541     PL_stack_sp = PL_stack_base
2542                 + (CxTYPE(cx) == CXt_LOOP_LIST
2543                     ?  cx->blk_loop.state_u.stack.basesp
2544                     : cx->blk_oldsp
2545                 );
2546
2547     TAINT_NOT;
2548
2549     /* Stack values are safe: */
2550     CX_LEAVE_SCOPE(cx);
2551     cx_poploop(cx);     /* release loop vars ... */
2552     cx_popblock(cx);
2553     nextop = cx->blk_loop.my_op->op_lastop->op_next;
2554     CX_POP(cx);
2555
2556     return nextop;
2557 }
2558
2559 PP(pp_next)
2560 {
2561     PERL_CONTEXT *cx;
2562
2563     /* if not a bare 'next' in the main scope, search for it */
2564     cx = CX_CUR();
2565     if (!((PL_op->op_flags & OPf_SPECIAL) && CxTYPE_is_LOOP(cx)))
2566         cx = S_unwind_loop(aTHX);
2567
2568     cx_topblock(cx);
2569     PL_curcop = cx->blk_oldcop;
2570     PERL_ASYNC_CHECK();
2571     return (cx)->blk_loop.my_op->op_nextop;
2572 }
2573
2574 PP(pp_redo)
2575 {
2576     PERL_CONTEXT *cx = S_unwind_loop(aTHX);
2577     OP* redo_op = cx->blk_loop.my_op->op_redoop;
2578
2579     if (redo_op->op_type == OP_ENTER) {
2580         /* pop one less context to avoid $x being freed in while (my $x..) */
2581         cxstack_ix++;
2582         cx = CX_CUR();
2583         assert(CxTYPE(cx) == CXt_BLOCK);
2584         redo_op = redo_op->op_next;
2585     }
2586
2587     FREETMPS;
2588     CX_LEAVE_SCOPE(cx);
2589     cx_topblock(cx);
2590     PL_curcop = cx->blk_oldcop;
2591     PERL_ASYNC_CHECK();
2592     return redo_op;
2593 }
2594
2595 STATIC OP *
2596 S_dofindlabel(pTHX_ OP *o, const char *label, STRLEN len, U32 flags, OP **opstack, OP **oplimit)
2597 {
2598     OP **ops = opstack;
2599     static const char* const too_deep = "Target of goto is too deeply nested";
2600
2601     PERL_ARGS_ASSERT_DOFINDLABEL;
2602
2603     if (ops >= oplimit)
2604         Perl_croak(aTHX_ "%s", too_deep);
2605     if (o->op_type == OP_LEAVE ||
2606         o->op_type == OP_SCOPE ||
2607         o->op_type == OP_LEAVELOOP ||
2608         o->op_type == OP_LEAVESUB ||
2609         o->op_type == OP_LEAVETRY)
2610     {
2611         *ops++ = cUNOPo->op_first;
2612         if (ops >= oplimit)
2613             Perl_croak(aTHX_ "%s", too_deep);
2614     }
2615     *ops = 0;
2616     if (o->op_flags & OPf_KIDS) {
2617         OP *kid;
2618         /* First try all the kids at this level, since that's likeliest. */
2619         for (kid = cUNOPo->op_first; kid; kid = OpSIBLING(kid)) {
2620             if (kid->op_type == OP_NEXTSTATE || kid->op_type == OP_DBSTATE) {
2621                 STRLEN kid_label_len;
2622                 U32 kid_label_flags;
2623                 const char *kid_label = CopLABEL_len_flags(kCOP,
2624                                                     &kid_label_len, &kid_label_flags);
2625                 if (kid_label && (
2626                     ( (kid_label_flags & SVf_UTF8) != (flags & SVf_UTF8) ) ?
2627                         (flags & SVf_UTF8)
2628                             ? (bytes_cmp_utf8(
2629                                         (const U8*)kid_label, kid_label_len,
2630                                         (const U8*)label, len) == 0)
2631                             : (bytes_cmp_utf8(
2632                                         (const U8*)label, len,
2633                                         (const U8*)kid_label, kid_label_len) == 0)
2634                     : ( len == kid_label_len && ((kid_label == label)
2635                                     || memEQ(kid_label, label, len)))))
2636                     return kid;
2637             }
2638         }
2639         for (kid = cUNOPo->op_first; kid; kid = OpSIBLING(kid)) {
2640             if (kid == PL_lastgotoprobe)
2641                 continue;
2642             if (kid->op_type == OP_NEXTSTATE || kid->op_type == OP_DBSTATE) {
2643                 if (ops == opstack)
2644                     *ops++ = kid;
2645                 else if (ops[-1]->op_type == OP_NEXTSTATE ||
2646                          ops[-1]->op_type == OP_DBSTATE)
2647                     ops[-1] = kid;
2648                 else
2649                     *ops++ = kid;
2650             }
2651             if ((o = dofindlabel(kid, label, len, flags, ops, oplimit)))
2652                 return o;
2653         }
2654     }
2655     *ops = 0;
2656     return 0;
2657 }
2658
2659
2660 /* also used for: pp_dump() */
2661
2662 PP(pp_goto)
2663 {
2664     dVAR; dSP;
2665     OP *retop = NULL;
2666     I32 ix;
2667     PERL_CONTEXT *cx;
2668 #define GOTO_DEPTH 64
2669     OP *enterops[GOTO_DEPTH];
2670     const char *label = NULL;
2671     STRLEN label_len = 0;
2672     U32 label_flags = 0;
2673     const bool do_dump = (PL_op->op_type == OP_DUMP);
2674     static const char* const must_have_label = "goto must have label";
2675
2676     if (PL_op->op_flags & OPf_STACKED) {
2677         /* goto EXPR  or  goto &foo */
2678
2679         SV * const sv = POPs;
2680         SvGETMAGIC(sv);
2681
2682         if (SvROK(sv) && SvTYPE(SvRV(sv)) == SVt_PVCV) {
2683             /* This egregious kludge implements goto &subroutine */
2684             I32 cxix;
2685             PERL_CONTEXT *cx;
2686             CV *cv = MUTABLE_CV(SvRV(sv));
2687             AV *arg = GvAV(PL_defgv);
2688
2689             while (!CvROOT(cv) && !CvXSUB(cv)) {
2690                 const GV * const gv = CvGV(cv);
2691                 if (gv) {
2692                     GV *autogv;
2693                     SV *tmpstr;
2694                     /* autoloaded stub? */
2695                     if (cv != GvCV(gv) && (cv = GvCV(gv)))
2696                         continue;
2697                     autogv = gv_autoload_pvn(GvSTASH(gv), GvNAME(gv),
2698                                           GvNAMELEN(gv),
2699                                           GvNAMEUTF8(gv) ? SVf_UTF8 : 0);
2700                     if (autogv && (cv = GvCV(autogv)))
2701                         continue;
2702                     tmpstr = sv_newmortal();
2703                     gv_efullname3(tmpstr, gv, NULL);
2704                     DIE(aTHX_ "Goto undefined subroutine &%"SVf"", SVfARG(tmpstr));
2705                 }
2706                 DIE(aTHX_ "Goto undefined subroutine");
2707             }
2708
2709             cxix = dopoptosub(cxstack_ix);
2710             if (cxix < 0) {
2711                 DIE(aTHX_ "Can't goto subroutine outside a subroutine");
2712             }
2713             cx  = &cxstack[cxix];
2714             /* ban goto in eval: see <20050521150056.GC20213@iabyn.com> */
2715             if (CxTYPE(cx) == CXt_EVAL) {
2716                 if (CxREALEVAL(cx))
2717                 /* diag_listed_as: Can't goto subroutine from an eval-%s */
2718                     DIE(aTHX_ "Can't goto subroutine from an eval-string");
2719                 else
2720                 /* diag_listed_as: Can't goto subroutine from an eval-%s */
2721                     DIE(aTHX_ "Can't goto subroutine from an eval-block");
2722             }
2723             else if (CxMULTICALL(cx))
2724                 DIE(aTHX_ "Can't goto subroutine from a sort sub (or similar callback)");
2725
2726             /* First do some returnish stuff. */
2727
2728             SvREFCNT_inc_simple_void(cv); /* avoid premature free during unwind */
2729             FREETMPS;
2730             if (cxix < cxstack_ix) {
2731                 dounwind(cxix);
2732             }
2733             cx = CX_CUR();
2734             cx_topblock(cx);
2735             SPAGAIN;
2736
2737             /* protect @_ during save stack unwind. */
2738             if (arg)
2739                 SvREFCNT_inc_NN(sv_2mortal(MUTABLE_SV(arg)));
2740
2741             assert(PL_scopestack_ix == cx->blk_oldscopesp);
2742             CX_LEAVE_SCOPE(cx);
2743
2744             if (CxTYPE(cx) == CXt_SUB && CxHASARGS(cx)) {
2745                 /* this is part of cx_popsub_args() */
2746                 AV* av = MUTABLE_AV(PAD_SVl(0));
2747                 assert(AvARRAY(MUTABLE_AV(
2748                     PadlistARRAY(CvPADLIST(cx->blk_sub.cv))[
2749                             CvDEPTH(cx->blk_sub.cv)])) == PL_curpad);
2750
2751                 /* we are going to donate the current @_ from the old sub
2752                  * to the new sub. This first part of the donation puts a
2753                  * new empty AV in the pad[0] slot of the old sub,
2754                  * unless pad[0] and @_ differ (e.g. if the old sub did
2755                  * local *_ = []); in which case clear the old pad[0]
2756                  * array in the usual way */
2757                 if (av == arg || AvREAL(av))
2758                     clear_defarray(av, av == arg);
2759                 else CLEAR_ARGARRAY(av);
2760             }
2761
2762             /* don't restore PL_comppad here. It won't be needed if the
2763              * sub we're going to is non-XS, but restoring it early then
2764              * croaking (e.g. the "Goto undefined subroutine" below)
2765              * means the CX block gets processed again in dounwind,
2766              * but this time with the wrong PL_comppad */
2767
2768             /* A destructor called during LEAVE_SCOPE could have undefined
2769              * our precious cv.  See bug #99850. */
2770             if (!CvROOT(cv) && !CvXSUB(cv)) {
2771                 const GV * const gv = CvGV(cv);
2772                 if (gv) {
2773                     SV * const tmpstr = sv_newmortal();
2774                     gv_efullname3(tmpstr, gv, NULL);
2775                     DIE(aTHX_ "Goto undefined subroutine &%"SVf"",
2776                                SVfARG(tmpstr));
2777                 }
2778                 DIE(aTHX_ "Goto undefined subroutine");
2779             }
2780
2781             if (CxTYPE(cx) == CXt_SUB) {
2782                 CvDEPTH(cx->blk_sub.cv) = cx->blk_sub.olddepth;
2783                 SvREFCNT_dec_NN(cx->blk_sub.cv);
2784             }
2785
2786             /* Now do some callish stuff. */
2787             if (CvISXSUB(cv)) {
2788                 const SSize_t items = arg ? AvFILL(arg) + 1 : 0;
2789                 const bool m = arg ? cBOOL(SvRMAGICAL(arg)) : 0;
2790                 SV** mark;
2791
2792                 ENTER;
2793                 SAVETMPS;
2794                 SAVEFREESV(cv); /* later, undo the 'avoid premature free' hack */
2795
2796                 /* put GvAV(defgv) back onto stack */
2797                 if (items) {
2798                     EXTEND(SP, items+1); /* @_ could have been extended. */
2799                 }
2800                 mark = SP;
2801                 if (items) {
2802                     SSize_t index;
2803                     bool r = cBOOL(AvREAL(arg));
2804                     for (index=0; index<items; index++)
2805                     {
2806                         SV *sv;
2807                         if (m) {
2808                             SV ** const svp = av_fetch(arg, index, 0);
2809                             sv = svp ? *svp : NULL;
2810                         }
2811                         else sv = AvARRAY(arg)[index];
2812                         SP[index+1] = sv
2813                             ? r ? SvREFCNT_inc_NN(sv_2mortal(sv)) : sv
2814                             : sv_2mortal(newSVavdefelem(arg, index, 1));
2815                     }
2816                 }
2817                 SP += items;
2818                 if (CxTYPE(cx) == CXt_SUB && CxHASARGS(cx)) {
2819                     /* Restore old @_ */
2820                     CX_POP_SAVEARRAY(cx);
2821                 }
2822
2823                 retop = cx->blk_sub.retop;
2824                 PL_comppad = cx->blk_sub.prevcomppad;
2825                 PL_curpad = LIKELY(PL_comppad) ? AvARRAY(PL_comppad) : NULL;
2826
2827                 /* XS subs don't have a CXt_SUB, so pop it;
2828                  * this is a cx_popblock(), less all the stuff we already did
2829                  * for cx_topblock() earlier */
2830                 PL_curcop = cx->blk_oldcop;
2831                 CX_POP(cx);
2832
2833                 /* Push a mark for the start of arglist */
2834                 PUSHMARK(mark);
2835                 PUTBACK;
2836                 (void)(*CvXSUB(cv))(aTHX_ cv);
2837                 LEAVE;
2838                 goto _return;
2839             }
2840             else {
2841                 PADLIST * const padlist = CvPADLIST(cv);
2842
2843                 SAVEFREESV(cv); /* later, undo the 'avoid premature free' hack */
2844
2845                 /* partial unrolled cx_pushsub(): */
2846
2847                 cx->blk_sub.cv = cv;
2848                 cx->blk_sub.olddepth = CvDEPTH(cv);
2849
2850                 CvDEPTH(cv)++;
2851                 SvREFCNT_inc_simple_void_NN(cv);
2852                 if (CvDEPTH(cv) > 1) {
2853                     if (CvDEPTH(cv) == PERL_SUB_DEPTH_WARN && ckWARN(WARN_RECURSION))
2854                         sub_crush_depth(cv);
2855                     pad_push(padlist, CvDEPTH(cv));
2856                 }
2857                 PL_curcop = cx->blk_oldcop;
2858                 PAD_SET_CUR_NOSAVE(padlist, CvDEPTH(cv));
2859                 if (CxHASARGS(cx))
2860                 {
2861                     /* second half of donating @_ from the old sub to the
2862                      * new sub: abandon the original pad[0] AV in the
2863                      * new sub, and replace it with the donated @_.
2864                      * pad[0] takes ownership of the extra refcount
2865                      * we gave arg earlier */
2866                     if (arg) {
2867                         SvREFCNT_dec(PAD_SVl(0));
2868                         PAD_SVl(0) = (SV *)arg;
2869                         SvREFCNT_inc_simple_void_NN(arg);
2870                     }
2871
2872                     /* GvAV(PL_defgv) might have been modified on scope
2873                        exit, so point it at arg again. */
2874                     if (arg != GvAV(PL_defgv)) {
2875                         AV * const av = GvAV(PL_defgv);
2876                         GvAV(PL_defgv) = (AV *)SvREFCNT_inc_simple(arg);
2877                         SvREFCNT_dec(av);
2878                     }
2879                 }
2880
2881                 if (PERLDB_SUB) {       /* Checking curstash breaks DProf. */
2882                     Perl_get_db_sub(aTHX_ NULL, cv);
2883                     if (PERLDB_GOTO) {
2884                         CV * const gotocv = get_cvs("DB::goto", 0);
2885                         if (gotocv) {
2886                             PUSHMARK( PL_stack_sp );
2887                             call_sv(MUTABLE_SV(gotocv), G_SCALAR | G_NODEBUG);
2888                             PL_stack_sp--;
2889                         }
2890                     }
2891                 }
2892                 retop = CvSTART(cv);
2893                 goto putback_return;
2894             }
2895         }
2896         else {
2897             /* goto EXPR */
2898             label       = SvPV_nomg_const(sv, label_len);
2899             label_flags = SvUTF8(sv);
2900         }
2901     }
2902     else if (!(PL_op->op_flags & OPf_SPECIAL)) {
2903         /* goto LABEL  or  dump LABEL */
2904         label       = cPVOP->op_pv;
2905         label_flags = (cPVOP->op_private & OPpPV_IS_UTF8) ? SVf_UTF8 : 0;
2906         label_len   = strlen(label);
2907     }
2908     if (!(do_dump || label_len)) DIE(aTHX_ "%s", must_have_label);
2909
2910     PERL_ASYNC_CHECK();
2911
2912     if (label_len) {
2913         OP *gotoprobe = NULL;
2914         bool leaving_eval = FALSE;
2915         bool in_block = FALSE;
2916         PERL_CONTEXT *last_eval_cx = NULL;
2917
2918         /* find label */
2919
2920         PL_lastgotoprobe = NULL;
2921         *enterops = 0;
2922         for (ix = cxstack_ix; ix >= 0; ix--) {
2923             cx = &cxstack[ix];
2924             switch (CxTYPE(cx)) {
2925             case CXt_EVAL:
2926                 leaving_eval = TRUE;
2927                 if (!CxTRYBLOCK(cx)) {
2928                     gotoprobe = (last_eval_cx ?
2929                                 last_eval_cx->blk_eval.old_eval_root :
2930                                 PL_eval_root);
2931                     last_eval_cx = cx;
2932                     break;
2933                 }
2934                 /* else fall through */
2935             case CXt_LOOP_PLAIN:
2936             case CXt_LOOP_LAZYIV:
2937             case CXt_LOOP_LAZYSV:
2938             case CXt_LOOP_LIST:
2939             case CXt_LOOP_ARY:
2940             case CXt_GIVEN:
2941             case CXt_WHEN:
2942                 gotoprobe = OpSIBLING(cx->blk_oldcop);
2943                 break;
2944             case CXt_SUBST:
2945                 continue;
2946             case CXt_BLOCK:
2947                 if (ix) {
2948                     gotoprobe = OpSIBLING(cx->blk_oldcop);
2949                     in_block = TRUE;
2950                 } else
2951                     gotoprobe = PL_main_root;
2952                 break;
2953             case CXt_SUB:
2954                 if (CvDEPTH(cx->blk_sub.cv) && !CxMULTICALL(cx)) {
2955                     gotoprobe = CvROOT(cx->blk_sub.cv);
2956                     break;
2957                 }
2958                 /* FALLTHROUGH */
2959             case CXt_FORMAT:
2960             case CXt_NULL:
2961                 DIE(aTHX_ "Can't \"goto\" out of a pseudo block");
2962             default:
2963                 if (ix)
2964                     DIE(aTHX_ "panic: goto, type=%u, ix=%ld",
2965                         CxTYPE(cx), (long) ix);
2966                 gotoprobe = PL_main_root;
2967                 break;
2968             }
2969             if (gotoprobe) {
2970                 OP *sibl1, *sibl2;
2971
2972                 retop = dofindlabel(gotoprobe, label, label_len, label_flags,
2973                                     enterops, enterops + GOTO_DEPTH);
2974                 if (retop)
2975                     break;
2976                 if ( (sibl1 = OpSIBLING(gotoprobe)) &&
2977                      sibl1->op_type == OP_UNSTACK &&
2978                      (sibl2 = OpSIBLING(sibl1)))
2979                 {
2980                     retop = dofindlabel(sibl2,
2981                                         label, label_len, label_flags, enterops,
2982                                         enterops + GOTO_DEPTH);
2983                     if (retop)
2984                         break;
2985                 }
2986             }
2987             PL_lastgotoprobe = gotoprobe;
2988         }
2989         if (!retop)
2990             DIE(aTHX_ "Can't find label %"UTF8f, 
2991                        UTF8fARG(label_flags, label_len, label));
2992
2993         /* if we're leaving an eval, check before we pop any frames
2994            that we're not going to punt, otherwise the error
2995            won't be caught */
2996
2997         if (leaving_eval && *enterops && enterops[1]) {
2998             I32 i;
2999             for (i = 1; enterops[i]; i++)
3000                 if (enterops[i]->op_type == OP_ENTERITER)
3001                     DIE(aTHX_ "Can't \"goto\" into the middle of a foreach loop");
3002         }
3003
3004         if (*enterops && enterops[1]) {
3005             I32 i = enterops[1]->op_type == OP_ENTER && in_block ? 2 : 1;
3006             if (enterops[i])
3007                 deprecate("\"goto\" to jump into a construct");
3008         }
3009
3010         /* pop unwanted frames */
3011
3012         if (ix < cxstack_ix) {
3013             if (ix < 0)
3014                 DIE(aTHX_ "panic: docatch: illegal ix=%ld", (long)ix);
3015             dounwind(ix);
3016             cx = CX_CUR();
3017             cx_topblock(cx);
3018         }
3019
3020         /* push wanted frames */
3021
3022         if (*enterops && enterops[1]) {
3023             OP * const oldop = PL_op;
3024             ix = enterops[1]->op_type == OP_ENTER && in_block ? 2 : 1;
3025             for (; enterops[ix]; ix++) {
3026                 PL_op = enterops[ix];
3027                 /* Eventually we may want to stack the needed arguments
3028                  * for each op.  For now, we punt on the hard ones. */
3029                 if (PL_op->op_type == OP_ENTERITER)
3030                     DIE(aTHX_ "Can't \"goto\" into the middle of a foreach loop");
3031                 PL_op->op_ppaddr(aTHX);
3032             }
3033             PL_op = oldop;
3034         }
3035     }
3036
3037     if (do_dump) {
3038 #ifdef VMS
3039         if (!retop) retop = PL_main_start;
3040 #endif
3041         PL_restartop = retop;
3042         PL_do_undump = TRUE;
3043
3044         my_unexec();
3045
3046         PL_restartop = 0;               /* hmm, must be GNU unexec().. */
3047         PL_do_undump = FALSE;
3048     }
3049
3050     putback_return:
3051     PL_stack_sp = sp;
3052     _return:
3053     PERL_ASYNC_CHECK();
3054     return retop;
3055 }
3056
3057 PP(pp_exit)
3058 {
3059     dSP;
3060     I32 anum;
3061
3062     if (MAXARG < 1)
3063         anum = 0;
3064     else if (!TOPs) {
3065         anum = 0; (void)POPs;
3066     }
3067     else {
3068         anum = SvIVx(POPs);
3069 #ifdef VMS
3070         if (anum == 1
3071          && SvTRUE(cop_hints_fetch_pvs(PL_curcop, "vmsish_exit", 0)))
3072             anum = 0;
3073         VMSISH_HUSHED  =
3074             VMSISH_HUSHED || (PL_curcop->op_private & OPpHUSH_VMSISH);
3075 #endif
3076     }
3077     PL_exit_flags |= PERL_EXIT_EXPECTED;
3078     my_exit(anum);
3079     PUSHs(&PL_sv_undef);
3080     RETURN;
3081 }
3082
3083 /* Eval. */
3084
3085 STATIC void
3086 S_save_lines(pTHX_ AV *array, SV *sv)
3087 {
3088     const char *s = SvPVX_const(sv);
3089     const char * const send = SvPVX_const(sv) + SvCUR(sv);
3090     I32 line = 1;
3091
3092     PERL_ARGS_ASSERT_SAVE_LINES;
3093
3094     while (s && s < send) {
3095         const char *t;
3096         SV * const tmpstr = newSV_type(SVt_PVMG);
3097
3098         t = (const char *)memchr(s, '\n', send - s);
3099         if (t)
3100             t++;
3101         else
3102             t = send;
3103
3104         sv_setpvn(tmpstr, s, t - s);
3105         av_store(array, line++, tmpstr);
3106         s = t;
3107     }
3108 }
3109
3110 /*
3111 =for apidoc docatch
3112
3113 Check for the cases 0 or 3 of cur_env.je_ret, only used inside an eval context.
3114
3115 0 is used as continue inside eval,
3116
3117 3 is used for a die caught by an inner eval - continue inner loop
3118
3119 See F<cop.h>: je_mustcatch, when set at any runlevel to TRUE, means eval ops must
3120 establish a local jmpenv to handle exception traps.
3121
3122 =cut
3123 */
3124 STATIC OP *
3125 S_docatch(pTHX_ OP *o)
3126 {
3127     int ret;
3128     OP * const oldop = PL_op;
3129     dJMPENV;
3130
3131 #ifdef DEBUGGING
3132     assert(CATCH_GET == TRUE);
3133 #endif
3134     PL_op = o;
3135
3136     JMPENV_PUSH(ret);
3137     switch (ret) {
3138     case 0:
3139         assert(cxstack_ix >= 0);
3140         assert(CxTYPE(CX_CUR()) == CXt_EVAL);
3141         CX_CUR()->blk_eval.cur_top_env = PL_top_env;
3142  redo_body:
3143         CALLRUNOPS(aTHX);
3144         break;
3145     case 3:
3146         /* die caught by an inner eval - continue inner loop */
3147         if (PL_restartop && PL_restartjmpenv == PL_top_env) {
3148             PL_restartjmpenv = NULL;
3149             PL_op = PL_restartop;
3150             PL_restartop = 0;
3151             goto redo_body;
3152         }
3153         /* FALLTHROUGH */
3154     default:
3155         JMPENV_POP;
3156         PL_op = oldop;
3157         JMPENV_JUMP(ret);
3158         NOT_REACHED; /* NOTREACHED */
3159     }
3160     JMPENV_POP;
3161     PL_op = oldop;
3162     return NULL;
3163 }
3164
3165
3166 /*
3167 =for apidoc find_runcv
3168
3169 Locate the CV corresponding to the currently executing sub or eval.
3170 If C<db_seqp> is non_null, skip CVs that are in the DB package and populate
3171 C<*db_seqp> with the cop sequence number at the point that the DB:: code was
3172 entered.  (This allows debuggers to eval in the scope of the breakpoint
3173 rather than in the scope of the debugger itself.)
3174
3175 =cut
3176 */
3177
3178 CV*
3179 Perl_find_runcv(pTHX_ U32 *db_seqp)
3180 {
3181     return Perl_find_runcv_where(aTHX_ 0, 0, db_seqp);
3182 }
3183
3184 /* If this becomes part of the API, it might need a better name. */
3185 CV *
3186 Perl_find_runcv_where(pTHX_ U8 cond, IV arg, U32 *db_seqp)
3187 {
3188     PERL_SI      *si;
3189     int          level = 0;
3190
3191     if (db_seqp)
3192         *db_seqp =
3193             PL_curcop == &PL_compiling
3194                 ? PL_cop_seqmax
3195                 : PL_curcop->cop_seq;
3196
3197     for (si = PL_curstackinfo; si; si = si->si_prev) {
3198         I32 ix;
3199         for (ix = si->si_cxix; ix >= 0; ix--) {
3200             const PERL_CONTEXT *cx = &(si->si_cxstack[ix]);
3201             CV *cv = NULL;
3202             if (CxTYPE(cx) == CXt_SUB || CxTYPE(cx) == CXt_FORMAT) {
3203                 cv = cx->blk_sub.cv;
3204                 /* skip DB:: code */
3205                 if (db_seqp && PL_debstash && CvSTASH(cv) == PL_debstash) {
3206                     *db_seqp = cx->blk_oldcop->cop_seq;
3207                     continue;
3208                 }
3209                 if (cx->cx_type & CXp_SUB_RE)
3210                     continue;
3211             }
3212             else if (CxTYPE(cx) == CXt_EVAL && !CxTRYBLOCK(cx))
3213                 cv = cx->blk_eval.cv;
3214             if (cv) {
3215                 switch (cond) {
3216                 case FIND_RUNCV_padid_eq:
3217                     if (!CvPADLIST(cv)
3218                      || CvPADLIST(cv)->xpadl_id != (U32)arg)
3219                         continue;
3220                     return cv;
3221                 case FIND_RUNCV_level_eq:
3222                     if (level++ != arg) continue;
3223                     /* GERONIMO! */
3224                 default:
3225                     return cv;
3226                 }
3227             }
3228         }
3229     }
3230     return cond == FIND_RUNCV_padid_eq ? NULL : PL_main_cv;
3231 }
3232
3233
3234 /* Run yyparse() in a setjmp wrapper. Returns:
3235  *   0: yyparse() successful
3236  *   1: yyparse() failed
3237  *   3: yyparse() died
3238  */
3239 STATIC int
3240 S_try_yyparse(pTHX_ int gramtype)
3241 {
3242     int ret;
3243     dJMPENV;
3244
3245     assert(CxTYPE(CX_CUR()) == CXt_EVAL);
3246     JMPENV_PUSH(ret);
3247     switch (ret) {
3248     case 0:
3249         ret = yyparse(gramtype) ? 1 : 0;
3250         break;
3251     case 3:
3252         break;
3253     default:
3254         JMPENV_POP;
3255         JMPENV_JUMP(ret);
3256         NOT_REACHED; /* NOTREACHED */
3257     }
3258     JMPENV_POP;
3259     return ret;
3260 }
3261
3262
3263 /* Compile a require/do or an eval ''.
3264  *
3265  * outside is the lexically enclosing CV (if any) that invoked us.
3266  * seq     is the current COP scope value.
3267  * hh      is the saved hints hash, if any.
3268  *
3269  * Returns a bool indicating whether the compile was successful; if so,
3270  * PL_eval_start contains the first op of the compiled code; otherwise,
3271  * pushes undef.
3272  *
3273  * This function is called from two places: pp_require and pp_entereval.
3274  * These can be distinguished by whether PL_op is entereval.
3275  */
3276
3277 STATIC bool
3278 S_doeval_compile(pTHX_ U8 gimme, CV* outside, U32 seq, HV *hh)
3279 {
3280     dSP;
3281     OP * const saveop = PL_op;
3282     bool clear_hints = saveop->op_type != OP_ENTEREVAL;
3283     COP * const oldcurcop = PL_curcop;
3284     bool in_require = (saveop->op_type == OP_REQUIRE);
3285     int yystatus;
3286     CV *evalcv;
3287
3288     PL_in_eval = (in_require
3289                   ? (EVAL_INREQUIRE | (PL_in_eval & EVAL_INEVAL))
3290                   : (EVAL_INEVAL |
3291                         ((PL_op->op_private & OPpEVAL_RE_REPARSING)
3292                             ? EVAL_RE_REPARSING : 0)));
3293
3294     PUSHMARK(SP);
3295
3296     evalcv = MUTABLE_CV(newSV_type(SVt_PVCV));
3297     CvEVAL_on(evalcv);
3298     assert(CxTYPE(CX_CUR()) == CXt_EVAL);
3299     CX_CUR()->blk_eval.cv = evalcv;
3300     CX_CUR()->blk_gimme = gimme;
3301
3302     CvOUTSIDE_SEQ(evalcv) = seq;
3303     CvOUTSIDE(evalcv) = MUTABLE_CV(SvREFCNT_inc_simple(outside));
3304
3305     /* set up a scratch pad */
3306
3307     CvPADLIST_set(evalcv, pad_new(padnew_SAVE));
3308     PL_op = NULL; /* avoid PL_op and PL_curpad referring to different CVs */
3309
3310
3311     SAVEMORTALIZESV(evalcv);    /* must remain until end of current statement */
3312
3313     /* make sure we compile in the right package */
3314
3315     if (CopSTASH_ne(PL_curcop, PL_curstash)) {
3316         SAVEGENERICSV(PL_curstash);
3317         PL_curstash = (HV *)CopSTASH(PL_curcop);
3318         if (SvTYPE(PL_curstash) != SVt_PVHV) PL_curstash = NULL;
3319         else SvREFCNT_inc_simple_void(PL_curstash);
3320     }
3321     /* XXX:ajgo do we really need to alloc an AV for begin/checkunit */
3322     SAVESPTR(PL_beginav);
3323     PL_beginav = newAV();
3324     SAVEFREESV(PL_beginav);
3325     SAVESPTR(PL_unitcheckav);
3326     PL_unitcheckav = newAV();
3327     SAVEFREESV(PL_unitcheckav);
3328
3329
3330     ENTER_with_name("evalcomp");
3331     SAVESPTR(PL_compcv);
3332     PL_compcv = evalcv;
3333
3334     /* try to compile it */
3335
3336     PL_eval_root = NULL;
3337     PL_curcop = &PL_compiling;
3338     if ((saveop->op_type != OP_REQUIRE) && (saveop->op_flags & OPf_SPECIAL))
3339         PL_in_eval |= EVAL_KEEPERR;
3340     else
3341         CLEAR_ERRSV();
3342
3343     SAVEHINTS();
3344     if (clear_hints) {
3345         PL_hints = 0;
3346         hv_clear(GvHV(PL_hintgv));
3347     }
3348     else {
3349         PL_hints = saveop->op_private & OPpEVAL_COPHH
3350                      ? oldcurcop->cop_hints : (U32)saveop->op_targ;
3351
3352         /* making 'use re eval' not be in scope when compiling the
3353          * qr/mabye_has_runtime_code_block/ ensures that we don't get
3354          * infinite recursion when S_has_runtime_code() gives a false
3355          * positive: the second time round, HINT_RE_EVAL isn't set so we
3356          * don't bother calling S_has_runtime_code() */
3357         if (PL_in_eval & EVAL_RE_REPARSING)
3358             PL_hints &= ~HINT_RE_EVAL;
3359
3360         if (hh) {
3361             /* SAVEHINTS created a new HV in PL_hintgv, which we need to GC */
3362             SvREFCNT_dec(GvHV(PL_hintgv));
3363             GvHV(PL_hintgv) = hh;
3364         }
3365     }
3366     SAVECOMPILEWARNINGS();
3367     if (clear_hints) {
3368         if (PL_dowarn & G_WARN_ALL_ON)
3369             PL_compiling.cop_warnings = pWARN_ALL ;
3370         else if (PL_dowarn & G_WARN_ALL_OFF)
3371             PL_compiling.cop_warnings = pWARN_NONE ;
3372         else
3373             PL_compiling.cop_warnings = pWARN_STD ;
3374     }
3375     else {
3376         PL_compiling.cop_warnings =
3377             DUP_WARNINGS(oldcurcop->cop_warnings);
3378         cophh_free(CopHINTHASH_get(&PL_compiling));
3379         if (Perl_cop_fetch_label(aTHX_ oldcurcop, NULL, NULL)) {
3380             /* The label, if present, is the first entry on the chain. So rather
3381                than writing a blank label in front of it (which involves an
3382                allocation), just use the next entry in the chain.  */
3383             PL_compiling.cop_hints_hash
3384                 = cophh_copy(oldcurcop->cop_hints_hash->refcounted_he_next);
3385             /* Check the assumption that this removed the label.  */
3386             assert(Perl_cop_fetch_label(aTHX_ &PL_compiling, NULL, NULL) == NULL);
3387         }
3388         else
3389             PL_compiling.cop_hints_hash = cophh_copy(oldcurcop->cop_hints_hash);
3390     }
3391
3392     CALL_BLOCK_HOOKS(bhk_eval, saveop);
3393
3394     /* note that yyparse() may raise an exception, e.g. C<BEGIN{die}>,
3395      * so honour CATCH_GET and trap it here if necessary */
3396
3397
3398     /* compile the code */
3399     yystatus = (!in_require && CATCH_GET) ? S_try_yyparse(aTHX_ GRAMPROG) : yyparse(GRAMPROG);
3400
3401     if (yystatus || PL_parser->error_count || !PL_eval_root) {
3402         PERL_CONTEXT *cx;
3403         SV *errsv;
3404
3405         PL_op = saveop;
3406         /* note that if yystatus == 3, then the require/eval died during
3407          * compilation, so the EVAL CX block has already been popped, and
3408          * various vars restored */
3409         if (yystatus != 3) {
3410             if (PL_eval_root) {
3411                 op_free(PL_eval_root);
3412                 PL_eval_root = NULL;
3413             }
3414             SP = PL_stack_base + POPMARK;       /* pop original mark */
3415             cx = CX_CUR();
3416             assert(CxTYPE(cx) == CXt_EVAL);
3417             /* pop the CXt_EVAL, and if was a require, croak */
3418             S_pop_eval_context_maybe_croak(aTHX_ cx, ERRSV, 2);
3419         }
3420
3421         /* die_unwind() re-croaks when in require, having popped the
3422          * require EVAL context. So we should never catch a require
3423          * exception here */
3424         assert(!in_require);
3425
3426         errsv = ERRSV;
3427         if (!*(SvPV_nolen_const(errsv)))
3428             sv_setpvs(errsv, "Compilation error");
3429
3430         if (gimme != G_ARRAY) PUSHs(&PL_sv_undef);
3431         PUTBACK;
3432         return FALSE;
3433     }
3434
3435     /* Compilation successful. Now clean up */
3436
3437     LEAVE_with_name("evalcomp");
3438
3439     CopLINE_set(&PL_compiling, 0);
3440     SAVEFREEOP(PL_eval_root);
3441     cv_forget_slab(evalcv);
3442
3443     DEBUG_x(dump_eval());
3444
3445     /* Register with debugger: */
3446     if (PERLDB_INTER && saveop->op_type == OP_REQUIRE) {
3447         CV * const cv = get_cvs("DB::postponed", 0);
3448         if (cv) {
3449             dSP;
3450             PUSHMARK(SP);
3451             XPUSHs(MUTABLE_SV(CopFILEGV(&PL_compiling)));
3452             PUTBACK;
3453             call_sv(MUTABLE_SV(cv), G_DISCARD);
3454         }
3455     }
3456
3457     if (PL_unitcheckav) {
3458         OP *es = PL_eval_start;
3459         call_list(PL_scopestack_ix, PL_unitcheckav);
3460         PL_eval_start = es;
3461     }
3462
3463     CvDEPTH(evalcv) = 1;
3464     SP = PL_stack_base + POPMARK;               /* pop original mark */
3465     PL_op = saveop;                     /* The caller may need it. */
3466     PL_parser->lex_state = LEX_NOTPARSING;      /* $^S needs this. */
3467
3468     PUTBACK;
3469     return TRUE;
3470 }
3471
3472
3473 STATIC PerlIO *
3474 S_check_type_and_open(pTHX_ SV *name)
3475 {
3476     Stat_t st;
3477     STRLEN len;
3478     PerlIO * retio;
3479     const char *p = SvPV_const(name, len);
3480     int st_rc;
3481
3482     PERL_ARGS_ASSERT_CHECK_TYPE_AND_OPEN;
3483
3484     /* checking here captures a reasonable error message when
3485      * PERL_DISABLE_PMC is true, but when PMC checks are enabled, the
3486      * user gets a confusing message about looking for the .pmc file
3487      * rather than for the .pm file so do the check in S_doopen_pm when
3488      * PMC is on instead of here. S_doopen_pm calls this func.
3489      * This check prevents a \0 in @INC causing problems.
3490      */
3491 #ifdef PERL_DISABLE_PMC
3492     if (!IS_SAFE_PATHNAME(p, len, "require"))
3493         return NULL;
3494 #endif
3495
3496     /* on Win32 stat is expensive (it does an open() and close() twice and
3497        a couple other IO calls), the open will fail with a dir on its own with
3498        errno EACCES, so only do a stat to separate a dir from a real EACCES
3499        caused by user perms */
3500 #ifndef WIN32
3501     /* we use the value of errno later to see how stat() or open() failed.
3502      * We don't want it set if the stat succeeded but we still failed,
3503      * such as if the name exists, but is a directory */
3504     errno = 0;
3505
3506     st_rc = PerlLIO_stat(p, &st);
3507
3508     if (st_rc < 0 || S_ISDIR(st.st_mode) || S_ISBLK(st.st_mode)) {
3509         return NULL;
3510     }
3511 #endif
3512
3513     retio = PerlIO_openn(aTHX_ ":", PERL_SCRIPT_MODE, -1, 0, 0, NULL, 1, &name);
3514 #ifdef WIN32
3515     /* EACCES stops the INC search early in pp_require to implement
3516        feature RT #113422 */
3517     if(!retio && errno == EACCES) { /* exists but probably a directory */
3518         int eno;
3519         st_rc = PerlLIO_stat(p, &st);
3520         if (st_rc >= 0) {
3521             if(S_ISDIR(st.st_mode) || S_ISBLK(st.st_mode))
3522                 eno = 0;
3523             else
3524                 eno = EACCES;
3525             errno = eno;
3526         }
3527     }
3528 #endif
3529     return retio;
3530 }
3531
3532 #ifndef PERL_DISABLE_PMC
3533 STATIC PerlIO *
3534 S_doopen_pm(pTHX_ SV *name)
3535 {
3536     STRLEN namelen;
3537     const char *p = SvPV_const(name, namelen);
3538
3539     PERL_ARGS_ASSERT_DOOPEN_PM;
3540
3541     /* check the name before trying for the .pmc name to avoid the
3542      * warning referring to the .pmc which the user probably doesn't
3543      * know or care about
3544      */
3545     if (!IS_SAFE_PATHNAME(p, namelen, "require"))
3546         return NULL;
3547
3548     if (namelen > 3 && memEQs(p + namelen - 3, 3, ".pm")) {
3549         SV *const pmcsv = sv_newmortal();
3550         PerlIO * pmcio;
3551
3552         SvSetSV_nosteal(pmcsv,name);
3553         sv_catpvs(pmcsv, "c");
3554
3555         pmcio = check_type_and_open(pmcsv);
3556         if (pmcio)
3557             return pmcio;
3558     }
3559     return check_type_and_open(name);
3560 }
3561 #else
3562 #  define doopen_pm(name) check_type_and_open(name)
3563 #endif /* !PERL_DISABLE_PMC */
3564
3565 /* require doesn't search for absolute names, or when the name is
3566    explicitly relative the current directory */
3567 PERL_STATIC_INLINE bool
3568 S_path_is_searchable(const char *name)
3569 {
3570     PERL_ARGS_ASSERT_PATH_IS_SEARCHABLE;
3571
3572     if (PERL_FILE_IS_ABSOLUTE(name)
3573 #ifdef WIN32
3574         || (*name == '.' && ((name[1] == '/' ||
3575                              (name[1] == '.' && name[2] == '/'))
3576                          || (name[1] == '\\' ||
3577                              ( name[1] == '.' && name[2] == '\\')))
3578             )
3579 #else
3580         || (*name == '.' && (name[1] == '/' ||
3581                              (name[1] == '.' && name[2] == '/')))
3582 #endif
3583          )
3584     {
3585         return FALSE;
3586     }
3587     else
3588         return TRUE;
3589 }
3590
3591
3592 /* implement 'require 5.010001' */
3593
3594 static OP *
3595 S_require_version(pTHX_ SV *sv)
3596 {
3597     dVAR; dSP;
3598
3599     sv = sv_2mortal(new_version(sv));
3600     if (!Perl_sv_derived_from_pvn(aTHX_ PL_patchlevel, STR_WITH_LEN("version"), 0))
3601         upg_version(PL_patchlevel, TRUE);
3602     if (cUNOP->op_first->op_type == OP_CONST && cUNOP->op_first->op_private & OPpCONST_NOVER) {
3603         if ( vcmp(sv,PL_patchlevel) <= 0 )
3604             DIE(aTHX_ "Perls since %"SVf" too modern--this is %"SVf", stopped",
3605                 SVfARG(sv_2mortal(vnormal(sv))),
3606                 SVfARG(sv_2mortal(vnormal(PL_patchlevel)))
3607             );
3608     }
3609     else {
3610         if ( vcmp(sv,PL_patchlevel) > 0 ) {
3611             I32 first = 0;
3612             AV *lav;
3613             SV * const req = SvRV(sv);
3614             SV * const pv = *hv_fetchs(MUTABLE_HV(req), "original", FALSE);
3615
3616             /* get the left hand term */
3617             lav = MUTABLE_AV(SvRV(*hv_fetchs(MUTABLE_HV(req), "version", FALSE)));
3618
3619             first  = SvIV(*av_fetch(lav,0,0));
3620             if (   first > (int)PERL_REVISION    /* probably 'use 6.0' */
3621                 || hv_exists(MUTABLE_HV(req), "qv", 2 ) /* qv style */
3622                 || av_tindex(lav) > 1            /* FP with > 3 digits */
3623                 || strstr(SvPVX(pv),".0")        /* FP with leading 0 */
3624                ) {
3625                 DIE(aTHX_ "Perl %"SVf" required--this is only "
3626                     "%"SVf", stopped",
3627                     SVfARG(sv_2mortal(vnormal(req))),
3628                     SVfARG(sv_2mortal(vnormal(PL_patchlevel)))
3629                 );
3630             }
3631             else { /* probably 'use 5.10' or 'use 5.8' */
3632                 SV *hintsv;
3633                 I32 second = 0;
3634
3635                 if (av_tindex(lav)>=1)
3636                     second = SvIV(*av_fetch(lav,1,0));
3637
3638                 second /= second >= 600  ? 100 : 10;
3639                 hintsv = Perl_newSVpvf(aTHX_ "v%d.%d.0",
3640                                        (int)first, (int)second);
3641                 upg_version(hintsv, TRUE);
3642
3643                 DIE(aTHX_ "Perl %"SVf" required (did you mean %"SVf"?)"
3644                     "--this is only %"SVf", stopped",
3645                     SVfARG(sv_2mortal(vnormal(req))),
3646                     SVfARG(sv_2mortal(vnormal(sv_2mortal(hintsv)))),
3647                     SVfARG(sv_2mortal(vnormal(PL_patchlevel)))
3648                 );
3649             }
3650         }
3651     }
3652
3653     RETPUSHYES;
3654 }
3655
3656 /* Handle C<require Foo::Bar>, C<require "Foo/Bar.pm"> and C<do "Foo.pm">.
3657  * The first form will have already been converted at compile time to
3658  * the second form */
3659
3660 static OP *
3661 S_require_file(pTHX_ SV *const sv)
3662 {
3663     dVAR; dSP;
3664
3665     PERL_CONTEXT *cx;
3666     const char *name;
3667     STRLEN len;
3668     char * unixname;
3669     STRLEN unixlen;
3670 #ifdef VMS
3671     int vms_unixname = 0;
3672     char *unixdir;
3673 #endif
3674     const char *tryname = NULL;
3675     SV *namesv = NULL;
3676     const U8 gimme = GIMME_V;
3677     int filter_has_file = 0;
3678     PerlIO *tryrsfp = NULL;
3679     SV *filter_cache = NULL;
3680     SV *filter_state = NULL;
3681     SV *filter_sub = NULL;
3682     SV *hook_sv = NULL;
3683     OP *op;
3684     int saved_errno;
3685     bool path_searchable;
3686     I32 old_savestack_ix;
3687
3688     if (!SvOK(sv))
3689         DIE(aTHX_ "Missing or undefined argument to require");
3690     name = SvPV_nomg_const(sv, len);
3691     if (!(name && len > 0 && *name))
3692         DIE(aTHX_ "Missing or undefined argument to require");
3693
3694     if (!IS_SAFE_PATHNAME(name, len, "require")) {
3695         DIE(aTHX_ "Can't locate %s:   %s",
3696             pv_escape(newSVpvs_flags("",SVs_TEMP),name,len,len*2,
3697                       NULL, SvUTF8(sv)?PERL_PV_ESCAPE_UNI:0),
3698             Strerror(ENOENT));
3699     }
3700     TAINT_PROPER("require");
3701
3702     path_searchable = path_is_searchable(name);
3703
3704 #ifdef VMS
3705     /* The key in the %ENV hash is in the syntax of file passed as the argument
3706      * usually this is in UNIX format, but sometimes in VMS format, which
3707      * can result in a module being pulled in more than once.
3708      * To prevent this, the key must be stored in UNIX format if the VMS
3709      * name can be translated to UNIX.
3710      */
3711     
3712     if ((unixname =
3713           tounixspec(name, SvPVX(sv_2mortal(newSVpv("", VMS_MAXRSS-1)))))
3714          != NULL) {
3715         unixlen = strlen(unixname);
3716         vms_unixname = 1;
3717     }
3718     else
3719 #endif
3720     {
3721         /* if not VMS or VMS name can not be translated to UNIX, pass it
3722          * through.
3723          */
3724         unixname = (char *) name;
3725         unixlen = len;
3726     }
3727     if (PL_op->op_type == OP_REQUIRE) {
3728         SV * const * const svp = hv_fetch(GvHVn(PL_incgv),
3729                                           unixname, unixlen, 0);
3730         if ( svp ) {
3731             if (*svp != &PL_sv_undef)
3732                 RETPUSHYES;
3733             else
3734                 DIE(aTHX_ "Attempt to reload %s aborted.\n"
3735                             "Compilation failed in require", unixname);
3736         }
3737
3738         if (PL_op->op_flags & OPf_KIDS) {
3739             SVOP * const kid = (SVOP*)cUNOP->op_first;
3740
3741             if (kid->op_type == OP_CONST && (kid->op_private & OPpCONST_BARE)) {
3742                 /* require foo (or use foo) with a bareword.
3743                    Perl_load_module fakes up the identical optree, but its
3744                    arguments aren't restricted by the parser to real barewords.
3745                 */
3746                 const STRLEN package_len = len - 3;
3747                 const char slashdot[2] = {'/', '.'};
3748 #ifdef DOSISH
3749                 const char backslashdot[2] = {'\\', '.'};
3750 #endif
3751
3752                 /* Disallow *purported* barewords that map to absolute
3753                    filenames, filenames relative to the current or parent
3754                    directory, or (*nix) hidden filenames.  Also sanity check
3755                    that the generated filename ends .pm  */
3756                 if (!path_searchable || len < 3 || name[0] == '.'
3757                     || !memEQ(name + package_len, ".pm", 3))
3758                     DIE(aTHX_ "Bareword in require maps to disallowed filename \"%"SVf"\"", sv);
3759                 if (memchr(name, 0, package_len)) {
3760                     /* diag_listed_as: Bareword in require contains "%s" */
3761                     DIE(aTHX_ "Bareword in require contains \"\\0\"");
3762                 }
3763                 if (ninstr(name, name + package_len, slashdot,
3764                            slashdot + sizeof(slashdot))) {
3765                     /* diag_listed_as: Bareword in require contains "%s" */
3766                     DIE(aTHX_ "Bareword in require contains \"/.\"");
3767                 }
3768 #ifdef DOSISH
3769                 if (ninstr(name, name + package_len, backslashdot,
3770                            backslashdot + sizeof(backslashdot))) {
3771                     /* diag_listed_as: Bareword in require contains "%s" */
3772                     DIE(aTHX_ "Bareword in require contains \"\\.\"");
3773                 }
3774 #endif
3775             }
3776         }
3777     }
3778
3779     PERL_DTRACE_PROBE_FILE_LOADING(unixname);
3780
3781     /* prepare to compile file */
3782
3783     if (!path_searchable) {
3784         /* At this point, name is SvPVX(sv)  */
3785         tryname = name;
3786         tryrsfp = doopen_pm(sv);
3787     }
3788     if (!tryrsfp && !(errno == EACCES && !path_searchable)) {
3789         AV * const ar = GvAVn(PL_incgv);
3790         SSize_t i;
3791 #ifdef VMS
3792         if (vms_unixname)
3793 #endif
3794         {
3795             SV *nsv = sv;
3796             namesv = newSV_type(SVt_PV);
3797             for (i = 0; i <= AvFILL(ar); i++) {
3798                 SV * const dirsv = *av_fetch(ar, i, TRUE);
3799
3800                 SvGETMAGIC(dirsv);
3801                 if (SvROK(dirsv)) {
3802                     int count;
3803                     SV **svp;
3804                     SV *loader = dirsv;
3805
3806                     if (SvTYPE(SvRV(loader)) == SVt_PVAV
3807                         && !SvOBJECT(SvRV(loader)))
3808                     {
3809                         loader = *av_fetch(MUTABLE_AV(SvRV(loader)), 0, TRUE);
3810                         SvGETMAGIC(loader);
3811                     }
3812
3813                     Perl_sv_setpvf(aTHX_ namesv, "/loader/0x%"UVxf"/%s",
3814                                    PTR2UV(SvRV(dirsv)), name);
3815                     tryname = SvPVX_const(namesv);
3816                     tryrsfp = NULL;
3817
3818                     if (SvPADTMP(nsv)) {
3819                         nsv = sv_newmortal();
3820                         SvSetSV_nosteal(nsv,sv);
3821                     }
3822
3823                     ENTER_with_name("call_INC");
3824                     SAVETMPS;
3825                     EXTEND(SP, 2);
3826
3827                     PUSHMARK(SP);
3828                     PUSHs(dirsv);
3829                     PUSHs(nsv);
3830                     PUTBACK;
3831                     if (SvGMAGICAL(loader)) {
3832                         SV *l = sv_newmortal();
3833                         sv_setsv_nomg(l, loader);
3834                         loader = l;
3835                     }
3836                     if (sv_isobject(loader))
3837                         count = call_method("INC", G_ARRAY);
3838                     else
3839                         count = call_sv(loader, G_ARRAY);
3840                     SPAGAIN;
3841
3842                     if (count > 0) {
3843                         int i = 0;
3844                         SV *arg;
3845
3846                         SP -= count - 1;
3847                         arg = SP[i++];
3848
3849                         if (SvROK(arg) && (SvTYPE(SvRV(arg)) <= SVt_PVLV)
3850                             && !isGV_with_GP(SvRV(arg))) {
3851                             filter_cache = SvRV(arg);
3852
3853                             if (i < count) {
3854                                 arg = SP[i++];
3855                             }
3856                         }
3857
3858                         if (SvROK(arg) && isGV_with_GP(SvRV(arg))) {
3859                             arg = SvRV(arg);
3860                         }
3861
3862                         if (isGV_with_GP(arg)) {
3863                             IO * const io = GvIO((const GV *)arg);
3864
3865                             ++filter_has_file;
3866
3867                             if (io) {
3868                                 tryrsfp = IoIFP(io);
3869                                 if (IoOFP(io) && IoOFP(io) != IoIFP(io)) {
3870                                     PerlIO_close(IoOFP(io));
3871                                 }
3872                                 IoIFP(io) = NULL;
3873                                 IoOFP(io) = NULL;
3874                             }
3875
3876                             if (i < count) {
3877                                 arg = SP[i++];
3878                             }
3879                         }
3880
3881                         if (SvROK(arg) && SvTYPE(SvRV(arg)) == SVt_PVCV) {
3882                             filter_sub = arg;
3883                             SvREFCNT_inc_simple_void_NN(filter_sub);
3884
3885                             if (i < count) {
3886                                 filter_state = SP[i];
3887                                 SvREFCNT_inc_simple_void(filter_state);
3888                             }
3889                         }
3890
3891                         if (!tryrsfp && (filter_cache || filter_sub)) {
3892                             tryrsfp = PerlIO_open(BIT_BUCKET,
3893                                                   PERL_SCRIPT_MODE);
3894                         }
3895                         SP--;
3896                     }
3897
3898                     /* FREETMPS may free our filter_cache */
3899                     SvREFCNT_inc_simple_void(filter_cache);
3900
3901                     PUTBACK;
3902                     FREETMPS;
3903                     LEAVE_with_name("call_INC");
3904
3905                     /* Now re-mortalize it. */
3906                     sv_2mortal(filter_cache);
3907
3908                     /* Adjust file name if the hook has set an %INC entry.
3909                        This needs to happen after the FREETMPS above.  */
3910                     svp = hv_fetch(GvHVn(PL_incgv), name, len, 0);
3911                     if (svp)
3912                         tryname = SvPV_nolen_const(*svp);
3913
3914                     if (tryrsfp) {
3915                         hook_sv = dirsv;
3916                         break;
3917                     }
3918
3919                     filter_has_file = 0;
3920                     filter_cache = NULL;
3921                     if (filter_state) {
3922                         SvREFCNT_dec_NN(filter_state);
3923                         filter_state = NULL;
3924                     }
3925                     if (filter_sub) {
3926                         SvREFCNT_dec_NN(filter_sub);
3927                         filter_sub = NULL;
3928                     }
3929                 }
3930                 else {
3931                   if (path_searchable) {
3932                     const char *dir;
3933                     STRLEN dirlen;
3934
3935                     if (SvOK(dirsv)) {
3936                         dir = SvPV_nomg_const(dirsv, dirlen);
3937                     } else {
3938                         dir = "";
3939                         dirlen = 0;
3940                     }
3941
3942                     if (!IS_SAFE_SYSCALL(dir, dirlen, "@INC entry", "require"))
3943                         continue;
3944 #ifdef VMS
3945                     if ((unixdir =
3946                           tounixpath(dir, SvPVX(sv_2mortal(newSVpv("", VMS_MAXRSS-1)))))
3947                          == NULL)
3948                         continue;
3949                     sv_setpv(namesv, unixdir);
3950                     sv_catpv(namesv, unixname);
3951 #else
3952 #  ifdef __SYMBIAN32__
3953                     if (PL_origfilename[0] &&
3954                         PL_origfilename[1] == ':' &&
3955                         !(dir[0] && dir[1] == ':'))
3956                         Perl_sv_setpvf(aTHX_ namesv,
3957                                        "%c:%s\\%s",
3958                                        PL_origfilename[0],
3959                                        dir, name);
3960                     else
3961                         Perl_sv_setpvf(aTHX_ namesv,
3962                                        "%s\\%s",
3963                                        dir, name);
3964 #  else
3965                     /* The equivalent of                    
3966                        Perl_sv_setpvf(aTHX_ namesv, "%s/%s", dir, name);
3967                        but without the need to parse the format string, or
3968                        call strlen on either pointer, and with the correct
3969                        allocation up front.  */
3970                     {
3971                         char *tmp = SvGROW(namesv, dirlen + len + 2);
3972
3973                         memcpy(tmp, dir, dirlen);
3974                         tmp +=dirlen;
3975
3976                         /* Avoid '<dir>//<file>' */
3977                         if (!dirlen || *(tmp-1) != '/') {
3978                             *tmp++ = '/';
3979                         } else {
3980                             /* So SvCUR_set reports the correct length below */
3981                             dirlen--;
3982                         }
3983
3984                         /* name came from an SV, so it will have a '\0' at the
3985                            end that we can copy as part of this memcpy().  */
3986                         memcpy(tmp, name, len + 1);
3987
3988                         SvCUR_set(namesv, dirlen + len + 1);
3989                         SvPOK_on(namesv);
3990                     }
3991 #  endif
3992 #endif
3993                     TAINT_PROPER("require");
3994                     tryname = SvPVX_const(namesv);
3995                     tryrsfp = doopen_pm(namesv);
3996                     if (tryrsfp) {
3997                         if (tryname[0] == '.' && tryname[1] == '/') {
3998                             ++tryname;
3999                             while (*++tryname == '/') {}
4000                         }
4001                         break;
4002                     }
4003                     else if (errno == EMFILE || errno == EACCES) {
4004                         /* no point in trying other paths if out of handles;
4005                          * on the other hand, if we couldn't open one of the
4006                          * files, then going on with the search could lead to
4007                          * unexpected results; see perl #113422
4008                          */
4009                         break;
4010                     }
4011                   }
4012                 }
4013             }
4014         }
4015     }
4016     saved_errno = errno; /* sv_2mortal can realloc things */
4017     sv_2mortal(namesv);
4018     if (!tryrsfp) {
4019         if (PL_op->op_type == OP_REQUIRE) {
4020             if(saved_errno == EMFILE || saved_errno == EACCES) {
4021                 /* diag_listed_as: Can't locate %s */
4022                 DIE(aTHX_ "Can't locate %s:   %s: %s",
4023                     name, tryname, Strerror(saved_errno));
4024             } else {
4025                 if (namesv) {                   /* did we lookup @INC? */
4026                     AV * const ar = GvAVn(PL_incgv);
4027                     SSize_t i;
4028                     SV *const msg = newSVpvs_flags("", SVs_TEMP);
4029                     SV *const inc = newSVpvs_flags("", SVs_TEMP);
4030                     for (i = 0; i <= AvFILL(ar); i++) {
4031                         sv_catpvs(inc, " ");
4032                         sv_catsv(inc, *av_fetch(ar, i, TRUE));
4033                     }
4034                     if (len >= 4 && memEQ(name + len - 3, ".pm", 4)) {
4035                         const char *c, *e = name + len - 3;
4036                         sv_catpv(msg, " (you may need to install the ");
4037                         for (c = name; c < e; c++) {
4038                             if (*c == '/') {
4039                                 sv_catpvs(msg, "::");
4040                             }
4041                             else {
4042                                 sv_catpvn(msg, c, 1);
4043                             }
4044                         }
4045                         sv_catpv(msg, " module)");
4046                     }
4047                     else if (len >= 2 && memEQ(name + len - 2, ".h", 3)) {
4048                         sv_catpv(msg, " (change .h to .ph maybe?) (did you run h2ph?)");
4049                     }
4050                     else if (len >= 3 && memEQ(name + len - 3, ".ph", 4)) {
4051                         sv_catpv(msg, " (did you run h2ph?)");
4052                     }
4053
4054                     /* diag_listed_as: Can't locate %s */
4055                     DIE(aTHX_
4056                         "Can't locate %s in @INC%" SVf " (@INC contains:%" SVf ")",
4057                         name, msg, inc);
4058                 }
4059             }
4060             DIE(aTHX_ "Can't locate %s", name);
4061         }
4062
4063         CLEAR_ERRSV();
4064         RETPUSHUNDEF;
4065     }
4066     else
4067         SETERRNO(0, SS_NORMAL);
4068
4069     /* Assume success here to prevent recursive requirement. */
4070     /* name is never assigned to again, so len is still strlen(name)  */
4071     /* Check whether a hook in @INC has already filled %INC */
4072     if (!hook_sv) {
4073         (void)hv_store(GvHVn(PL_incgv),
4074                        unixname, unixlen, newSVpv(tryname,0),0);
4075     } else {
4076         SV** const svp = hv_fetch(GvHVn(PL_incgv), unixname, unixlen, 0);
4077         if (!svp)
4078             (void)hv_store(GvHVn(PL_incgv),
4079                            unixname, unixlen, SvREFCNT_inc_simple(hook_sv), 0 );
4080     }
4081
4082     old_savestack_ix = PL_savestack_ix;
4083     SAVECOPFILE_FREE(&PL_compiling);
4084     CopFILE_set(&PL_compiling, tryname);
4085     lex_start(NULL, tryrsfp, 0);
4086
4087     if (filter_sub || filter_cache) {
4088         /* We can use the SvPV of the filter PVIO itself as our cache, rather
4089            than hanging another SV from it. In turn, filter_add() optionally
4090            takes the SV to use as the filter (or creates a new SV if passed
4091            NULL), so simply pass in whatever value filter_cache has.  */
4092         SV * const fc = filter_cache ? newSV(0) : NULL;
4093         SV *datasv;
4094         if (fc) sv_copypv(fc, filter_cache);
4095         datasv = filter_add(S_run_user_filter, fc);
4096         IoLINES(datasv) = filter_has_file;
4097         IoTOP_GV(datasv) = MUTABLE_GV(filter_state);
4098         IoBOTTOM_GV(datasv) = MUTABLE_GV(filter_sub);
4099     }
4100
4101     /* switch to eval mode */
4102     cx = cx_pushblock(CXt_EVAL, gimme, SP, old_savestack_ix);
4103     cx_pusheval(cx, PL_op->op_next, newSVpv(name, 0));
4104
4105     SAVECOPLINE(&PL_compiling);
4106     CopLINE_set(&PL_compiling, 0);
4107
4108     PUTBACK;
4109
4110     if (doeval_compile(gimme, NULL, PL_curcop->cop_seq, NULL))
4111         op = DOCATCH(PL_eval_start);
4112     else
4113         op = PL_op->op_next;
4114
4115     PERL_DTRACE_PROBE_FILE_LOADED(unixname);
4116
4117     return op;
4118 }
4119
4120
4121 /* also used for: pp_dofile() */
4122
4123 PP(pp_require)
4124 {
4125     dSP;
4126     SV *sv = POPs;
4127     SvGETMAGIC(sv);
4128     PUTBACK;
4129     return ((SvNIOKp(sv) || SvVOK(sv)) && PL_op->op_type != OP_DOFILE)
4130         ? S_require_version(aTHX_ sv)
4131         : S_require_file(aTHX_ sv);
4132 }
4133
4134
4135 /* This is a op added to hold the hints hash for
4136    pp_entereval. The hash can be modified by the code
4137    being eval'ed, so we return a copy instead. */
4138
4139 PP(pp_hintseval)
4140 {
4141     dSP;
4142     mXPUSHs(MUTABLE_SV(hv_copy_hints_hv(MUTABLE_HV(cSVOP_sv))));
4143     RETURN;
4144 }
4145
4146
4147 PP(pp_entereval)
4148 {
4149     dSP;
4150     PERL_CONTEXT *cx;
4151     SV *sv;
4152     const U8 gimme = GIMME_V;
4153     const U32 was = PL_breakable_sub_gen;
4154     char tbuf[TYPE_DIGITS(long) + 12];
4155     bool saved_delete = FALSE;
4156     char *tmpbuf = tbuf;
4157     STRLEN len;
4158     CV* runcv;
4159     U32 seq, lex_flags = 0;
4160     HV *saved_hh = NULL;
4161     const bool bytes = PL_op->op_private & OPpEVAL_BYTES;
4162     I32 old_savestack_ix;
4163
4164     if (PL_op->op_private & OPpEVAL_HAS_HH) {
4165         saved_hh = MUTABLE_HV(SvREFCNT_inc(POPs));
4166     }
4167     else if (PL_hints & HINT_LOCALIZE_HH || (
4168                 PL_op->op_private & OPpEVAL_COPHH
4169              && PL_curcop->cop_hints & HINT_LOCALIZE_HH
4170             )) {
4171         saved_hh = cop_hints_2hv(PL_curcop, 0);
4172         hv_magic(saved_hh, NULL, PERL_MAGIC_hints);
4173     }
4174     sv = POPs;
4175     if (!SvPOK(sv)) {
4176         /* make sure we've got a plain PV (no overload etc) before testing
4177          * for taint. Making a copy here is probably overkill, but better
4178          * safe than sorry */
4179         STRLEN len;
4180         const char * const p = SvPV_const(sv, len);
4181
4182         sv = newSVpvn_flags(p, len, SVs_TEMP | SvUTF8(sv));
4183         lex_flags |= LEX_START_COPIED;
4184
4185         if (bytes && SvUTF8(sv))
4186             SvPVbyte_force(sv, len);
4187     }
4188     else if (bytes && SvUTF8(sv)) {
4189         /* Don't modify someone else's scalar */
4190         STRLEN len;
4191         sv = newSVsv(sv);
4192         (void)sv_2mortal(sv);
4193         SvPVbyte_force(sv,len);
4194         lex_flags |= LEX_START_COPIED;
4195     }
4196
4197     TAINT_IF(SvTAINTED(sv));
4198     TAINT_PROPER("eval");
4199
4200     old_savestack_ix = PL_savestack_ix;
4201
4202     lex_start(sv, NULL, lex_flags | (PL_op->op_private & OPpEVAL_UNICODE
4203                            ? LEX_IGNORE_UTF8_HINTS
4204                            : bytes ? LEX_EVALBYTES : LEX_START_SAME_FILTER
4205                         )
4206              );
4207
4208     /* switch to eval mode */
4209
4210     if (PERLDB_NAMEEVAL && CopLINE(PL_curcop)) {
4211         SV * const temp_sv = sv_newmortal();
4212         Perl_sv_setpvf(aTHX_ temp_sv, "_<(eval %lu)[%s:%"IVdf"]",
4213                        (unsigned long)++PL_evalseq,
4214                        CopFILE(PL_curcop), (IV)CopLINE(PL_curcop));
4215         tmpbuf = SvPVX(temp_sv);
4216         len = SvCUR(temp_sv);
4217     }
4218     else
4219         len = my_snprintf(tmpbuf, sizeof(tbuf), "_<(eval %lu)", (unsigned long)++PL_evalseq);
4220     SAVECOPFILE_FREE(&PL_compiling);
4221     CopFILE_set(&PL_compiling, tmpbuf+2);
4222     SAVECOPLINE(&PL_compiling);
4223     CopLINE_set(&PL_compiling, 1);
4224     /* special case: an eval '' executed within the DB package gets lexically
4225      * placed in the first non-DB CV rather than the current CV - this
4226      * allows the debugger to execute code, find lexicals etc, in the
4227      * scope of the code being debugged. Passing &seq gets find_runcv
4228      * to do the dirty work for us */
4229     runcv = find_runcv(&seq);
4230
4231     cx = cx_pushblock((CXt_EVAL|CXp_REAL), gimme, SP, old_savestack_ix);
4232     cx_pusheval(cx, PL_op->op_next, NULL);
4233
4234     /* prepare to compile string */
4235
4236     if (PERLDB_LINE_OR_SAVESRC && PL_curstash != PL_debstash)
4237         save_lines(CopFILEAV(&PL_compiling), PL_parser->linestr);
4238     else {
4239         /* XXX For C<eval "...">s within BEGIN {} blocks, this ends up
4240            deleting the eval's FILEGV from the stash before gv_check() runs
4241            (i.e. before run-time proper). To work around the coredump that
4242            ensues, we always turn GvMULTI_on for any globals that were
4243            introduced within evals. See force_ident(). GSAR 96-10-12 */
4244         char *const safestr = savepvn(tmpbuf, len);
4245         SAVEDELETE(PL_defstash, safestr, len);
4246         saved_delete = TRUE;
4247     }
4248     
4249     PUTBACK;
4250
4251     if (doeval_compile(gimme, runcv, seq, saved_hh)) {
4252         if (was != PL_breakable_sub_gen /* Some subs defined here. */
4253             ?  PERLDB_LINE_OR_SAVESRC
4254             :  PERLDB_SAVESRC_NOSUBS) {
4255             /* Retain the filegv we created.  */
4256         } else if (!saved_delete) {
4257             char *const safestr = savepvn(tmpbuf, len);
4258             SAVEDELETE(PL_defstash, safestr, len);
4259         }
4260         return DOCATCH(PL_eval_start);
4261     } else {
4262         /* We have already left the scope set up earlier thanks to the LEAVE
4263            in doeval_compile().  */
4264         if (was != PL_breakable_sub_gen /* Some subs defined here. */
4265             ?  PERLDB_LINE_OR_SAVESRC
4266             :  PERLDB_SAVESRC_INVALID) {
4267             /* Retain the filegv we created.  */
4268         } else if (!saved_delete) {
4269             (void)hv_delete(PL_defstash, tmpbuf, len, G_DISCARD);
4270         }
4271         return PL_op->op_next;
4272     }
4273 }
4274
4275
4276 /* also tail-called by pp_return */
4277
4278 PP(pp_leaveeval)
4279 {
4280     SV **oldsp;
4281     U8 gimme;
4282     PERL_CONTEXT *cx;
4283     OP *retop;
4284     int failed;
4285     CV *evalcv;
4286     bool keep;
4287
4288     PERL_ASYNC_CHECK();
4289
4290     cx = CX_CUR();
4291     assert(CxTYPE(cx) == CXt_EVAL);
4292
4293     oldsp = PL_stack_base + cx->blk_oldsp;
4294     gimme = cx->blk_gimme;
4295
4296     /* did require return a false value? */
4297     failed =    CxOLD_OP_TYPE(cx) == OP_REQUIRE
4298              && !(gimme == G_SCALAR
4299                     ? SvTRUE(*PL_stack_sp)
4300                     : PL_stack_sp > oldsp);
4301
4302     if (gimme == G_VOID)
4303         PL_stack_sp = oldsp;
4304     else
4305         leave_adjust_stacks(oldsp, oldsp, gimme, 0);
4306
4307     /* the cx_popeval does a leavescope, which frees the optree associated
4308      * with eval, which if it frees the nextstate associated with
4309      * PL_curcop, sets PL_curcop to NULL. Which can mess up freeing a
4310      * regex when running under 'use re Debug' because it needs PL_curcop
4311      * to get the current hints. So restore it early.
4312      */
4313     PL_curcop = cx->blk_oldcop;
4314
4315     /* grab this value before cx_popeval restores the old PL_in_eval */
4316     keep = cBOOL(PL_in_eval & EVAL_KEEPERR);
4317     retop = cx->blk_eval.retop;
4318     evalcv = cx->blk_eval.cv;
4319 #ifdef DEBUGGING
4320     assert(CvDEPTH(evalcv) == 1);
4321 #endif
4322     CvDEPTH(evalcv) = 0;
4323
4324     /* pop the CXt_EVAL, and if a require failed, croak */
4325     S_pop_eval_context_maybe_croak(aTHX_ cx, NULL, failed);
4326
4327     if (!keep)
4328         CLEAR_ERRSV();
4329
4330     return retop;
4331 }
4332
4333 /* Common code for Perl_call_sv and Perl_fold_constants, put here to keep it
4334    close to the related Perl_create_eval_scope.  */
4335 void
4336 Perl_delete_eval_scope(pTHX)
4337 {
4338     PERL_CONTEXT *cx;
4339         
4340     cx = CX_CUR();
4341     CX_LEAVE_SCOPE(cx);
4342     cx_popeval(cx);
4343     cx_popblock(cx);
4344     CX_POP(cx);
4345 }
4346
4347 /* Common-ish code salvaged from Perl_call_sv and pp_entertry, because it was
4348    also needed by Perl_fold_constants.  */
4349 void
4350 Perl_create_eval_scope(pTHX_ OP *retop, U32 flags)
4351 {
4352     PERL_CONTEXT *cx;
4353     const U8 gimme = GIMME_V;
4354         
4355     cx = cx_pushblock((CXt_EVAL|CXp_TRYBLOCK), gimme,
4356                     PL_stack_sp, PL_savestack_ix);
4357     cx_pusheval(cx, retop, NULL);
4358
4359     PL_in_eval = EVAL_INEVAL;
4360     if (flags & G_KEEPERR)
4361         PL_in_eval |= EVAL_KEEPERR;
4362     else
4363         CLEAR_ERRSV();
4364     if (flags & G_FAKINGEVAL) {
4365         PL_eval_root = PL_op; /* Only needed so that goto works right. */
4366     }
4367 }
4368     
4369 PP(pp_entertry)
4370 {
4371     create_eval_scope(cLOGOP->op_other->op_next, 0);
4372     return DOCATCH(PL_op->op_next);
4373 }
4374
4375
4376 /* also tail-called by pp_return */
4377
4378 PP(pp_leavetry)
4379 {
4380     SV **oldsp;
4381     U8 gimme;
4382     PERL_CONTEXT *cx;
4383     OP *retop;
4384
4385     PERL_ASYNC_CHECK();
4386
4387     cx = CX_CUR();
4388     assert(CxTYPE(cx) == CXt_EVAL);
4389     oldsp = PL_stack_base + cx->blk_oldsp;
4390     gimme = cx->blk_gimme;
4391
4392     if (gimme == G_VOID)
4393         PL_stack_sp = oldsp;
4394     else
4395         leave_adjust_stacks(oldsp, oldsp, gimme, 1);
4396     CX_LEAVE_SCOPE(cx);
4397     cx_popeval(cx);
4398     cx_popblock(cx);
4399     retop = cx->blk_eval.retop;
4400     CX_POP(cx);
4401
4402     CLEAR_ERRSV();
4403     return retop;
4404 }
4405
4406 PP(pp_entergiven)
4407 {
4408     dSP;
4409     PERL_CONTEXT *cx;
4410     const U8 gimme = GIMME_V;
4411     SV *origsv = DEFSV;
4412     SV *newsv = POPs;
4413     
4414     assert(!PL_op->op_targ); /* used to be set for lexical $_ */
4415     GvSV(PL_defgv) = SvREFCNT_inc(newsv);
4416
4417     cx = cx_pushblock(CXt_GIVEN, gimme, SP, PL_savestack_ix);
4418     cx_pushgiven(cx, origsv);
4419
4420     RETURN;
4421 }
4422
4423 PP(pp_leavegiven)
4424 {
4425     PERL_CONTEXT *cx;
4426     U8 gimme;
4427     SV **oldsp;
4428     PERL_UNUSED_CONTEXT;
4429
4430     cx = CX_CUR();
4431     assert(CxTYPE(cx) == CXt_GIVEN);
4432     oldsp = PL_stack_base + cx->blk_oldsp;
4433     gimme = cx->blk_gimme;
4434
4435     if (gimme == G_VOID)
4436         PL_stack_sp = oldsp;
4437     else
4438         leave_adjust_stacks(oldsp, oldsp, gimme, 1);
4439
4440     CX_LEAVE_SCOPE(cx);
4441     cx_popgiven(cx);
4442     cx_popblock(cx);
4443     CX_POP(cx);
4444
4445     return NORMAL;
4446 }
4447
4448 /* Helper routines used by pp_smartmatch */
4449 STATIC PMOP *
4450 S_make_matcher(pTHX_ REGEXP *re)
4451 {
4452     PMOP *matcher = (PMOP *) newPMOP(OP_MATCH, OPf_WANT_SCALAR | OPf_STACKED);
4453
4454     PERL_ARGS_ASSERT_MAKE_MATCHER;
4455
4456     PM_SETRE(matcher, ReREFCNT_inc(re));
4457
4458     SAVEFREEOP((OP *) matcher);
4459     ENTER_with_name("matcher"); SAVETMPS;
4460     SAVEOP();
4461     return matcher;
4462 }
4463
4464 STATIC bool
4465 S_matcher_matches_sv(pTHX_ PMOP *matcher, SV *sv)
4466 {
4467     dSP;
4468     bool result;
4469
4470     PERL_ARGS_ASSERT_MATCHER_MATCHES_SV;