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