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