This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Optimise 'if ($a || $b)' and 'unless ($a && $b)' early exit
[perl5.git] / op.c
1 #line 2 "op.c"
2 /*    op.c
3  *
4  *    Copyright (C) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
5  *    2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 by Larry Wall and others
6  *
7  *    You may distribute under the terms of either the GNU General Public
8  *    License or the Artistic License, as specified in the README file.
9  *
10  */
11
12 /*
13  * 'You see: Mr. Drogo, he married poor Miss Primula Brandybuck.  She was
14  *  our Mr. Bilbo's first cousin on the mother's side (her mother being the
15  *  youngest of the Old Took's daughters); and Mr. Drogo was his second
16  *  cousin.  So Mr. Frodo is his first *and* second cousin, once removed
17  *  either way, as the saying is, if you follow me.'       --the Gaffer
18  *
19  *     [p.23 of _The Lord of the Rings_, I/i: "A Long-Expected Party"]
20  */
21
22 /* This file contains the functions that create, manipulate and optimize
23  * the OP structures that hold a compiled perl program.
24  *
25  * A Perl program is compiled into a tree of OPs. Each op contains
26  * structural pointers (eg to its siblings and the next op in the
27  * execution sequence), a pointer to the function that would execute the
28  * op, plus any data specific to that op. For example, an OP_CONST op
29  * points to the pp_const() function and to an SV containing the constant
30  * value. When pp_const() is executed, its job is to push that SV onto the
31  * stack.
32  *
33  * OPs are mainly created by the newFOO() functions, which are mainly
34  * called from the parser (in perly.y) as the code is parsed. For example
35  * the Perl code $a + $b * $c would cause the equivalent of the following
36  * to be called (oversimplifying a bit):
37  *
38  *  newBINOP(OP_ADD, flags,
39  *      newSVREF($a),
40  *      newBINOP(OP_MULTIPLY, flags, newSVREF($b), newSVREF($c))
41  *  )
42  *
43  * Note that during the build of miniperl, a temporary copy of this file
44  * is made, called opmini.c.
45  */
46
47 /*
48 Perl's compiler is essentially a 3-pass compiler with interleaved phases:
49
50     A bottom-up pass
51     A top-down pass
52     An execution-order pass
53
54 The bottom-up pass is represented by all the "newOP" routines and
55 the ck_ routines.  The bottom-upness is actually driven by yacc.
56 So at the point that a ck_ routine fires, we have no idea what the
57 context is, either upward in the syntax tree, or either forward or
58 backward in the execution order.  (The bottom-up parser builds that
59 part of the execution order it knows about, but if you follow the "next"
60 links around, you'll find it's actually a closed loop through the
61 top level node.)
62
63 Whenever the bottom-up parser gets to a node that supplies context to
64 its components, it invokes that portion of the top-down pass that applies
65 to that part of the subtree (and marks the top node as processed, so
66 if a node further up supplies context, it doesn't have to take the
67 plunge again).  As a particular subcase of this, as the new node is
68 built, it takes all the closed execution loops of its subcomponents
69 and links them into a new closed loop for the higher level node.  But
70 it's still not the real execution order.
71
72 The actual execution order is not known till we get a grammar reduction
73 to a top-level unit like a subroutine or file that will be called by
74 "name" rather than via a "next" pointer.  At that point, we can call
75 into peep() to do that code's portion of the 3rd pass.  It has to be
76 recursive, but it's recursive on basic blocks, not on tree nodes.
77 */
78
79 /* To implement user lexical pragmas, there needs to be a way at run time to
80    get the compile time state of %^H for that block.  Storing %^H in every
81    block (or even COP) would be very expensive, so a different approach is
82    taken.  The (running) state of %^H is serialised into a tree of HE-like
83    structs.  Stores into %^H are chained onto the current leaf as a struct
84    refcounted_he * with the key and the value.  Deletes from %^H are saved
85    with a value of PL_sv_placeholder.  The state of %^H at any point can be
86    turned back into a regular HV by walking back up the tree from that point's
87    leaf, ignoring any key you've already seen (placeholder or not), storing
88    the rest into the HV structure, then removing the placeholders. Hence
89    memory is only used to store the %^H deltas from the enclosing COP, rather
90    than the entire %^H on each COP.
91
92    To cause actions on %^H to write out the serialisation records, it has
93    magic type 'H'. This magic (itself) does nothing, but its presence causes
94    the values to gain magic type 'h', which has entries for set and clear.
95    C<Perl_magic_sethint> updates C<PL_compiling.cop_hints_hash> with a store
96    record, with deletes written by C<Perl_magic_clearhint>. C<SAVEHINTS>
97    saves the current C<PL_compiling.cop_hints_hash> on the save stack, so that
98    it will be correctly restored when any inner compiling scope is exited.
99 */
100
101 #include "EXTERN.h"
102 #define PERL_IN_OP_C
103 #include "perl.h"
104 #include "keywords.h"
105 #include "feature.h"
106 #include "regcomp.h"
107
108 #define CALL_PEEP(o) PL_peepp(aTHX_ o)
109 #define CALL_RPEEP(o) PL_rpeepp(aTHX_ o)
110 #define CALL_OPFREEHOOK(o) if (PL_opfreehook) PL_opfreehook(aTHX_ o)
111
112 /* See the explanatory comments above struct opslab in op.h. */
113
114 #ifdef PERL_DEBUG_READONLY_OPS
115 #  define PERL_SLAB_SIZE 128
116 #  define PERL_MAX_SLAB_SIZE 4096
117 #  include <sys/mman.h>
118 #endif
119
120 #ifndef PERL_SLAB_SIZE
121 #  define PERL_SLAB_SIZE 64
122 #endif
123 #ifndef PERL_MAX_SLAB_SIZE
124 #  define PERL_MAX_SLAB_SIZE 2048
125 #endif
126
127 /* rounds up to nearest pointer */
128 #define SIZE_TO_PSIZE(x)        (((x) + sizeof(I32 *) - 1)/sizeof(I32 *))
129 #define DIFF(o,p)               ((size_t)((I32 **)(p) - (I32**)(o)))
130
131 static OPSLAB *
132 S_new_slab(pTHX_ size_t sz)
133 {
134 #ifdef PERL_DEBUG_READONLY_OPS
135     OPSLAB *slab = (OPSLAB *) mmap(0, sz * sizeof(I32 *),
136                                    PROT_READ|PROT_WRITE,
137                                    MAP_ANON|MAP_PRIVATE, -1, 0);
138     DEBUG_m(PerlIO_printf(Perl_debug_log, "mapped %lu at %p\n",
139                           (unsigned long) sz, slab));
140     if (slab == MAP_FAILED) {
141         perror("mmap failed");
142         abort();
143     }
144     slab->opslab_size = (U16)sz;
145 #else
146     OPSLAB *slab = (OPSLAB *)PerlMemShared_calloc(sz, sizeof(I32 *));
147 #endif
148     slab->opslab_first = (OPSLOT *)((I32 **)slab + sz - 1);
149     return slab;
150 }
151
152 /* requires double parens and aTHX_ */
153 #define DEBUG_S_warn(args)                                             \
154     DEBUG_S(                                                            \
155         PerlIO_printf(Perl_debug_log, "%s", SvPVx_nolen(Perl_mess args)) \
156     )
157
158 void *
159 Perl_Slab_Alloc(pTHX_ size_t sz)
160 {
161     dVAR;
162     OPSLAB *slab;
163     OPSLAB *slab2;
164     OPSLOT *slot;
165     OP *o;
166     size_t opsz, space;
167
168     /* We only allocate ops from the slab during subroutine compilation.
169        We find the slab via PL_compcv, hence that must be non-NULL. It could
170        also be pointing to a subroutine which is now fully set up (CvROOT()
171        pointing to the top of the optree for that sub), or a subroutine
172        which isn't using the slab allocator. If our sanity checks aren't met,
173        don't use a slab, but allocate the OP directly from the heap.  */
174     if (!PL_compcv || CvROOT(PL_compcv)
175      || (CvSTART(PL_compcv) && !CvSLABBED(PL_compcv)))
176         return PerlMemShared_calloc(1, sz);
177
178     /* While the subroutine is under construction, the slabs are accessed via
179        CvSTART(), to avoid needing to expand PVCV by one pointer for something
180        unneeded at runtime. Once a subroutine is constructed, the slabs are
181        accessed via CvROOT(). So if CvSTART() is NULL, no slab has been
182        allocated yet.  See the commit message for 8be227ab5eaa23f2 for more
183        details.  */
184     if (!CvSTART(PL_compcv)) {
185         CvSTART(PL_compcv) =
186             (OP *)(slab = S_new_slab(aTHX_ PERL_SLAB_SIZE));
187         CvSLABBED_on(PL_compcv);
188         slab->opslab_refcnt = 2; /* one for the CV; one for the new OP */
189     }
190     else ++(slab = (OPSLAB *)CvSTART(PL_compcv))->opslab_refcnt;
191
192     opsz = SIZE_TO_PSIZE(sz);
193     sz = opsz + OPSLOT_HEADER_P;
194
195     /* The slabs maintain a free list of OPs. In particular, constant folding
196        will free up OPs, so it makes sense to re-use them where possible. A
197        freed up slot is used in preference to a new allocation.  */
198     if (slab->opslab_freed) {
199         OP **too = &slab->opslab_freed;
200         o = *too;
201         DEBUG_S_warn((aTHX_ "found free op at %p, slab %p", o, slab));
202         while (o && DIFF(OpSLOT(o), OpSLOT(o)->opslot_next) < sz) {
203             DEBUG_S_warn((aTHX_ "Alas! too small"));
204             o = *(too = &o->op_next);
205             if (o) { DEBUG_S_warn((aTHX_ "found another free op at %p", o)); }
206         }
207         if (o) {
208             *too = o->op_next;
209             Zero(o, opsz, I32 *);
210             o->op_slabbed = 1;
211             return (void *)o;
212         }
213     }
214
215 #define INIT_OPSLOT \
216             slot->opslot_slab = slab;                   \
217             slot->opslot_next = slab2->opslab_first;    \
218             slab2->opslab_first = slot;                 \
219             o = &slot->opslot_op;                       \
220             o->op_slabbed = 1
221
222     /* The partially-filled slab is next in the chain. */
223     slab2 = slab->opslab_next ? slab->opslab_next : slab;
224     if ((space = DIFF(&slab2->opslab_slots, slab2->opslab_first)) < sz) {
225         /* Remaining space is too small. */
226
227         /* If we can fit a BASEOP, add it to the free chain, so as not
228            to waste it. */
229         if (space >= SIZE_TO_PSIZE(sizeof(OP)) + OPSLOT_HEADER_P) {
230             slot = &slab2->opslab_slots;
231             INIT_OPSLOT;
232             o->op_type = OP_FREED;
233             o->op_next = slab->opslab_freed;
234             slab->opslab_freed = o;
235         }
236
237         /* Create a new slab.  Make this one twice as big. */
238         slot = slab2->opslab_first;
239         while (slot->opslot_next) slot = slot->opslot_next;
240         slab2 = S_new_slab(aTHX_
241                             (DIFF(slab2, slot)+1)*2 > PERL_MAX_SLAB_SIZE
242                                         ? PERL_MAX_SLAB_SIZE
243                                         : (DIFF(slab2, slot)+1)*2);
244         slab2->opslab_next = slab->opslab_next;
245         slab->opslab_next = slab2;
246     }
247     assert(DIFF(&slab2->opslab_slots, slab2->opslab_first) >= sz);
248
249     /* Create a new op slot */
250     slot = (OPSLOT *)((I32 **)slab2->opslab_first - sz);
251     assert(slot >= &slab2->opslab_slots);
252     if (DIFF(&slab2->opslab_slots, slot)
253          < SIZE_TO_PSIZE(sizeof(OP)) + OPSLOT_HEADER_P)
254         slot = &slab2->opslab_slots;
255     INIT_OPSLOT;
256     DEBUG_S_warn((aTHX_ "allocating op at %p, slab %p", o, slab));
257     return (void *)o;
258 }
259
260 #undef INIT_OPSLOT
261
262 #ifdef PERL_DEBUG_READONLY_OPS
263 void
264 Perl_Slab_to_ro(pTHX_ OPSLAB *slab)
265 {
266     PERL_ARGS_ASSERT_SLAB_TO_RO;
267
268     if (slab->opslab_readonly) return;
269     slab->opslab_readonly = 1;
270     for (; slab; slab = slab->opslab_next) {
271         /*DEBUG_U(PerlIO_printf(Perl_debug_log,"mprotect ->ro %lu at %p\n",
272                               (unsigned long) slab->opslab_size, slab));*/
273         if (mprotect(slab, slab->opslab_size * sizeof(I32 *), PROT_READ))
274             Perl_warn(aTHX_ "mprotect for %p %lu failed with %d", slab,
275                              (unsigned long)slab->opslab_size, errno);
276     }
277 }
278
279 void
280 Perl_Slab_to_rw(pTHX_ OPSLAB *const slab)
281 {
282     OPSLAB *slab2;
283
284     PERL_ARGS_ASSERT_SLAB_TO_RW;
285
286     if (!slab->opslab_readonly) return;
287     slab2 = slab;
288     for (; slab2; slab2 = slab2->opslab_next) {
289         /*DEBUG_U(PerlIO_printf(Perl_debug_log,"mprotect ->rw %lu at %p\n",
290                               (unsigned long) size, slab2));*/
291         if (mprotect((void *)slab2, slab2->opslab_size * sizeof(I32 *),
292                      PROT_READ|PROT_WRITE)) {
293             Perl_warn(aTHX_ "mprotect RW for %p %lu failed with %d", slab,
294                              (unsigned long)slab2->opslab_size, errno);
295         }
296     }
297     slab->opslab_readonly = 0;
298 }
299
300 #else
301 #  define Slab_to_rw(op)    NOOP
302 #endif
303
304 /* This cannot possibly be right, but it was copied from the old slab
305    allocator, to which it was originally added, without explanation, in
306    commit 083fcd5. */
307 #ifdef NETWARE
308 #    define PerlMemShared PerlMem
309 #endif
310
311 void
312 Perl_Slab_Free(pTHX_ void *op)
313 {
314     dVAR;
315     OP * const o = (OP *)op;
316     OPSLAB *slab;
317
318     PERL_ARGS_ASSERT_SLAB_FREE;
319
320     if (!o->op_slabbed) {
321         if (!o->op_static)
322             PerlMemShared_free(op);
323         return;
324     }
325
326     slab = OpSLAB(o);
327     /* If this op is already freed, our refcount will get screwy. */
328     assert(o->op_type != OP_FREED);
329     o->op_type = OP_FREED;
330     o->op_next = slab->opslab_freed;
331     slab->opslab_freed = o;
332     DEBUG_S_warn((aTHX_ "free op at %p, recorded in slab %p", o, slab));
333     OpslabREFCNT_dec_padok(slab);
334 }
335
336 void
337 Perl_opslab_free_nopad(pTHX_ OPSLAB *slab)
338 {
339     dVAR;
340     const bool havepad = !!PL_comppad;
341     PERL_ARGS_ASSERT_OPSLAB_FREE_NOPAD;
342     if (havepad) {
343         ENTER;
344         PAD_SAVE_SETNULLPAD();
345     }
346     opslab_free(slab);
347     if (havepad) LEAVE;
348 }
349
350 void
351 Perl_opslab_free(pTHX_ OPSLAB *slab)
352 {
353     dVAR;
354     OPSLAB *slab2;
355     PERL_ARGS_ASSERT_OPSLAB_FREE;
356     DEBUG_S_warn((aTHX_ "freeing slab %p", slab));
357     assert(slab->opslab_refcnt == 1);
358     for (; slab; slab = slab2) {
359         slab2 = slab->opslab_next;
360 #ifdef DEBUGGING
361         slab->opslab_refcnt = ~(size_t)0;
362 #endif
363 #ifdef PERL_DEBUG_READONLY_OPS
364         DEBUG_m(PerlIO_printf(Perl_debug_log, "Deallocate slab at %p\n",
365                                                slab));
366         if (munmap(slab, slab->opslab_size * sizeof(I32 *))) {
367             perror("munmap failed");
368             abort();
369         }
370 #else
371         PerlMemShared_free(slab);
372 #endif
373     }
374 }
375
376 void
377 Perl_opslab_force_free(pTHX_ OPSLAB *slab)
378 {
379     OPSLAB *slab2;
380     OPSLOT *slot;
381 #ifdef DEBUGGING
382     size_t savestack_count = 0;
383 #endif
384     PERL_ARGS_ASSERT_OPSLAB_FORCE_FREE;
385     slab2 = slab;
386     do {
387         for (slot = slab2->opslab_first;
388              slot->opslot_next;
389              slot = slot->opslot_next) {
390             if (slot->opslot_op.op_type != OP_FREED
391              && !(slot->opslot_op.op_savefree
392 #ifdef DEBUGGING
393                   && ++savestack_count
394 #endif
395                  )
396             ) {
397                 assert(slot->opslot_op.op_slabbed);
398                 op_free(&slot->opslot_op);
399                 if (slab->opslab_refcnt == 1) goto free;
400             }
401         }
402     } while ((slab2 = slab2->opslab_next));
403     /* > 1 because the CV still holds a reference count. */
404     if (slab->opslab_refcnt > 1) { /* still referenced by the savestack */
405 #ifdef DEBUGGING
406         assert(savestack_count == slab->opslab_refcnt-1);
407 #endif
408         /* Remove the CV’s reference count. */
409         slab->opslab_refcnt--;
410         return;
411     }
412    free:
413     opslab_free(slab);
414 }
415
416 #ifdef PERL_DEBUG_READONLY_OPS
417 OP *
418 Perl_op_refcnt_inc(pTHX_ OP *o)
419 {
420     if(o) {
421         OPSLAB *const slab = o->op_slabbed ? OpSLAB(o) : NULL;
422         if (slab && slab->opslab_readonly) {
423             Slab_to_rw(slab);
424             ++o->op_targ;
425             Slab_to_ro(slab);
426         } else {
427             ++o->op_targ;
428         }
429     }
430     return o;
431
432 }
433
434 PADOFFSET
435 Perl_op_refcnt_dec(pTHX_ OP *o)
436 {
437     PADOFFSET result;
438     OPSLAB *const slab = o->op_slabbed ? OpSLAB(o) : NULL;
439
440     PERL_ARGS_ASSERT_OP_REFCNT_DEC;
441
442     if (slab && slab->opslab_readonly) {
443         Slab_to_rw(slab);
444         result = --o->op_targ;
445         Slab_to_ro(slab);
446     } else {
447         result = --o->op_targ;
448     }
449     return result;
450 }
451 #endif
452 /*
453  * In the following definition, the ", (OP*)0" is just to make the compiler
454  * think the expression is of the right type: croak actually does a Siglongjmp.
455  */
456 #define CHECKOP(type,o) \
457     ((PL_op_mask && PL_op_mask[type])                           \
458      ? ( op_free((OP*)o),                                       \
459          Perl_croak(aTHX_ "'%s' trapped by operation mask", PL_op_desc[type]),  \
460          (OP*)0 )                                               \
461      : PL_check[type](aTHX_ (OP*)o))
462
463 #define RETURN_UNLIMITED_NUMBER (PERL_INT_MAX / 2)
464
465 #define CHANGE_TYPE(o,type) \
466     STMT_START {                                \
467         o->op_type = (OPCODE)type;              \
468         o->op_ppaddr = PL_ppaddr[type];         \
469     } STMT_END
470
471 STATIC SV*
472 S_gv_ename(pTHX_ GV *gv)
473 {
474     SV* const tmpsv = sv_newmortal();
475
476     PERL_ARGS_ASSERT_GV_ENAME;
477
478     gv_efullname3(tmpsv, gv, NULL);
479     return tmpsv;
480 }
481
482 STATIC OP *
483 S_no_fh_allowed(pTHX_ OP *o)
484 {
485     PERL_ARGS_ASSERT_NO_FH_ALLOWED;
486
487     yyerror(Perl_form(aTHX_ "Missing comma after first argument to %s function",
488                  OP_DESC(o)));
489     return o;
490 }
491
492 STATIC OP *
493 S_too_few_arguments_sv(pTHX_ OP *o, SV *namesv, U32 flags)
494 {
495     PERL_ARGS_ASSERT_TOO_FEW_ARGUMENTS_SV;
496     yyerror_pv(Perl_form(aTHX_ "Not enough arguments for %"SVf, namesv),
497                                     SvUTF8(namesv) | flags);
498     return o;
499 }
500
501 STATIC OP *
502 S_too_few_arguments_pv(pTHX_ OP *o, const char* name, U32 flags)
503 {
504     PERL_ARGS_ASSERT_TOO_FEW_ARGUMENTS_PV;
505     yyerror_pv(Perl_form(aTHX_ "Not enough arguments for %s", name), flags);
506     return o;
507 }
508  
509 STATIC OP *
510 S_too_many_arguments_pv(pTHX_ OP *o, const char *name, U32 flags)
511 {
512     PERL_ARGS_ASSERT_TOO_MANY_ARGUMENTS_PV;
513
514     yyerror_pv(Perl_form(aTHX_ "Too many arguments for %s", name), flags);
515     return o;
516 }
517
518 STATIC OP *
519 S_too_many_arguments_sv(pTHX_ OP *o, SV *namesv, U32 flags)
520 {
521     PERL_ARGS_ASSERT_TOO_MANY_ARGUMENTS_SV;
522
523     yyerror_pv(Perl_form(aTHX_ "Too many arguments for %"SVf, SVfARG(namesv)),
524                 SvUTF8(namesv) | flags);
525     return o;
526 }
527
528 STATIC void
529 S_bad_type_pv(pTHX_ I32 n, const char *t, const char *name, U32 flags, const OP *kid)
530 {
531     PERL_ARGS_ASSERT_BAD_TYPE_PV;
532
533     yyerror_pv(Perl_form(aTHX_ "Type of arg %d to %s must be %s (not %s)",
534                  (int)n, name, t, OP_DESC(kid)), flags);
535 }
536
537 STATIC void
538 S_bad_type_gv(pTHX_ I32 n, const char *t, GV *gv, U32 flags, const OP *kid)
539 {
540     SV * const namesv = gv_ename(gv);
541     PERL_ARGS_ASSERT_BAD_TYPE_GV;
542  
543     yyerror_pv(Perl_form(aTHX_ "Type of arg %d to %"SVf" must be %s (not %s)",
544                  (int)n, SVfARG(namesv), t, OP_DESC(kid)), SvUTF8(namesv) | flags);
545 }
546
547 STATIC void
548 S_no_bareword_allowed(pTHX_ OP *o)
549 {
550     PERL_ARGS_ASSERT_NO_BAREWORD_ALLOWED;
551
552     if (PL_madskills)
553         return;         /* various ok barewords are hidden in extra OP_NULL */
554     qerror(Perl_mess(aTHX_
555                      "Bareword \"%"SVf"\" not allowed while \"strict subs\" in use",
556                      SVfARG(cSVOPo_sv)));
557     o->op_private &= ~OPpCONST_STRICT; /* prevent warning twice about the same OP */
558 }
559
560 /* "register" allocation */
561
562 PADOFFSET
563 Perl_allocmy(pTHX_ const char *const name, const STRLEN len, const U32 flags)
564 {
565     dVAR;
566     PADOFFSET off;
567     const bool is_our = (PL_parser->in_my == KEY_our);
568
569     PERL_ARGS_ASSERT_ALLOCMY;
570
571     if (flags & ~SVf_UTF8)
572         Perl_croak(aTHX_ "panic: allocmy illegal flag bits 0x%" UVxf,
573                    (UV)flags);
574
575     /* Until we're using the length for real, cross check that we're being
576        told the truth.  */
577     assert(strlen(name) == len);
578
579     /* complain about "my $<special_var>" etc etc */
580     if (len &&
581         !(is_our ||
582           isALPHA(name[1]) ||
583           ((flags & SVf_UTF8) && isIDFIRST_utf8((U8 *)name+1)) ||
584           (name[1] == '_' && (*name == '$' || len > 2))))
585     {
586         /* name[2] is true if strlen(name) > 2  */
587         if (!(flags & SVf_UTF8 && UTF8_IS_START(name[1]))
588          && (!isPRINT(name[1]) || strchr("\t\n\r\f", name[1]))) {
589             yyerror(Perl_form(aTHX_ "Can't use global %c^%c%.*s in \"%s\"",
590                               name[0], toCTRL(name[1]), (int)(len - 2), name + 2,
591                               PL_parser->in_my == KEY_state ? "state" : "my"));
592         } else {
593             yyerror_pv(Perl_form(aTHX_ "Can't use global %.*s in \"%s\"", (int) len, name,
594                               PL_parser->in_my == KEY_state ? "state" : "my"), flags & SVf_UTF8);
595         }
596     }
597     else if (len == 2 && name[1] == '_' && !is_our)
598         /* diag_listed_as: Use of my $_ is experimental */
599         Perl_ck_warner_d(aTHX_ packWARN(WARN_EXPERIMENTAL__LEXICAL_TOPIC),
600                               "Use of %s $_ is experimental",
601                                PL_parser->in_my == KEY_state
602                                  ? "state"
603                                  : "my");
604
605     /* allocate a spare slot and store the name in that slot */
606
607     off = pad_add_name_pvn(name, len,
608                        (is_our ? padadd_OUR :
609                         PL_parser->in_my == KEY_state ? padadd_STATE : 0)
610                             | ( flags & SVf_UTF8 ? SVf_UTF8 : 0 ),
611                     PL_parser->in_my_stash,
612                     (is_our
613                         /* $_ is always in main::, even with our */
614                         ? (PL_curstash && !strEQ(name,"$_") ? PL_curstash : PL_defstash)
615                         : NULL
616                     )
617     );
618     /* anon sub prototypes contains state vars should always be cloned,
619      * otherwise the state var would be shared between anon subs */
620
621     if (PL_parser->in_my == KEY_state && CvANON(PL_compcv))
622         CvCLONE_on(PL_compcv);
623
624     return off;
625 }
626
627 /*
628 =for apidoc alloccopstash
629
630 Available only under threaded builds, this function allocates an entry in
631 C<PL_stashpad> for the stash passed to it.
632
633 =cut
634 */
635
636 #ifdef USE_ITHREADS
637 PADOFFSET
638 Perl_alloccopstash(pTHX_ HV *hv)
639 {
640     PADOFFSET off = 0, o = 1;
641     bool found_slot = FALSE;
642
643     PERL_ARGS_ASSERT_ALLOCCOPSTASH;
644
645     if (PL_stashpad[PL_stashpadix] == hv) return PL_stashpadix;
646
647     for (; o < PL_stashpadmax; ++o) {
648         if (PL_stashpad[o] == hv) return PL_stashpadix = o;
649         if (!PL_stashpad[o] || SvTYPE(PL_stashpad[o]) != SVt_PVHV)
650             found_slot = TRUE, off = o;
651     }
652     if (!found_slot) {
653         Renew(PL_stashpad, PL_stashpadmax + 10, HV *);
654         Zero(PL_stashpad + PL_stashpadmax, 10, HV *);
655         off = PL_stashpadmax;
656         PL_stashpadmax += 10;
657     }
658
659     PL_stashpad[PL_stashpadix = off] = hv;
660     return off;
661 }
662 #endif
663
664 /* free the body of an op without examining its contents.
665  * Always use this rather than FreeOp directly */
666
667 static void
668 S_op_destroy(pTHX_ OP *o)
669 {
670     FreeOp(o);
671 }
672
673 /* Destructor */
674
675 void
676 Perl_op_free(pTHX_ OP *o)
677 {
678     dVAR;
679     OPCODE type;
680
681     /* Though ops may be freed twice, freeing the op after its slab is a
682        big no-no. */
683     assert(!o || !o->op_slabbed || OpSLAB(o)->opslab_refcnt != ~(size_t)0); 
684     /* During the forced freeing of ops after compilation failure, kidops
685        may be freed before their parents. */
686     if (!o || o->op_type == OP_FREED)
687         return;
688
689     type = o->op_type;
690     if (o->op_private & OPpREFCOUNTED) {
691         switch (type) {
692         case OP_LEAVESUB:
693         case OP_LEAVESUBLV:
694         case OP_LEAVEEVAL:
695         case OP_LEAVE:
696         case OP_SCOPE:
697         case OP_LEAVEWRITE:
698             {
699             PADOFFSET refcnt;
700             OP_REFCNT_LOCK;
701             refcnt = OpREFCNT_dec(o);
702             OP_REFCNT_UNLOCK;
703             if (refcnt) {
704                 /* Need to find and remove any pattern match ops from the list
705                    we maintain for reset().  */
706                 find_and_forget_pmops(o);
707                 return;
708             }
709             }
710             break;
711         default:
712             break;
713         }
714     }
715
716     /* Call the op_free hook if it has been set. Do it now so that it's called
717      * at the right time for refcounted ops, but still before all of the kids
718      * are freed. */
719     CALL_OPFREEHOOK(o);
720
721     if (o->op_flags & OPf_KIDS) {
722         OP *kid, *nextkid;
723         for (kid = cUNOPo->op_first; kid; kid = nextkid) {
724             nextkid = kid->op_sibling; /* Get before next freeing kid */
725             op_free(kid);
726         }
727     }
728     if (type == OP_NULL)
729         type = (OPCODE)o->op_targ;
730
731     if (o->op_slabbed)
732         Slab_to_rw(OpSLAB(o));
733
734     /* COP* is not cleared by op_clear() so that we may track line
735      * numbers etc even after null() */
736     if (type == OP_NEXTSTATE || type == OP_DBSTATE) {
737         cop_free((COP*)o);
738     }
739
740     op_clear(o);
741     FreeOp(o);
742 #ifdef DEBUG_LEAKING_SCALARS
743     if (PL_op == o)
744         PL_op = NULL;
745 #endif
746 }
747
748 void
749 Perl_op_clear(pTHX_ OP *o)
750 {
751
752     dVAR;
753
754     PERL_ARGS_ASSERT_OP_CLEAR;
755
756 #ifdef PERL_MAD
757     mad_free(o->op_madprop);
758     o->op_madprop = 0;
759 #endif    
760
761  retry:
762     switch (o->op_type) {
763     case OP_NULL:       /* Was holding old type, if any. */
764         if (PL_madskills && o->op_targ != OP_NULL) {
765             o->op_type = (Optype)o->op_targ;
766             o->op_targ = 0;
767             goto retry;
768         }
769     case OP_ENTERTRY:
770     case OP_ENTEREVAL:  /* Was holding hints. */
771         o->op_targ = 0;
772         break;
773     default:
774         if (!(o->op_flags & OPf_REF)
775             || (PL_check[o->op_type] != Perl_ck_ftst))
776             break;
777         /* FALL THROUGH */
778     case OP_GVSV:
779     case OP_GV:
780     case OP_AELEMFAST:
781         {
782             GV *gv = (o->op_type == OP_GV || o->op_type == OP_GVSV)
783 #ifdef USE_ITHREADS
784                         && PL_curpad
785 #endif
786                         ? cGVOPo_gv : NULL;
787             /* It's possible during global destruction that the GV is freed
788                before the optree. Whilst the SvREFCNT_inc is happy to bump from
789                0 to 1 on a freed SV, the corresponding SvREFCNT_dec from 1 to 0
790                will trigger an assertion failure, because the entry to sv_clear
791                checks that the scalar is not already freed.  A check of for
792                !SvIS_FREED(gv) turns out to be invalid, because during global
793                destruction the reference count can be forced down to zero
794                (with SVf_BREAK set).  In which case raising to 1 and then
795                dropping to 0 triggers cleanup before it should happen.  I
796                *think* that this might actually be a general, systematic,
797                weakness of the whole idea of SVf_BREAK, in that code *is*
798                allowed to raise and lower references during global destruction,
799                so any *valid* code that happens to do this during global
800                destruction might well trigger premature cleanup.  */
801             bool still_valid = gv && SvREFCNT(gv);
802
803             if (still_valid)
804                 SvREFCNT_inc_simple_void(gv);
805 #ifdef USE_ITHREADS
806             if (cPADOPo->op_padix > 0) {
807                 /* No GvIN_PAD_off(cGVOPo_gv) here, because other references
808                  * may still exist on the pad */
809                 pad_swipe(cPADOPo->op_padix, TRUE);
810                 cPADOPo->op_padix = 0;
811             }
812 #else
813             SvREFCNT_dec(cSVOPo->op_sv);
814             cSVOPo->op_sv = NULL;
815 #endif
816             if (still_valid) {
817                 int try_downgrade = SvREFCNT(gv) == 2;
818                 SvREFCNT_dec_NN(gv);
819                 if (try_downgrade)
820                     gv_try_downgrade(gv);
821             }
822         }
823         break;
824     case OP_METHOD_NAMED:
825     case OP_CONST:
826     case OP_HINTSEVAL:
827         SvREFCNT_dec(cSVOPo->op_sv);
828         cSVOPo->op_sv = NULL;
829 #ifdef USE_ITHREADS
830         /** Bug #15654
831           Even if op_clear does a pad_free for the target of the op,
832           pad_free doesn't actually remove the sv that exists in the pad;
833           instead it lives on. This results in that it could be reused as 
834           a target later on when the pad was reallocated.
835         **/
836         if(o->op_targ) {
837           pad_swipe(o->op_targ,1);
838           o->op_targ = 0;
839         }
840 #endif
841         break;
842     case OP_DUMP:
843     case OP_GOTO:
844     case OP_NEXT:
845     case OP_LAST:
846     case OP_REDO:
847         if (o->op_flags & (OPf_SPECIAL|OPf_STACKED|OPf_KIDS))
848             break;
849         /* FALL THROUGH */
850     case OP_TRANS:
851     case OP_TRANSR:
852         if (o->op_private & (OPpTRANS_FROM_UTF|OPpTRANS_TO_UTF)) {
853             assert(o->op_type == OP_TRANS || o->op_type == OP_TRANSR);
854 #ifdef USE_ITHREADS
855             if (cPADOPo->op_padix > 0) {
856                 pad_swipe(cPADOPo->op_padix, TRUE);
857                 cPADOPo->op_padix = 0;
858             }
859 #else
860             SvREFCNT_dec(cSVOPo->op_sv);
861             cSVOPo->op_sv = NULL;
862 #endif
863         }
864         else {
865             PerlMemShared_free(cPVOPo->op_pv);
866             cPVOPo->op_pv = NULL;
867         }
868         break;
869     case OP_SUBST:
870         op_free(cPMOPo->op_pmreplrootu.op_pmreplroot);
871         goto clear_pmop;
872     case OP_PUSHRE:
873 #ifdef USE_ITHREADS
874         if (cPMOPo->op_pmreplrootu.op_pmtargetoff) {
875             /* No GvIN_PAD_off here, because other references may still
876              * exist on the pad */
877             pad_swipe(cPMOPo->op_pmreplrootu.op_pmtargetoff, TRUE);
878         }
879 #else
880         SvREFCNT_dec(MUTABLE_SV(cPMOPo->op_pmreplrootu.op_pmtargetgv));
881 #endif
882         /* FALL THROUGH */
883     case OP_MATCH:
884     case OP_QR:
885 clear_pmop:
886         if (!(cPMOPo->op_pmflags & PMf_CODELIST_PRIVATE))
887             op_free(cPMOPo->op_code_list);
888         cPMOPo->op_code_list = NULL;
889         forget_pmop(cPMOPo);
890         cPMOPo->op_pmreplrootu.op_pmreplroot = NULL;
891         /* we use the same protection as the "SAFE" version of the PM_ macros
892          * here since sv_clean_all might release some PMOPs
893          * after PL_regex_padav has been cleared
894          * and the clearing of PL_regex_padav needs to
895          * happen before sv_clean_all
896          */
897 #ifdef USE_ITHREADS
898         if(PL_regex_pad) {        /* We could be in destruction */
899             const IV offset = (cPMOPo)->op_pmoffset;
900             ReREFCNT_dec(PM_GETRE(cPMOPo));
901             PL_regex_pad[offset] = &PL_sv_undef;
902             sv_catpvn_nomg(PL_regex_pad[0], (const char *)&offset,
903                            sizeof(offset));
904         }
905 #else
906         ReREFCNT_dec(PM_GETRE(cPMOPo));
907         PM_SETRE(cPMOPo, NULL);
908 #endif
909
910         break;
911     }
912
913     if (o->op_targ > 0) {
914         pad_free(o->op_targ);
915         o->op_targ = 0;
916     }
917 }
918
919 STATIC void
920 S_cop_free(pTHX_ COP* cop)
921 {
922     PERL_ARGS_ASSERT_COP_FREE;
923
924     CopFILE_free(cop);
925     if (! specialWARN(cop->cop_warnings))
926         PerlMemShared_free(cop->cop_warnings);
927     cophh_free(CopHINTHASH_get(cop));
928     if (PL_curcop == cop)
929        PL_curcop = NULL;
930 }
931
932 STATIC void
933 S_forget_pmop(pTHX_ PMOP *const o
934               )
935 {
936     HV * const pmstash = PmopSTASH(o);
937
938     PERL_ARGS_ASSERT_FORGET_PMOP;
939
940     if (pmstash && !SvIS_FREED(pmstash) && SvMAGICAL(pmstash)) {
941         MAGIC * const mg = mg_find((const SV *)pmstash, PERL_MAGIC_symtab);
942         if (mg) {
943             PMOP **const array = (PMOP**) mg->mg_ptr;
944             U32 count = mg->mg_len / sizeof(PMOP**);
945             U32 i = count;
946
947             while (i--) {
948                 if (array[i] == o) {
949                     /* Found it. Move the entry at the end to overwrite it.  */
950                     array[i] = array[--count];
951                     mg->mg_len = count * sizeof(PMOP**);
952                     /* Could realloc smaller at this point always, but probably
953                        not worth it. Probably worth free()ing if we're the
954                        last.  */
955                     if(!count) {
956                         Safefree(mg->mg_ptr);
957                         mg->mg_ptr = NULL;
958                     }
959                     break;
960                 }
961             }
962         }
963     }
964     if (PL_curpm == o) 
965         PL_curpm = NULL;
966 }
967
968 STATIC void
969 S_find_and_forget_pmops(pTHX_ OP *o)
970 {
971     PERL_ARGS_ASSERT_FIND_AND_FORGET_PMOPS;
972
973     if (o->op_flags & OPf_KIDS) {
974         OP *kid = cUNOPo->op_first;
975         while (kid) {
976             switch (kid->op_type) {
977             case OP_SUBST:
978             case OP_PUSHRE:
979             case OP_MATCH:
980             case OP_QR:
981                 forget_pmop((PMOP*)kid);
982             }
983             find_and_forget_pmops(kid);
984             kid = kid->op_sibling;
985         }
986     }
987 }
988
989 void
990 Perl_op_null(pTHX_ OP *o)
991 {
992     dVAR;
993
994     PERL_ARGS_ASSERT_OP_NULL;
995
996     if (o->op_type == OP_NULL)
997         return;
998     if (!PL_madskills)
999         op_clear(o);
1000     o->op_targ = o->op_type;
1001     o->op_type = OP_NULL;
1002     o->op_ppaddr = PL_ppaddr[OP_NULL];
1003 }
1004
1005 void
1006 Perl_op_refcnt_lock(pTHX)
1007 {
1008     dVAR;
1009     PERL_UNUSED_CONTEXT;
1010     OP_REFCNT_LOCK;
1011 }
1012
1013 void
1014 Perl_op_refcnt_unlock(pTHX)
1015 {
1016     dVAR;
1017     PERL_UNUSED_CONTEXT;
1018     OP_REFCNT_UNLOCK;
1019 }
1020
1021 /* Contextualizers */
1022
1023 /*
1024 =for apidoc Am|OP *|op_contextualize|OP *o|I32 context
1025
1026 Applies a syntactic context to an op tree representing an expression.
1027 I<o> is the op tree, and I<context> must be C<G_SCALAR>, C<G_ARRAY>,
1028 or C<G_VOID> to specify the context to apply.  The modified op tree
1029 is returned.
1030
1031 =cut
1032 */
1033
1034 OP *
1035 Perl_op_contextualize(pTHX_ OP *o, I32 context)
1036 {
1037     PERL_ARGS_ASSERT_OP_CONTEXTUALIZE;
1038     switch (context) {
1039         case G_SCALAR: return scalar(o);
1040         case G_ARRAY:  return list(o);
1041         case G_VOID:   return scalarvoid(o);
1042         default:
1043             Perl_croak(aTHX_ "panic: op_contextualize bad context %ld",
1044                        (long) context);
1045             return o;
1046     }
1047 }
1048
1049 /*
1050 =head1 Optree Manipulation Functions
1051
1052 =for apidoc Am|OP*|op_linklist|OP *o
1053 This function is the implementation of the L</LINKLIST> macro. It should
1054 not be called directly.
1055
1056 =cut
1057 */
1058
1059 OP *
1060 Perl_op_linklist(pTHX_ OP *o)
1061 {
1062     OP *first;
1063
1064     PERL_ARGS_ASSERT_OP_LINKLIST;
1065
1066     if (o->op_next)
1067         return o->op_next;
1068
1069     /* establish postfix order */
1070     first = cUNOPo->op_first;
1071     if (first) {
1072         OP *kid;
1073         o->op_next = LINKLIST(first);
1074         kid = first;
1075         for (;;) {
1076             if (kid->op_sibling) {
1077                 kid->op_next = LINKLIST(kid->op_sibling);
1078                 kid = kid->op_sibling;
1079             } else {
1080                 kid->op_next = o;
1081                 break;
1082             }
1083         }
1084     }
1085     else
1086         o->op_next = o;
1087
1088     return o->op_next;
1089 }
1090
1091 static OP *
1092 S_scalarkids(pTHX_ OP *o)
1093 {
1094     if (o && o->op_flags & OPf_KIDS) {
1095         OP *kid;
1096         for (kid = cLISTOPo->op_first; kid; kid = kid->op_sibling)
1097             scalar(kid);
1098     }
1099     return o;
1100 }
1101
1102 STATIC OP *
1103 S_scalarboolean(pTHX_ OP *o)
1104 {
1105     dVAR;
1106
1107     PERL_ARGS_ASSERT_SCALARBOOLEAN;
1108
1109     if (o->op_type == OP_SASSIGN && cBINOPo->op_first->op_type == OP_CONST
1110      && !(cBINOPo->op_first->op_flags & OPf_SPECIAL)) {
1111         if (ckWARN(WARN_SYNTAX)) {
1112             const line_t oldline = CopLINE(PL_curcop);
1113
1114             if (PL_parser && PL_parser->copline != NOLINE) {
1115                 /* This ensures that warnings are reported at the first line
1116                    of the conditional, not the last.  */
1117                 CopLINE_set(PL_curcop, PL_parser->copline);
1118             }
1119             Perl_warner(aTHX_ packWARN(WARN_SYNTAX), "Found = in conditional, should be ==");
1120             CopLINE_set(PL_curcop, oldline);
1121         }
1122     }
1123     return scalar(o);
1124 }
1125
1126 static SV *
1127 S_op_varname(pTHX_ const OP *o)
1128 {
1129     assert(o);
1130     assert(o->op_type == OP_PADAV || o->op_type == OP_RV2AV ||
1131            o->op_type == OP_PADHV || o->op_type == OP_RV2HV);
1132     {
1133         const char funny  = o->op_type == OP_PADAV
1134                          || o->op_type == OP_RV2AV ? '@' : '%';
1135         if (o->op_type == OP_RV2AV || o->op_type == OP_RV2HV) {
1136             GV *gv;
1137             if (cUNOPo->op_first->op_type != OP_GV
1138              || !(gv = cGVOPx_gv(cUNOPo->op_first)))
1139                 return NULL;
1140             return varname(gv, funny, 0, NULL, 0, 1);
1141         }
1142         return
1143             varname(MUTABLE_GV(PL_compcv), funny, o->op_targ, NULL, 0, 1);
1144     }
1145 }
1146
1147 static void
1148 S_op_pretty(pTHX_ const OP *o, SV **retsv, const char **retpv)
1149 { /* or not so pretty :-) */
1150     if (o->op_type == OP_CONST) {
1151         *retsv = cSVOPo_sv;
1152         if (SvPOK(*retsv)) {
1153             SV *sv = *retsv;
1154             *retsv = sv_newmortal();
1155             pv_pretty(*retsv, SvPVX_const(sv), SvCUR(sv), 32, NULL, NULL,
1156                       PERL_PV_PRETTY_DUMP |PERL_PV_ESCAPE_UNI_DETECT);
1157         }
1158         else if (!SvOK(*retsv))
1159             *retpv = "undef";
1160     }
1161     else *retpv = "...";
1162 }
1163
1164 static void
1165 S_scalar_slice_warning(pTHX_ const OP *o)
1166 {
1167     OP *kid;
1168     const char lbrack =
1169         o->op_type == OP_HSLICE ? '{' : '[';
1170     const char rbrack =
1171         o->op_type == OP_HSLICE ? '}' : ']';
1172     SV *name;
1173     SV *keysv = NULL; /* just to silence compiler warnings */
1174     const char *key = NULL;
1175
1176     if (!(o->op_private & OPpSLICEWARNING))
1177         return;
1178     if (PL_parser && PL_parser->error_count)
1179         /* This warning can be nonsensical when there is a syntax error. */
1180         return;
1181
1182     kid = cLISTOPo->op_first;
1183     kid = kid->op_sibling; /* get past pushmark */
1184     /* weed out false positives: any ops that can return lists */
1185     switch (kid->op_type) {
1186     case OP_BACKTICK:
1187     case OP_GLOB:
1188     case OP_READLINE:
1189     case OP_MATCH:
1190     case OP_RV2AV:
1191     case OP_EACH:
1192     case OP_VALUES:
1193     case OP_KEYS:
1194     case OP_SPLIT:
1195     case OP_LIST:
1196     case OP_SORT:
1197     case OP_REVERSE:
1198     case OP_ENTERSUB:
1199     case OP_CALLER:
1200     case OP_LSTAT:
1201     case OP_STAT:
1202     case OP_READDIR:
1203     case OP_SYSTEM:
1204     case OP_TMS:
1205     case OP_LOCALTIME:
1206     case OP_GMTIME:
1207     case OP_ENTEREVAL:
1208     case OP_REACH:
1209     case OP_RKEYS:
1210     case OP_RVALUES:
1211         return;
1212     }
1213     assert(kid->op_sibling);
1214     name = S_op_varname(aTHX_ kid->op_sibling);
1215     if (!name) /* XS module fiddling with the op tree */
1216         return;
1217     S_op_pretty(aTHX_ kid, &keysv, &key);
1218     assert(SvPOK(name));
1219     sv_chop(name,SvPVX(name)+1);
1220     if (key)
1221        /* diag_listed_as: Scalar value @%s[%s] better written as $%s[%s] */
1222         Perl_warner(aTHX_ packWARN(WARN_SYNTAX),
1223                    "Scalar value @%"SVf"%c%s%c better written as $%"SVf
1224                    "%c%s%c",
1225                     SVfARG(name), lbrack, key, rbrack, SVfARG(name),
1226                     lbrack, key, rbrack);
1227     else
1228        /* diag_listed_as: Scalar value @%s[%s] better written as $%s[%s] */
1229         Perl_warner(aTHX_ packWARN(WARN_SYNTAX),
1230                    "Scalar value @%"SVf"%c%"SVf"%c better written as $%"
1231                     SVf"%c%"SVf"%c",
1232                     SVfARG(name), lbrack, keysv, rbrack,
1233                     SVfARG(name), lbrack, keysv, rbrack);
1234 }
1235
1236 OP *
1237 Perl_scalar(pTHX_ OP *o)
1238 {
1239     dVAR;
1240     OP *kid;
1241
1242     /* assumes no premature commitment */
1243     if (!o || (PL_parser && PL_parser->error_count)
1244          || (o->op_flags & OPf_WANT)
1245          || o->op_type == OP_RETURN)
1246     {
1247         return o;
1248     }
1249
1250     o->op_flags = (o->op_flags & ~OPf_WANT) | OPf_WANT_SCALAR;
1251
1252     switch (o->op_type) {
1253     case OP_REPEAT:
1254         scalar(cBINOPo->op_first);
1255         break;
1256     case OP_OR:
1257     case OP_AND:
1258     case OP_COND_EXPR:
1259         for (kid = cUNOPo->op_first->op_sibling; kid; kid = kid->op_sibling)
1260             scalar(kid);
1261         break;
1262         /* FALL THROUGH */
1263     case OP_SPLIT:
1264     case OP_MATCH:
1265     case OP_QR:
1266     case OP_SUBST:
1267     case OP_NULL:
1268     default:
1269         if (o->op_flags & OPf_KIDS) {
1270             for (kid = cUNOPo->op_first; kid; kid = kid->op_sibling)
1271                 scalar(kid);
1272         }
1273         break;
1274     case OP_LEAVE:
1275     case OP_LEAVETRY:
1276         kid = cLISTOPo->op_first;
1277         scalar(kid);
1278         kid = kid->op_sibling;
1279     do_kids:
1280         while (kid) {
1281             OP *sib = kid->op_sibling;
1282             if (sib && kid->op_type != OP_LEAVEWHEN)
1283                 scalarvoid(kid);
1284             else
1285                 scalar(kid);
1286             kid = sib;
1287         }
1288         PL_curcop = &PL_compiling;
1289         break;
1290     case OP_SCOPE:
1291     case OP_LINESEQ:
1292     case OP_LIST:
1293         kid = cLISTOPo->op_first;
1294         goto do_kids;
1295     case OP_SORT:
1296         Perl_ck_warner(aTHX_ packWARN(WARN_VOID), "Useless use of sort in scalar context");
1297         break;
1298     case OP_KVHSLICE:
1299     case OP_KVASLICE:
1300     {
1301         /* Warn about scalar context */
1302         const char lbrack = o->op_type == OP_KVHSLICE ? '{' : '[';
1303         const char rbrack = o->op_type == OP_KVHSLICE ? '}' : ']';
1304         SV *name;
1305         SV *keysv;
1306         const char *key = NULL;
1307
1308         /* This warning can be nonsensical when there is a syntax error. */
1309         if (PL_parser && PL_parser->error_count)
1310             break;
1311
1312         if (!ckWARN(WARN_SYNTAX)) break;
1313
1314         kid = cLISTOPo->op_first;
1315         kid = kid->op_sibling; /* get past pushmark */
1316         assert(kid->op_sibling);
1317         name = S_op_varname(aTHX_ kid->op_sibling);
1318         if (!name) /* XS module fiddling with the op tree */
1319             break;
1320         S_op_pretty(aTHX_ kid, &keysv, &key);
1321         assert(SvPOK(name));
1322         sv_chop(name,SvPVX(name)+1);
1323         if (key)
1324   /* diag_listed_as: %%s[%s] in scalar context better written as $%s[%s] */
1325             Perl_warner(aTHX_ packWARN(WARN_SYNTAX),
1326                        "%%%"SVf"%c%s%c in scalar context better written "
1327                        "as $%"SVf"%c%s%c",
1328                         SVfARG(name), lbrack, key, rbrack, SVfARG(name),
1329                         lbrack, key, rbrack);
1330         else
1331   /* diag_listed_as: %%s[%s] in scalar context better written as $%s[%s] */
1332             Perl_warner(aTHX_ packWARN(WARN_SYNTAX),
1333                        "%%%"SVf"%c%"SVf"%c in scalar context better "
1334                        "written as $%"SVf"%c%"SVf"%c",
1335                         SVfARG(name), lbrack, keysv, rbrack,
1336                         SVfARG(name), lbrack, keysv, rbrack);
1337     }
1338     }
1339     return o;
1340 }
1341
1342 OP *
1343 Perl_scalarvoid(pTHX_ OP *o)
1344 {
1345     dVAR;
1346     OP *kid;
1347     SV *useless_sv = NULL;
1348     const char* useless = NULL;
1349     SV* sv;
1350     U8 want;
1351
1352     PERL_ARGS_ASSERT_SCALARVOID;
1353
1354     /* trailing mad null ops don't count as "there" for void processing */
1355     if (PL_madskills &&
1356         o->op_type != OP_NULL &&
1357         o->op_sibling &&
1358         o->op_sibling->op_type == OP_NULL)
1359     {
1360         OP *sib;
1361         for (sib = o->op_sibling;
1362                 sib && sib->op_type == OP_NULL;
1363                 sib = sib->op_sibling) ;
1364         
1365         if (!sib)
1366             return o;
1367     }
1368
1369     if (o->op_type == OP_NEXTSTATE
1370         || o->op_type == OP_DBSTATE
1371         || (o->op_type == OP_NULL && (o->op_targ == OP_NEXTSTATE
1372                                       || o->op_targ == OP_DBSTATE)))
1373         PL_curcop = (COP*)o;            /* for warning below */
1374
1375     /* assumes no premature commitment */
1376     want = o->op_flags & OPf_WANT;
1377     if ((want && want != OPf_WANT_SCALAR)
1378          || (PL_parser && PL_parser->error_count)
1379          || o->op_type == OP_RETURN || o->op_type == OP_REQUIRE || o->op_type == OP_LEAVEWHEN)
1380     {
1381         return o;
1382     }
1383
1384     if ((o->op_private & OPpTARGET_MY)
1385         && (PL_opargs[o->op_type] & OA_TARGLEX))/* OPp share the meaning */
1386     {
1387         return scalar(o);                       /* As if inside SASSIGN */
1388     }
1389
1390     o->op_flags = (o->op_flags & ~OPf_WANT) | OPf_WANT_VOID;
1391
1392     switch (o->op_type) {
1393     default:
1394         if (!(PL_opargs[o->op_type] & OA_FOLDCONST))
1395             break;
1396         /* FALL THROUGH */
1397     case OP_REPEAT:
1398         if (o->op_flags & OPf_STACKED)
1399             break;
1400         goto func_ops;
1401     case OP_SUBSTR:
1402         if (o->op_private == 4)
1403             break;
1404         /* FALL THROUGH */
1405     case OP_GVSV:
1406     case OP_WANTARRAY:
1407     case OP_GV:
1408     case OP_SMARTMATCH:
1409     case OP_PADSV:
1410     case OP_PADAV:
1411     case OP_PADHV:
1412     case OP_PADANY:
1413     case OP_AV2ARYLEN:
1414     case OP_REF:
1415     case OP_REFGEN:
1416     case OP_SREFGEN:
1417     case OP_DEFINED:
1418     case OP_HEX:
1419     case OP_OCT:
1420     case OP_LENGTH:
1421     case OP_VEC:
1422     case OP_INDEX:
1423     case OP_RINDEX:
1424     case OP_SPRINTF:
1425     case OP_AELEM:
1426     case OP_AELEMFAST:
1427     case OP_AELEMFAST_LEX:
1428     case OP_ASLICE:
1429     case OP_KVASLICE:
1430     case OP_HELEM:
1431     case OP_HSLICE:
1432     case OP_KVHSLICE:
1433     case OP_UNPACK:
1434     case OP_PACK:
1435     case OP_JOIN:
1436     case OP_LSLICE:
1437     case OP_ANONLIST:
1438     case OP_ANONHASH:
1439     case OP_SORT:
1440     case OP_REVERSE:
1441     case OP_RANGE:
1442     case OP_FLIP:
1443     case OP_FLOP:
1444     case OP_CALLER:
1445     case OP_FILENO:
1446     case OP_EOF:
1447     case OP_TELL:
1448     case OP_GETSOCKNAME:
1449     case OP_GETPEERNAME:
1450     case OP_READLINK:
1451     case OP_TELLDIR:
1452     case OP_GETPPID:
1453     case OP_GETPGRP:
1454     case OP_GETPRIORITY:
1455     case OP_TIME:
1456     case OP_TMS:
1457     case OP_LOCALTIME:
1458     case OP_GMTIME:
1459     case OP_GHBYNAME:
1460     case OP_GHBYADDR:
1461     case OP_GHOSTENT:
1462     case OP_GNBYNAME:
1463     case OP_GNBYADDR:
1464     case OP_GNETENT:
1465     case OP_GPBYNAME:
1466     case OP_GPBYNUMBER:
1467     case OP_GPROTOENT:
1468     case OP_GSBYNAME:
1469     case OP_GSBYPORT:
1470     case OP_GSERVENT:
1471     case OP_GPWNAM:
1472     case OP_GPWUID:
1473     case OP_GGRNAM:
1474     case OP_GGRGID:
1475     case OP_GETLOGIN:
1476     case OP_PROTOTYPE:
1477     case OP_RUNCV:
1478       func_ops:
1479         if (!(o->op_private & (OPpLVAL_INTRO|OPpOUR_INTRO)))
1480             /* Otherwise it's "Useless use of grep iterator" */
1481             useless = OP_DESC(o);
1482         break;
1483
1484     case OP_SPLIT:
1485         kid = cLISTOPo->op_first;
1486         if (kid && kid->op_type == OP_PUSHRE
1487 #ifdef USE_ITHREADS
1488                 && !((PMOP*)kid)->op_pmreplrootu.op_pmtargetoff)
1489 #else
1490                 && !((PMOP*)kid)->op_pmreplrootu.op_pmtargetgv)
1491 #endif
1492             useless = OP_DESC(o);
1493         break;
1494
1495     case OP_NOT:
1496        kid = cUNOPo->op_first;
1497        if (kid->op_type != OP_MATCH && kid->op_type != OP_SUBST &&
1498            kid->op_type != OP_TRANS && kid->op_type != OP_TRANSR) {
1499                 goto func_ops;
1500        }
1501        useless = "negative pattern binding (!~)";
1502        break;
1503
1504     case OP_SUBST:
1505         if (cPMOPo->op_pmflags & PMf_NONDESTRUCT)
1506             useless = "non-destructive substitution (s///r)";
1507         break;
1508
1509     case OP_TRANSR:
1510         useless = "non-destructive transliteration (tr///r)";
1511         break;
1512
1513     case OP_RV2GV:
1514     case OP_RV2SV:
1515     case OP_RV2AV:
1516     case OP_RV2HV:
1517         if (!(o->op_private & (OPpLVAL_INTRO|OPpOUR_INTRO)) &&
1518                 (!o->op_sibling || o->op_sibling->op_type != OP_READLINE))
1519             useless = "a variable";
1520         break;
1521
1522     case OP_CONST:
1523         sv = cSVOPo_sv;
1524         if (cSVOPo->op_private & OPpCONST_STRICT)
1525             no_bareword_allowed(o);
1526         else {
1527             if (ckWARN(WARN_VOID)) {
1528                 /* don't warn on optimised away booleans, eg 
1529                  * use constant Foo, 5; Foo || print; */
1530                 if (cSVOPo->op_private & OPpCONST_SHORTCIRCUIT)
1531                     useless = NULL;
1532                 /* the constants 0 and 1 are permitted as they are
1533                    conventionally used as dummies in constructs like
1534                         1 while some_condition_with_side_effects;  */
1535                 else if (SvNIOK(sv) && (SvNV(sv) == 0.0 || SvNV(sv) == 1.0))
1536                     useless = NULL;
1537                 else if (SvPOK(sv)) {
1538                     SV * const dsv = newSVpvs("");
1539                     useless_sv
1540                         = Perl_newSVpvf(aTHX_
1541                                         "a constant (%s)",
1542                                         pv_pretty(dsv, SvPVX_const(sv),
1543                                                   SvCUR(sv), 32, NULL, NULL,
1544                                                   PERL_PV_PRETTY_DUMP
1545                                                   | PERL_PV_ESCAPE_NOCLEAR
1546                                                   | PERL_PV_ESCAPE_UNI_DETECT));
1547                     SvREFCNT_dec_NN(dsv);
1548                 }
1549                 else if (SvOK(sv)) {
1550                     useless_sv = Perl_newSVpvf(aTHX_ "a constant (%"SVf")", sv);
1551                 }
1552                 else
1553                     useless = "a constant (undef)";
1554             }
1555         }
1556         op_null(o);             /* don't execute or even remember it */
1557         break;
1558
1559     case OP_POSTINC:
1560         o->op_type = OP_PREINC;         /* pre-increment is faster */
1561         o->op_ppaddr = PL_ppaddr[OP_PREINC];
1562         break;
1563
1564     case OP_POSTDEC:
1565         o->op_type = OP_PREDEC;         /* pre-decrement is faster */
1566         o->op_ppaddr = PL_ppaddr[OP_PREDEC];
1567         break;
1568
1569     case OP_I_POSTINC:
1570         o->op_type = OP_I_PREINC;       /* pre-increment is faster */
1571         o->op_ppaddr = PL_ppaddr[OP_I_PREINC];
1572         break;
1573
1574     case OP_I_POSTDEC:
1575         o->op_type = OP_I_PREDEC;       /* pre-decrement is faster */
1576         o->op_ppaddr = PL_ppaddr[OP_I_PREDEC];
1577         break;
1578
1579     case OP_SASSIGN: {
1580         OP *rv2gv;
1581         UNOP *refgen, *rv2cv;
1582         LISTOP *exlist;
1583
1584         if ((o->op_private & ~OPpASSIGN_BACKWARDS) != 2)
1585             break;
1586
1587         rv2gv = ((BINOP *)o)->op_last;
1588         if (!rv2gv || rv2gv->op_type != OP_RV2GV)
1589             break;
1590
1591         refgen = (UNOP *)((BINOP *)o)->op_first;
1592
1593         if (!refgen || refgen->op_type != OP_REFGEN)
1594             break;
1595
1596         exlist = (LISTOP *)refgen->op_first;
1597         if (!exlist || exlist->op_type != OP_NULL
1598             || exlist->op_targ != OP_LIST)
1599             break;
1600
1601         if (exlist->op_first->op_type != OP_PUSHMARK)
1602             break;
1603
1604         rv2cv = (UNOP*)exlist->op_last;
1605
1606         if (rv2cv->op_type != OP_RV2CV)
1607             break;
1608
1609         assert ((rv2gv->op_private & OPpDONT_INIT_GV) == 0);
1610         assert ((o->op_private & OPpASSIGN_CV_TO_GV) == 0);
1611         assert ((rv2cv->op_private & OPpMAY_RETURN_CONSTANT) == 0);
1612
1613         o->op_private |= OPpASSIGN_CV_TO_GV;
1614         rv2gv->op_private |= OPpDONT_INIT_GV;
1615         rv2cv->op_private |= OPpMAY_RETURN_CONSTANT;
1616
1617         break;
1618     }
1619
1620     case OP_AASSIGN: {
1621         inplace_aassign(o);
1622         break;
1623     }
1624
1625     case OP_OR:
1626     case OP_AND:
1627         kid = cLOGOPo->op_first;
1628         if (kid->op_type == OP_NOT
1629             && (kid->op_flags & OPf_KIDS)
1630             && !PL_madskills) {
1631             if (o->op_type == OP_AND) {
1632                 o->op_type = OP_OR;
1633                 o->op_ppaddr = PL_ppaddr[OP_OR];
1634             } else {
1635                 o->op_type = OP_AND;
1636                 o->op_ppaddr = PL_ppaddr[OP_AND];
1637             }
1638             op_null(kid);
1639         }
1640
1641     case OP_DOR:
1642     case OP_COND_EXPR:
1643     case OP_ENTERGIVEN:
1644     case OP_ENTERWHEN:
1645         for (kid = cUNOPo->op_first->op_sibling; kid; kid = kid->op_sibling)
1646             scalarvoid(kid);
1647         break;
1648
1649     case OP_NULL:
1650         if (o->op_flags & OPf_STACKED)
1651             break;
1652         /* FALL THROUGH */
1653     case OP_NEXTSTATE:
1654     case OP_DBSTATE:
1655     case OP_ENTERTRY:
1656     case OP_ENTER:
1657         if (!(o->op_flags & OPf_KIDS))
1658             break;
1659         /* FALL THROUGH */
1660     case OP_SCOPE:
1661     case OP_LEAVE:
1662     case OP_LEAVETRY:
1663     case OP_LEAVELOOP:
1664     case OP_LINESEQ:
1665     case OP_LIST:
1666     case OP_LEAVEGIVEN:
1667     case OP_LEAVEWHEN:
1668         for (kid = cLISTOPo->op_first; kid; kid = kid->op_sibling)
1669             scalarvoid(kid);
1670         break;
1671     case OP_ENTEREVAL:
1672         scalarkids(o);
1673         break;
1674     case OP_SCALAR:
1675         return scalar(o);
1676     }
1677
1678     if (useless_sv) {
1679         /* mortalise it, in case warnings are fatal.  */
1680         Perl_ck_warner(aTHX_ packWARN(WARN_VOID),
1681                        "Useless use of %"SVf" in void context",
1682                        sv_2mortal(useless_sv));
1683     }
1684     else if (useless) {
1685        Perl_ck_warner(aTHX_ packWARN(WARN_VOID),
1686                       "Useless use of %s in void context",
1687                       useless);
1688     }
1689     return o;
1690 }
1691
1692 static OP *
1693 S_listkids(pTHX_ OP *o)
1694 {
1695     if (o && o->op_flags & OPf_KIDS) {
1696         OP *kid;
1697         for (kid = cLISTOPo->op_first; kid; kid = kid->op_sibling)
1698             list(kid);
1699     }
1700     return o;
1701 }
1702
1703 OP *
1704 Perl_list(pTHX_ OP *o)
1705 {
1706     dVAR;
1707     OP *kid;
1708
1709     /* assumes no premature commitment */
1710     if (!o || (o->op_flags & OPf_WANT)
1711          || (PL_parser && PL_parser->error_count)
1712          || o->op_type == OP_RETURN)
1713     {
1714         return o;
1715     }
1716
1717     if ((o->op_private & OPpTARGET_MY)
1718         && (PL_opargs[o->op_type] & OA_TARGLEX))/* OPp share the meaning */
1719     {
1720         return o;                               /* As if inside SASSIGN */
1721     }
1722
1723     o->op_flags = (o->op_flags & ~OPf_WANT) | OPf_WANT_LIST;
1724
1725     switch (o->op_type) {
1726     case OP_FLOP:
1727     case OP_REPEAT:
1728         list(cBINOPo->op_first);
1729         break;
1730     case OP_OR:
1731     case OP_AND:
1732     case OP_COND_EXPR:
1733         for (kid = cUNOPo->op_first->op_sibling; kid; kid = kid->op_sibling)
1734             list(kid);
1735         break;
1736     default:
1737     case OP_MATCH:
1738     case OP_QR:
1739     case OP_SUBST:
1740     case OP_NULL:
1741         if (!(o->op_flags & OPf_KIDS))
1742             break;
1743         if (!o->op_next && cUNOPo->op_first->op_type == OP_FLOP) {
1744             list(cBINOPo->op_first);
1745             return gen_constant_list(o);
1746         }
1747     case OP_LIST:
1748         listkids(o);
1749         break;
1750     case OP_LEAVE:
1751     case OP_LEAVETRY:
1752         kid = cLISTOPo->op_first;
1753         list(kid);
1754         kid = kid->op_sibling;
1755     do_kids:
1756         while (kid) {
1757             OP *sib = kid->op_sibling;
1758             if (sib && kid->op_type != OP_LEAVEWHEN)
1759                 scalarvoid(kid);
1760             else
1761                 list(kid);
1762             kid = sib;
1763         }
1764         PL_curcop = &PL_compiling;
1765         break;
1766     case OP_SCOPE:
1767     case OP_LINESEQ:
1768         kid = cLISTOPo->op_first;
1769         goto do_kids;
1770     }
1771     return o;
1772 }
1773
1774 static OP *
1775 S_scalarseq(pTHX_ OP *o)
1776 {
1777     dVAR;
1778     if (o) {
1779         const OPCODE type = o->op_type;
1780
1781         if (type == OP_LINESEQ || type == OP_SCOPE ||
1782             type == OP_LEAVE || type == OP_LEAVETRY)
1783         {
1784             OP *kid;
1785             for (kid = cLISTOPo->op_first; kid; kid = kid->op_sibling) {
1786                 if (kid->op_sibling) {
1787                     scalarvoid(kid);
1788                 }
1789             }
1790             PL_curcop = &PL_compiling;
1791         }
1792         o->op_flags &= ~OPf_PARENS;
1793         if (PL_hints & HINT_BLOCK_SCOPE)
1794             o->op_flags |= OPf_PARENS;
1795     }
1796     else
1797         o = newOP(OP_STUB, 0);
1798     return o;
1799 }
1800
1801 STATIC OP *
1802 S_modkids(pTHX_ OP *o, I32 type)
1803 {
1804     if (o && o->op_flags & OPf_KIDS) {
1805         OP *kid;
1806         for (kid = cLISTOPo->op_first; kid; kid = kid->op_sibling)
1807             op_lvalue(kid, type);
1808     }
1809     return o;
1810 }
1811
1812 /*
1813 =for apidoc finalize_optree
1814
1815 This function finalizes the optree. Should be called directly after
1816 the complete optree is built. It does some additional
1817 checking which can't be done in the normal ck_xxx functions and makes
1818 the tree thread-safe.
1819
1820 =cut
1821 */
1822 void
1823 Perl_finalize_optree(pTHX_ OP* o)
1824 {
1825     PERL_ARGS_ASSERT_FINALIZE_OPTREE;
1826
1827     ENTER;
1828     SAVEVPTR(PL_curcop);
1829
1830     finalize_op(o);
1831
1832     LEAVE;
1833 }
1834
1835 STATIC void
1836 S_finalize_op(pTHX_ OP* o)
1837 {
1838     PERL_ARGS_ASSERT_FINALIZE_OP;
1839
1840 #if defined(PERL_MAD) && defined(USE_ITHREADS)
1841     {
1842         /* Make sure mad ops are also thread-safe */
1843         MADPROP *mp = o->op_madprop;
1844         while (mp) {
1845             if (mp->mad_type == MAD_OP && mp->mad_vlen) {
1846                 OP *prop_op = (OP *) mp->mad_val;
1847                 /* We only need "Relocate sv to the pad for thread safety.", but this
1848                    easiest way to make sure it traverses everything */
1849                 if (prop_op->op_type == OP_CONST)
1850                     cSVOPx(prop_op)->op_private &= ~OPpCONST_STRICT;
1851                 finalize_op(prop_op);
1852             }
1853             mp = mp->mad_next;
1854         }
1855     }
1856 #endif
1857
1858     switch (o->op_type) {
1859     case OP_NEXTSTATE:
1860     case OP_DBSTATE:
1861         PL_curcop = ((COP*)o);          /* for warnings */
1862         break;
1863     case OP_EXEC:
1864         if ( o->op_sibling
1865             && (o->op_sibling->op_type == OP_NEXTSTATE || o->op_sibling->op_type == OP_DBSTATE)
1866             && ckWARN(WARN_EXEC))
1867             {
1868                 if (o->op_sibling->op_sibling) {
1869                     const OPCODE type = o->op_sibling->op_sibling->op_type;
1870                     if (type != OP_EXIT && type != OP_WARN && type != OP_DIE) {
1871                         const line_t oldline = CopLINE(PL_curcop);
1872                         CopLINE_set(PL_curcop, CopLINE((COP*)o->op_sibling));
1873                         Perl_warner(aTHX_ packWARN(WARN_EXEC),
1874                             "Statement unlikely to be reached");
1875                         Perl_warner(aTHX_ packWARN(WARN_EXEC),
1876                             "\t(Maybe you meant system() when you said exec()?)\n");
1877                         CopLINE_set(PL_curcop, oldline);
1878                     }
1879                 }
1880             }
1881         break;
1882
1883     case OP_GV:
1884         if ((o->op_private & OPpEARLY_CV) && ckWARN(WARN_PROTOTYPE)) {
1885             GV * const gv = cGVOPo_gv;
1886             if (SvTYPE(gv) == SVt_PVGV && GvCV(gv) && SvPVX_const(GvCV(gv))) {
1887                 /* XXX could check prototype here instead of just carping */
1888                 SV * const sv = sv_newmortal();
1889                 gv_efullname3(sv, gv, NULL);
1890                 Perl_warner(aTHX_ packWARN(WARN_PROTOTYPE),
1891                     "%"SVf"() called too early to check prototype",
1892                     SVfARG(sv));
1893             }
1894         }
1895         break;
1896
1897     case OP_CONST:
1898         if (cSVOPo->op_private & OPpCONST_STRICT)
1899             no_bareword_allowed(o);
1900         /* FALLTHROUGH */
1901 #ifdef USE_ITHREADS
1902     case OP_HINTSEVAL:
1903     case OP_METHOD_NAMED:
1904         /* Relocate sv to the pad for thread safety.
1905          * Despite being a "constant", the SV is written to,
1906          * for reference counts, sv_upgrade() etc. */
1907         if (cSVOPo->op_sv) {
1908             const PADOFFSET ix = pad_alloc(OP_CONST, SVf_READONLY);
1909             SvREFCNT_dec(PAD_SVl(ix));
1910             PAD_SETSV(ix, cSVOPo->op_sv);
1911             /* XXX I don't know how this isn't readonly already. */
1912             if (!SvIsCOW(PAD_SVl(ix))) SvREADONLY_on(PAD_SVl(ix));
1913             cSVOPo->op_sv = NULL;
1914             o->op_targ = ix;
1915         }
1916 #endif
1917         break;
1918
1919     case OP_HELEM: {
1920         UNOP *rop;
1921         SV *lexname;
1922         GV **fields;
1923         SVOP *key_op;
1924         OP *kid;
1925         bool check_fields;
1926
1927         if ((key_op = cSVOPx(((BINOP*)o)->op_last))->op_type != OP_CONST)
1928             break;
1929
1930         rop = (UNOP*)((BINOP*)o)->op_first;
1931
1932         goto check_keys;
1933
1934     case OP_HSLICE:
1935         S_scalar_slice_warning(aTHX_ o);
1936
1937     case OP_KVHSLICE:
1938         if (/* I bet there's always a pushmark... */
1939                 (kid = cLISTOPo->op_first->op_sibling)->op_type != OP_LIST
1940               && kid->op_type != OP_CONST)
1941             break;
1942
1943         key_op = (SVOP*)(kid->op_type == OP_CONST
1944                                 ? kid
1945                                 : kLISTOP->op_first->op_sibling);
1946
1947         rop = (UNOP*)((LISTOP*)o)->op_last;
1948
1949       check_keys:       
1950         if (o->op_private & OPpLVAL_INTRO || rop->op_type != OP_RV2HV)
1951             rop = NULL;
1952         else if (rop->op_first->op_type == OP_PADSV)
1953             /* @$hash{qw(keys here)} */
1954             rop = (UNOP*)rop->op_first;
1955         else {
1956             /* @{$hash}{qw(keys here)} */
1957             if (rop->op_first->op_type == OP_SCOPE
1958                 && cLISTOPx(rop->op_first)->op_last->op_type == OP_PADSV)
1959                 {
1960                     rop = (UNOP*)cLISTOPx(rop->op_first)->op_last;
1961                 }
1962             else
1963                 rop = NULL;
1964         }
1965
1966         lexname = NULL; /* just to silence compiler warnings */
1967         fields  = NULL; /* just to silence compiler warnings */
1968
1969         check_fields =
1970             rop
1971          && (lexname = *av_fetch(PL_comppad_name, rop->op_targ, TRUE),
1972              SvPAD_TYPED(lexname))
1973          && (fields = (GV**)hv_fetchs(SvSTASH(lexname), "FIELDS", FALSE))
1974          && isGV(*fields) && GvHV(*fields);
1975         for (; key_op;
1976              key_op = (SVOP*)key_op->op_sibling) {
1977             SV **svp, *sv;
1978             if (key_op->op_type != OP_CONST)
1979                 continue;
1980             svp = cSVOPx_svp(key_op);
1981
1982             /* Make the CONST have a shared SV */
1983             if ((!SvIsCOW_shared_hash(sv = *svp))
1984              && SvTYPE(sv) < SVt_PVMG && SvOK(sv) && !SvROK(sv)) {
1985                 SSize_t keylen;
1986                 const char * const key = SvPV_const(sv, *(STRLEN*)&keylen);
1987                 SV *nsv = newSVpvn_share(key,
1988                                          SvUTF8(sv) ? -keylen : keylen, 0);
1989                 SvREFCNT_dec_NN(sv);
1990                 *svp = nsv;
1991             }
1992
1993             if (check_fields
1994              && !hv_fetch_ent(GvHV(*fields), *svp, FALSE, 0)) {
1995                 Perl_croak(aTHX_ "No such class field \"%"SVf"\" " 
1996                            "in variable %"SVf" of type %"HEKf, 
1997                       SVfARG(*svp), SVfARG(lexname),
1998                       HEKfARG(HvNAME_HEK(SvSTASH(lexname))));
1999             }
2000         }
2001         break;
2002     }
2003     case OP_ASLICE:
2004         S_scalar_slice_warning(aTHX_ o);
2005         break;
2006
2007     case OP_SUBST: {
2008         if (cPMOPo->op_pmreplrootu.op_pmreplroot)
2009             finalize_op(cPMOPo->op_pmreplrootu.op_pmreplroot);
2010         break;
2011     }
2012     default:
2013         break;
2014     }
2015
2016     if (o->op_flags & OPf_KIDS) {
2017         OP *kid;
2018         for (kid = cUNOPo->op_first; kid; kid = kid->op_sibling)
2019             finalize_op(kid);
2020     }
2021 }
2022
2023 /*
2024 =for apidoc Amx|OP *|op_lvalue|OP *o|I32 type
2025
2026 Propagate lvalue ("modifiable") context to an op and its children.
2027 I<type> represents the context type, roughly based on the type of op that
2028 would do the modifying, although C<local()> is represented by OP_NULL,
2029 because it has no op type of its own (it is signalled by a flag on
2030 the lvalue op).
2031
2032 This function detects things that can't be modified, such as C<$x+1>, and
2033 generates errors for them. For example, C<$x+1 = 2> would cause it to be
2034 called with an op of type OP_ADD and a C<type> argument of OP_SASSIGN.
2035
2036 It also flags things that need to behave specially in an lvalue context,
2037 such as C<$$x = 5> which might have to vivify a reference in C<$x>.
2038
2039 =cut
2040 */
2041
2042 OP *
2043 Perl_op_lvalue_flags(pTHX_ OP *o, I32 type, U32 flags)
2044 {
2045     dVAR;
2046     OP *kid;
2047     /* -1 = error on localize, 0 = ignore localize, 1 = ok to localize */
2048     int localize = -1;
2049
2050     if (!o || (PL_parser && PL_parser->error_count))
2051         return o;
2052
2053     if ((o->op_private & OPpTARGET_MY)
2054         && (PL_opargs[o->op_type] & OA_TARGLEX))/* OPp share the meaning */
2055     {
2056         return o;
2057     }
2058
2059     assert( (o->op_flags & OPf_WANT) != OPf_WANT_VOID );
2060
2061     if (type == OP_PRTF || type == OP_SPRINTF) type = OP_ENTERSUB;
2062
2063     switch (o->op_type) {
2064     case OP_UNDEF:
2065         PL_modcount++;
2066         return o;
2067     case OP_STUB:
2068         if ((o->op_flags & OPf_PARENS) || PL_madskills)
2069             break;
2070         goto nomod;
2071     case OP_ENTERSUB:
2072         if ((type == OP_UNDEF || type == OP_REFGEN || type == OP_LOCK) &&
2073             !(o->op_flags & OPf_STACKED)) {
2074             o->op_type = OP_RV2CV;              /* entersub => rv2cv */
2075             /* Both ENTERSUB and RV2CV use this bit, but for different pur-
2076                poses, so we need it clear.  */
2077             o->op_private &= ~1;
2078             o->op_ppaddr = PL_ppaddr[OP_RV2CV];
2079             assert(cUNOPo->op_first->op_type == OP_NULL);
2080             op_null(((LISTOP*)cUNOPo->op_first)->op_first);/* disable pushmark */
2081             break;
2082         }
2083         else {                          /* lvalue subroutine call */
2084             o->op_private |= OPpLVAL_INTRO
2085                            |(OPpENTERSUB_INARGS * (type == OP_LEAVESUBLV));
2086             PL_modcount = RETURN_UNLIMITED_NUMBER;
2087             if (type == OP_GREPSTART || type == OP_ENTERSUB || type == OP_REFGEN) {
2088                 /* Potential lvalue context: */
2089                 o->op_private |= OPpENTERSUB_INARGS;
2090                 break;
2091             }
2092             else {                      /* Compile-time error message: */
2093                 OP *kid = cUNOPo->op_first;
2094                 CV *cv;
2095
2096                 if (kid->op_type != OP_PUSHMARK) {
2097                     if (kid->op_type != OP_NULL || kid->op_targ != OP_LIST)
2098                         Perl_croak(aTHX_
2099                                 "panic: unexpected lvalue entersub "
2100                                 "args: type/targ %ld:%"UVuf,
2101                                 (long)kid->op_type, (UV)kid->op_targ);
2102                     kid = kLISTOP->op_first;
2103                 }
2104                 while (kid->op_sibling)
2105                     kid = kid->op_sibling;
2106                 if (!(kid->op_type == OP_NULL && kid->op_targ == OP_RV2CV)) {
2107                     break;      /* Postpone until runtime */
2108                 }
2109
2110                 kid = kUNOP->op_first;
2111                 if (kid->op_type == OP_NULL && kid->op_targ == OP_RV2SV)
2112                     kid = kUNOP->op_first;
2113                 if (kid->op_type == OP_NULL)
2114                     Perl_croak(aTHX_
2115                                "Unexpected constant lvalue entersub "
2116                                "entry via type/targ %ld:%"UVuf,
2117                                (long)kid->op_type, (UV)kid->op_targ);
2118                 if (kid->op_type != OP_GV) {
2119                     break;
2120                 }
2121
2122                 cv = GvCV(kGVOP_gv);
2123                 if (!cv)
2124                     break;
2125                 if (CvLVALUE(cv))
2126                     break;
2127             }
2128         }
2129         /* FALL THROUGH */
2130     default:
2131       nomod:
2132         if (flags & OP_LVALUE_NO_CROAK) return NULL;
2133         /* grep, foreach, subcalls, refgen */
2134         if (type == OP_GREPSTART || type == OP_ENTERSUB
2135          || type == OP_REFGEN    || type == OP_LEAVESUBLV)
2136             break;
2137         yyerror(Perl_form(aTHX_ "Can't modify %s in %s",
2138                      (o->op_type == OP_NULL && (o->op_flags & OPf_SPECIAL)
2139                       ? "do block"
2140                       : (o->op_type == OP_ENTERSUB
2141                         ? "non-lvalue subroutine call"
2142                         : OP_DESC(o))),
2143                      type ? PL_op_desc[type] : "local"));
2144         return o;
2145
2146     case OP_PREINC:
2147     case OP_PREDEC:
2148     case OP_POW:
2149     case OP_MULTIPLY:
2150     case OP_DIVIDE:
2151     case OP_MODULO:
2152     case OP_REPEAT:
2153     case OP_ADD:
2154     case OP_SUBTRACT:
2155     case OP_CONCAT:
2156     case OP_LEFT_SHIFT:
2157     case OP_RIGHT_SHIFT:
2158     case OP_BIT_AND:
2159     case OP_BIT_XOR:
2160     case OP_BIT_OR:
2161     case OP_I_MULTIPLY:
2162     case OP_I_DIVIDE:
2163     case OP_I_MODULO:
2164     case OP_I_ADD:
2165     case OP_I_SUBTRACT:
2166         if (!(o->op_flags & OPf_STACKED))
2167             goto nomod;
2168         PL_modcount++;
2169         break;
2170
2171     case OP_COND_EXPR:
2172         localize = 1;
2173         for (kid = cUNOPo->op_first->op_sibling; kid; kid = kid->op_sibling)
2174             op_lvalue(kid, type);
2175         break;
2176
2177     case OP_RV2AV:
2178     case OP_RV2HV:
2179         if (type == OP_REFGEN && o->op_flags & OPf_PARENS) {
2180            PL_modcount = RETURN_UNLIMITED_NUMBER;
2181             return o;           /* Treat \(@foo) like ordinary list. */
2182         }
2183         /* FALL THROUGH */
2184     case OP_RV2GV:
2185         if (scalar_mod_type(o, type))
2186             goto nomod;
2187         ref(cUNOPo->op_first, o->op_type);
2188         /* FALL THROUGH */
2189     case OP_ASLICE:
2190     case OP_HSLICE:
2191         localize = 1;
2192         /* FALL THROUGH */
2193     case OP_AASSIGN:
2194         /* Do not apply the lvsub flag for rv2[ah]v in scalar context.  */
2195         if (type == OP_LEAVESUBLV && (
2196                 (o->op_type != OP_RV2AV && o->op_type != OP_RV2HV)
2197              || (o->op_flags & OPf_WANT) != OPf_WANT_SCALAR
2198            ))
2199             o->op_private |= OPpMAYBE_LVSUB;
2200         /* FALL THROUGH */
2201     case OP_NEXTSTATE:
2202     case OP_DBSTATE:
2203        PL_modcount = RETURN_UNLIMITED_NUMBER;
2204         break;
2205     case OP_KVHSLICE:
2206     case OP_KVASLICE:
2207         if (type == OP_LEAVESUBLV)
2208             o->op_private |= OPpMAYBE_LVSUB;
2209         goto nomod;
2210     case OP_AV2ARYLEN:
2211         PL_hints |= HINT_BLOCK_SCOPE;
2212         if (type == OP_LEAVESUBLV)
2213             o->op_private |= OPpMAYBE_LVSUB;
2214         PL_modcount++;
2215         break;
2216     case OP_RV2SV:
2217         ref(cUNOPo->op_first, o->op_type);
2218         localize = 1;
2219         /* FALL THROUGH */
2220     case OP_GV:
2221         PL_hints |= HINT_BLOCK_SCOPE;
2222     case OP_SASSIGN:
2223     case OP_ANDASSIGN:
2224     case OP_ORASSIGN:
2225     case OP_DORASSIGN:
2226         PL_modcount++;
2227         break;
2228
2229     case OP_AELEMFAST:
2230     case OP_AELEMFAST_LEX:
2231         localize = -1;
2232         PL_modcount++;
2233         break;
2234
2235     case OP_PADAV:
2236     case OP_PADHV:
2237        PL_modcount = RETURN_UNLIMITED_NUMBER;
2238         if (type == OP_REFGEN && o->op_flags & OPf_PARENS)
2239             return o;           /* Treat \(@foo) like ordinary list. */
2240         if (scalar_mod_type(o, type))
2241             goto nomod;
2242         if ((o->op_flags & OPf_WANT) != OPf_WANT_SCALAR
2243           && type == OP_LEAVESUBLV)
2244             o->op_private |= OPpMAYBE_LVSUB;
2245         /* FALL THROUGH */
2246     case OP_PADSV:
2247         PL_modcount++;
2248         if (!type) /* local() */
2249             Perl_croak(aTHX_ "Can't localize lexical variable %"SVf,
2250                  PAD_COMPNAME_SV(o->op_targ));
2251         break;
2252
2253     case OP_PUSHMARK:
2254         localize = 0;
2255         break;
2256
2257     case OP_KEYS:
2258     case OP_RKEYS:
2259         if (type != OP_SASSIGN && type != OP_LEAVESUBLV)
2260             goto nomod;
2261         goto lvalue_func;
2262     case OP_SUBSTR:
2263         if (o->op_private == 4) /* don't allow 4 arg substr as lvalue */
2264             goto nomod;
2265         /* FALL THROUGH */
2266     case OP_POS:
2267     case OP_VEC:
2268       lvalue_func:
2269         if (type == OP_LEAVESUBLV)
2270             o->op_private |= OPpMAYBE_LVSUB;
2271         if (o->op_flags & OPf_KIDS)
2272             op_lvalue(cBINOPo->op_first->op_sibling, type);
2273         break;
2274
2275     case OP_AELEM:
2276     case OP_HELEM:
2277         ref(cBINOPo->op_first, o->op_type);
2278         if (type == OP_ENTERSUB &&
2279              !(o->op_private & (OPpLVAL_INTRO | OPpDEREF)))
2280             o->op_private |= OPpLVAL_DEFER;
2281         if (type == OP_LEAVESUBLV)
2282             o->op_private |= OPpMAYBE_LVSUB;
2283         localize = 1;
2284         PL_modcount++;
2285         break;
2286
2287     case OP_LEAVE:
2288     case OP_LEAVELOOP:
2289         o->op_private |= OPpLVALUE;
2290     case OP_SCOPE:
2291     case OP_ENTER:
2292     case OP_LINESEQ:
2293         localize = 0;
2294         if (o->op_flags & OPf_KIDS)
2295             op_lvalue(cLISTOPo->op_last, type);
2296         break;
2297
2298     case OP_NULL:
2299         localize = 0;
2300         if (o->op_flags & OPf_SPECIAL)          /* do BLOCK */
2301             goto nomod;
2302         else if (!(o->op_flags & OPf_KIDS))
2303             break;
2304         if (o->op_targ != OP_LIST) {
2305             op_lvalue(cBINOPo->op_first, type);
2306             break;
2307         }
2308         /* FALL THROUGH */
2309     case OP_LIST:
2310         localize = 0;
2311         for (kid = cLISTOPo->op_first; kid; kid = kid->op_sibling)
2312             /* elements might be in void context because the list is
2313                in scalar context or because they are attribute sub calls */
2314             if ( (kid->op_flags & OPf_WANT) != OPf_WANT_VOID )
2315                 op_lvalue(kid, type);
2316         break;
2317
2318     case OP_RETURN:
2319         if (type != OP_LEAVESUBLV)
2320             goto nomod;
2321         break; /* op_lvalue()ing was handled by ck_return() */
2322
2323     case OP_COREARGS:
2324         return o;
2325
2326     case OP_AND:
2327     case OP_OR:
2328         op_lvalue(cLOGOPo->op_first,             type);
2329         op_lvalue(cLOGOPo->op_first->op_sibling, type);
2330         goto nomod;
2331     }
2332
2333     /* [20011101.069] File test operators interpret OPf_REF to mean that
2334        their argument is a filehandle; thus \stat(".") should not set
2335        it. AMS 20011102 */
2336     if (type == OP_REFGEN &&
2337         PL_check[o->op_type] == Perl_ck_ftst)
2338         return o;
2339
2340     if (type != OP_LEAVESUBLV)
2341         o->op_flags |= OPf_MOD;
2342
2343     if (type == OP_AASSIGN || type == OP_SASSIGN)
2344         o->op_flags |= OPf_SPECIAL|OPf_REF;
2345     else if (!type) { /* local() */
2346         switch (localize) {
2347         case 1:
2348             o->op_private |= OPpLVAL_INTRO;
2349             o->op_flags &= ~OPf_SPECIAL;
2350             PL_hints |= HINT_BLOCK_SCOPE;
2351             break;
2352         case 0:
2353             break;
2354         case -1:
2355             Perl_ck_warner(aTHX_ packWARN(WARN_SYNTAX),
2356                            "Useless localization of %s", OP_DESC(o));
2357         }
2358     }
2359     else if (type != OP_GREPSTART && type != OP_ENTERSUB
2360              && type != OP_LEAVESUBLV)
2361         o->op_flags |= OPf_REF;
2362     return o;
2363 }
2364
2365 STATIC bool
2366 S_scalar_mod_type(const OP *o, I32 type)
2367 {
2368     switch (type) {
2369     case OP_POS:
2370     case OP_SASSIGN:
2371         if (o && o->op_type == OP_RV2GV)
2372             return FALSE;
2373         /* FALL THROUGH */
2374     case OP_PREINC:
2375     case OP_PREDEC:
2376     case OP_POSTINC:
2377     case OP_POSTDEC:
2378     case OP_I_PREINC:
2379     case OP_I_PREDEC:
2380     case OP_I_POSTINC:
2381     case OP_I_POSTDEC:
2382     case OP_POW:
2383     case OP_MULTIPLY:
2384     case OP_DIVIDE:
2385     case OP_MODULO:
2386     case OP_REPEAT:
2387     case OP_ADD:
2388     case OP_SUBTRACT:
2389     case OP_I_MULTIPLY:
2390     case OP_I_DIVIDE:
2391     case OP_I_MODULO:
2392     case OP_I_ADD:
2393     case OP_I_SUBTRACT:
2394     case OP_LEFT_SHIFT:
2395     case OP_RIGHT_SHIFT:
2396     case OP_BIT_AND:
2397     case OP_BIT_XOR:
2398     case OP_BIT_OR:
2399     case OP_CONCAT:
2400     case OP_SUBST:
2401     case OP_TRANS:
2402     case OP_TRANSR:
2403     case OP_READ:
2404     case OP_SYSREAD:
2405     case OP_RECV:
2406     case OP_ANDASSIGN:
2407     case OP_ORASSIGN:
2408     case OP_DORASSIGN:
2409         return TRUE;
2410     default:
2411         return FALSE;
2412     }
2413 }
2414
2415 STATIC bool
2416 S_is_handle_constructor(const OP *o, I32 numargs)
2417 {
2418     PERL_ARGS_ASSERT_IS_HANDLE_CONSTRUCTOR;
2419
2420     switch (o->op_type) {
2421     case OP_PIPE_OP:
2422     case OP_SOCKPAIR:
2423         if (numargs == 2)
2424             return TRUE;
2425         /* FALL THROUGH */
2426     case OP_SYSOPEN:
2427     case OP_OPEN:
2428     case OP_SELECT:             /* XXX c.f. SelectSaver.pm */
2429     case OP_SOCKET:
2430     case OP_OPEN_DIR:
2431     case OP_ACCEPT:
2432         if (numargs == 1)
2433             return TRUE;
2434         /* FALLTHROUGH */
2435     default:
2436         return FALSE;
2437     }
2438 }
2439
2440 static OP *
2441 S_refkids(pTHX_ OP *o, I32 type)
2442 {
2443     if (o && o->op_flags & OPf_KIDS) {
2444         OP *kid;
2445         for (kid = cLISTOPo->op_first; kid; kid = kid->op_sibling)
2446             ref(kid, type);
2447     }
2448     return o;
2449 }
2450
2451 OP *
2452 Perl_doref(pTHX_ OP *o, I32 type, bool set_op_ref)
2453 {
2454     dVAR;
2455     OP *kid;
2456
2457     PERL_ARGS_ASSERT_DOREF;
2458
2459     if (!o || (PL_parser && PL_parser->error_count))
2460         return o;
2461
2462     switch (o->op_type) {
2463     case OP_ENTERSUB:
2464         if ((type == OP_EXISTS || type == OP_DEFINED) &&
2465             !(o->op_flags & OPf_STACKED)) {
2466             o->op_type = OP_RV2CV;             /* entersub => rv2cv */
2467             o->op_ppaddr = PL_ppaddr[OP_RV2CV];
2468             assert(cUNOPo->op_first->op_type == OP_NULL);
2469             op_null(((LISTOP*)cUNOPo->op_first)->op_first);     /* disable pushmark */
2470             o->op_flags |= OPf_SPECIAL;
2471             o->op_private &= ~1;
2472         }
2473         else if (type == OP_RV2SV || type == OP_RV2AV || type == OP_RV2HV){
2474             o->op_private |= (type == OP_RV2AV ? OPpDEREF_AV
2475                               : type == OP_RV2HV ? OPpDEREF_HV
2476                               : OPpDEREF_SV);
2477             o->op_flags |= OPf_MOD;
2478         }
2479
2480         break;
2481
2482     case OP_COND_EXPR:
2483         for (kid = cUNOPo->op_first->op_sibling; kid; kid = kid->op_sibling)
2484             doref(kid, type, set_op_ref);
2485         break;
2486     case OP_RV2SV:
2487         if (type == OP_DEFINED)
2488             o->op_flags |= OPf_SPECIAL;         /* don't create GV */
2489         doref(cUNOPo->op_first, o->op_type, set_op_ref);
2490         /* FALL THROUGH */
2491     case OP_PADSV:
2492         if (type == OP_RV2SV || type == OP_RV2AV || type == OP_RV2HV) {
2493             o->op_private |= (type == OP_RV2AV ? OPpDEREF_AV
2494                               : type == OP_RV2HV ? OPpDEREF_HV
2495                               : OPpDEREF_SV);
2496             o->op_flags |= OPf_MOD;
2497         }
2498         break;
2499
2500     case OP_RV2AV:
2501     case OP_RV2HV:
2502         if (set_op_ref)
2503             o->op_flags |= OPf_REF;
2504         /* FALL THROUGH */
2505     case OP_RV2GV:
2506         if (type == OP_DEFINED)
2507             o->op_flags |= OPf_SPECIAL;         /* don't create GV */
2508         doref(cUNOPo->op_first, o->op_type, set_op_ref);
2509         break;
2510
2511     case OP_PADAV:
2512     case OP_PADHV:
2513         if (set_op_ref)
2514             o->op_flags |= OPf_REF;
2515         break;
2516
2517     case OP_SCALAR:
2518     case OP_NULL:
2519         if (!(o->op_flags & OPf_KIDS) || type == OP_DEFINED)
2520             break;
2521         doref(cBINOPo->op_first, type, set_op_ref);
2522         break;
2523     case OP_AELEM:
2524     case OP_HELEM:
2525         doref(cBINOPo->op_first, o->op_type, set_op_ref);
2526         if (type == OP_RV2SV || type == OP_RV2AV || type == OP_RV2HV) {
2527             o->op_private |= (type == OP_RV2AV ? OPpDEREF_AV
2528                               : type == OP_RV2HV ? OPpDEREF_HV
2529                               : OPpDEREF_SV);
2530             o->op_flags |= OPf_MOD;
2531         }
2532         break;
2533
2534     case OP_SCOPE:
2535     case OP_LEAVE:
2536         set_op_ref = FALSE;
2537         /* FALL THROUGH */
2538     case OP_ENTER:
2539     case OP_LIST:
2540         if (!(o->op_flags & OPf_KIDS))
2541             break;
2542         doref(cLISTOPo->op_last, type, set_op_ref);
2543         break;
2544     default:
2545         break;
2546     }
2547     return scalar(o);
2548
2549 }
2550
2551 STATIC OP *
2552 S_dup_attrlist(pTHX_ OP *o)
2553 {
2554     dVAR;
2555     OP *rop;
2556
2557     PERL_ARGS_ASSERT_DUP_ATTRLIST;
2558
2559     /* An attrlist is either a simple OP_CONST or an OP_LIST with kids,
2560      * where the first kid is OP_PUSHMARK and the remaining ones
2561      * are OP_CONST.  We need to push the OP_CONST values.
2562      */
2563     if (o->op_type == OP_CONST)
2564         rop = newSVOP(OP_CONST, o->op_flags, SvREFCNT_inc_NN(cSVOPo->op_sv));
2565 #ifdef PERL_MAD
2566     else if (o->op_type == OP_NULL)
2567         rop = NULL;
2568 #endif
2569     else {
2570         assert((o->op_type == OP_LIST) && (o->op_flags & OPf_KIDS));
2571         rop = NULL;
2572         for (o = cLISTOPo->op_first; o; o=o->op_sibling) {
2573             if (o->op_type == OP_CONST)
2574                 rop = op_append_elem(OP_LIST, rop,
2575                                   newSVOP(OP_CONST, o->op_flags,
2576                                           SvREFCNT_inc_NN(cSVOPo->op_sv)));
2577         }
2578     }
2579     return rop;
2580 }
2581
2582 STATIC void
2583 S_apply_attrs(pTHX_ HV *stash, SV *target, OP *attrs)
2584 {
2585     dVAR;
2586     SV * const stashsv = stash ? newSVhek(HvNAME_HEK(stash)) : &PL_sv_no;
2587
2588     PERL_ARGS_ASSERT_APPLY_ATTRS;
2589
2590     /* fake up C<use attributes $pkg,$rv,@attrs> */
2591     ENTER;              /* need to protect against side-effects of 'use' */
2592
2593 #define ATTRSMODULE "attributes"
2594 #define ATTRSMODULE_PM "attributes.pm"
2595
2596     Perl_load_module(aTHX_ PERL_LOADMOD_IMPORT_OPS,
2597                          newSVpvs(ATTRSMODULE),
2598                          NULL,
2599                          op_prepend_elem(OP_LIST,
2600                                       newSVOP(OP_CONST, 0, stashsv),
2601                                       op_prepend_elem(OP_LIST,
2602                                                    newSVOP(OP_CONST, 0,
2603                                                            newRV(target)),
2604                                                    dup_attrlist(attrs))));
2605     LEAVE;
2606 }
2607
2608 STATIC void
2609 S_apply_attrs_my(pTHX_ HV *stash, OP *target, OP *attrs, OP **imopsp)
2610 {
2611     dVAR;
2612     OP *pack, *imop, *arg;
2613     SV *meth, *stashsv, **svp;
2614
2615     PERL_ARGS_ASSERT_APPLY_ATTRS_MY;
2616
2617     if (!attrs)
2618         return;
2619
2620     assert(target->op_type == OP_PADSV ||
2621            target->op_type == OP_PADHV ||
2622            target->op_type == OP_PADAV);
2623
2624     /* Ensure that attributes.pm is loaded. */
2625     ENTER;              /* need to protect against side-effects of 'use' */
2626     /* Don't force the C<use> if we don't need it. */
2627     svp = hv_fetchs(GvHVn(PL_incgv), ATTRSMODULE_PM, FALSE);
2628     if (svp && *svp != &PL_sv_undef)
2629         NOOP;   /* already in %INC */
2630     else
2631         Perl_load_module(aTHX_ PERL_LOADMOD_NOIMPORT,
2632                                newSVpvs(ATTRSMODULE), NULL);
2633     LEAVE;
2634
2635     /* Need package name for method call. */
2636     pack = newSVOP(OP_CONST, 0, newSVpvs(ATTRSMODULE));
2637
2638     /* Build up the real arg-list. */
2639     stashsv = stash ? newSVhek(HvNAME_HEK(stash)) : &PL_sv_no;
2640
2641     arg = newOP(OP_PADSV, 0);
2642     arg->op_targ = target->op_targ;
2643     arg = op_prepend_elem(OP_LIST,
2644                        newSVOP(OP_CONST, 0, stashsv),
2645                        op_prepend_elem(OP_LIST,
2646                                     newUNOP(OP_REFGEN, 0,
2647                                             op_lvalue(arg, OP_REFGEN)),
2648                                     dup_attrlist(attrs)));
2649
2650     /* Fake up a method call to import */
2651     meth = newSVpvs_share("import");
2652     imop = convert(OP_ENTERSUB, OPf_STACKED|OPf_SPECIAL|OPf_WANT_VOID,
2653                    op_append_elem(OP_LIST,
2654                                op_prepend_elem(OP_LIST, pack, list(arg)),
2655                                newSVOP(OP_METHOD_NAMED, 0, meth)));
2656
2657     /* Combine the ops. */
2658     *imopsp = op_append_elem(OP_LIST, *imopsp, imop);
2659 }
2660
2661 /*
2662 =notfor apidoc apply_attrs_string
2663
2664 Attempts to apply a list of attributes specified by the C<attrstr> and
2665 C<len> arguments to the subroutine identified by the C<cv> argument which
2666 is expected to be associated with the package identified by the C<stashpv>
2667 argument (see L<attributes>).  It gets this wrong, though, in that it
2668 does not correctly identify the boundaries of the individual attribute
2669 specifications within C<attrstr>.  This is not really intended for the
2670 public API, but has to be listed here for systems such as AIX which
2671 need an explicit export list for symbols.  (It's called from XS code
2672 in support of the C<ATTRS:> keyword from F<xsubpp>.)  Patches to fix it
2673 to respect attribute syntax properly would be welcome.
2674
2675 =cut
2676 */
2677
2678 void
2679 Perl_apply_attrs_string(pTHX_ const char *stashpv, CV *cv,
2680                         const char *attrstr, STRLEN len)
2681 {
2682     OP *attrs = NULL;
2683
2684     PERL_ARGS_ASSERT_APPLY_ATTRS_STRING;
2685
2686     if (!len) {
2687         len = strlen(attrstr);
2688     }
2689
2690     while (len) {
2691         for (; isSPACE(*attrstr) && len; --len, ++attrstr) ;
2692         if (len) {
2693             const char * const sstr = attrstr;
2694             for (; !isSPACE(*attrstr) && len; --len, ++attrstr) ;
2695             attrs = op_append_elem(OP_LIST, attrs,
2696                                 newSVOP(OP_CONST, 0,
2697                                         newSVpvn(sstr, attrstr-sstr)));
2698         }
2699     }
2700
2701     Perl_load_module(aTHX_ PERL_LOADMOD_IMPORT_OPS,
2702                      newSVpvs(ATTRSMODULE),
2703                      NULL, op_prepend_elem(OP_LIST,
2704                                   newSVOP(OP_CONST, 0, newSVpv(stashpv,0)),
2705                                   op_prepend_elem(OP_LIST,
2706                                                newSVOP(OP_CONST, 0,
2707                                                        newRV(MUTABLE_SV(cv))),
2708                                                attrs)));
2709 }
2710
2711 STATIC void
2712 S_move_proto_attr(pTHX_ OP **proto, OP **attrs, const GV * name)
2713 {
2714     OP *new_proto = NULL;
2715     STRLEN pvlen;
2716     char *pv;
2717     OP *o;
2718
2719     PERL_ARGS_ASSERT_MOVE_PROTO_ATTR;
2720
2721     if (!*attrs)
2722         return;
2723
2724     o = *attrs;
2725     if (o->op_type == OP_CONST) {
2726         pv = SvPV(cSVOPo_sv, pvlen);
2727         if (pvlen >= 10 && memEQ(pv, "prototype(", 10)) {
2728             SV * const tmpsv = newSVpvn_flags(pv + 10, pvlen - 11, SvUTF8(cSVOPo_sv));
2729             SV ** const tmpo = cSVOPx_svp(o);
2730             SvREFCNT_dec(cSVOPo_sv);
2731             *tmpo = tmpsv;
2732             new_proto = o;
2733             *attrs = NULL;
2734         }
2735     } else if (o->op_type == OP_LIST) {
2736         OP * lasto = NULL;
2737         assert(o->op_flags & OPf_KIDS);
2738         assert(cLISTOPo->op_first->op_type == OP_PUSHMARK);
2739         /* Counting on the first op to hit the lasto = o line */
2740         for (o = cLISTOPo->op_first; o; o=o->op_sibling) {
2741             if (o->op_type == OP_CONST) {
2742                 pv = SvPV(cSVOPo_sv, pvlen);
2743                 if (pvlen >= 10 && memEQ(pv, "prototype(", 10)) {
2744                     SV * const tmpsv = newSVpvn_flags(pv + 10, pvlen - 11, SvUTF8(cSVOPo_sv));
2745                     SV ** const tmpo = cSVOPx_svp(o);
2746                     SvREFCNT_dec(cSVOPo_sv);
2747                     *tmpo = tmpsv;
2748                     if (new_proto && ckWARN(WARN_MISC)) {
2749                         STRLEN new_len;
2750                         const char * newp = SvPV(cSVOPo_sv, new_len);
2751                         Perl_warner(aTHX_ packWARN(WARN_MISC),
2752                             "Attribute prototype(%"UTF8f") discards earlier prototype attribute in same sub",
2753                             UTF8fARG(SvUTF8(cSVOPo_sv), new_len, newp));
2754                         op_free(new_proto);
2755                     }
2756                     else if (new_proto)
2757                         op_free(new_proto);
2758                     new_proto = o;
2759                     lasto->op_sibling = o->op_sibling;
2760                     continue;
2761                 }
2762             }
2763             lasto = o;
2764         }
2765         /* If the list is now just the PUSHMARK, scrap the whole thing; otherwise attributes.xs
2766            would get pulled in with no real need */
2767         if (!cLISTOPx(*attrs)->op_first->op_sibling) {
2768             op_free(*attrs);
2769             *attrs = NULL;
2770         }
2771     }
2772
2773     if (new_proto) {
2774         SV *svname;
2775         if (isGV(name)) {
2776             svname = sv_newmortal();
2777             gv_efullname3(svname, name, NULL);
2778         }
2779         else if (SvPOK(name) && *SvPVX((SV *)name) == '&')
2780             svname = newSVpvn_flags(SvPVX((SV *)name)+1, SvCUR(name)-1, SvUTF8(name)|SVs_TEMP);
2781         else
2782             svname = (SV *)name;
2783         if (ckWARN(WARN_ILLEGALPROTO))
2784             (void)validate_proto(svname, cSVOPx_sv(new_proto), TRUE);
2785         if (*proto && ckWARN(WARN_PROTOTYPE)) {
2786             STRLEN old_len, new_len;
2787             const char * oldp = SvPV(cSVOPx_sv(*proto), old_len);
2788             const char * newp = SvPV(cSVOPx_sv(new_proto), new_len);
2789
2790             Perl_warner(aTHX_ packWARN(WARN_PROTOTYPE),
2791                 "Prototype '%"UTF8f"' overridden by attribute 'prototype(%"UTF8f")'"
2792                 " in %"SVf,
2793                 UTF8fARG(SvUTF8(cSVOPx_sv(*proto)), old_len, oldp),
2794                 UTF8fARG(SvUTF8(cSVOPx_sv(new_proto)), new_len, newp),
2795                 SVfARG(svname));
2796         }
2797         if (*proto)
2798             op_free(*proto);
2799         *proto = new_proto;
2800     }
2801 }
2802
2803 STATIC OP *
2804 S_my_kid(pTHX_ OP *o, OP *attrs, OP **imopsp)
2805 {
2806     dVAR;
2807     I32 type;
2808     const bool stately = PL_parser && PL_parser->in_my == KEY_state;
2809
2810     PERL_ARGS_ASSERT_MY_KID;
2811
2812     if (!o || (PL_parser && PL_parser->error_count))
2813         return o;
2814
2815     type = o->op_type;
2816     if (PL_madskills && type == OP_NULL && o->op_flags & OPf_KIDS) {
2817         (void)my_kid(cUNOPo->op_first, attrs, imopsp);
2818         return o;
2819     }
2820
2821     if (type == OP_LIST) {
2822         OP *kid;
2823         for (kid = cLISTOPo->op_first; kid; kid = kid->op_sibling)
2824             my_kid(kid, attrs, imopsp);
2825         return o;
2826     } else if (type == OP_UNDEF || type == OP_STUB) {
2827         return o;
2828     } else if (type == OP_RV2SV ||      /* "our" declaration */
2829                type == OP_RV2AV ||
2830                type == OP_RV2HV) { /* XXX does this let anything illegal in? */
2831         if (cUNOPo->op_first->op_type != OP_GV) { /* MJD 20011224 */
2832             yyerror(Perl_form(aTHX_ "Can't declare %s in \"%s\"",
2833                         OP_DESC(o),
2834                         PL_parser->in_my == KEY_our
2835                             ? "our"
2836                             : PL_parser->in_my == KEY_state ? "state" : "my"));
2837         } else if (attrs) {
2838             GV * const gv = cGVOPx_gv(cUNOPo->op_first);
2839             PL_parser->in_my = FALSE;
2840             PL_parser->in_my_stash = NULL;
2841             apply_attrs(GvSTASH(gv),
2842                         (type == OP_RV2SV ? GvSV(gv) :
2843                          type == OP_RV2AV ? MUTABLE_SV(GvAV(gv)) :
2844                          type == OP_RV2HV ? MUTABLE_SV(GvHV(gv)) : MUTABLE_SV(gv)),
2845                         attrs);
2846         }
2847         o->op_private |= OPpOUR_INTRO;
2848         return o;
2849     }
2850     else if (type != OP_PADSV &&
2851              type != OP_PADAV &&
2852              type != OP_PADHV &&
2853              type != OP_PUSHMARK)
2854     {
2855         yyerror(Perl_form(aTHX_ "Can't declare %s in \"%s\"",
2856                           OP_DESC(o),
2857                           PL_parser->in_my == KEY_our
2858                             ? "our"
2859                             : PL_parser->in_my == KEY_state ? "state" : "my"));
2860         return o;
2861     }
2862     else if (attrs && type != OP_PUSHMARK) {
2863         HV *stash;
2864
2865         PL_parser->in_my = FALSE;
2866         PL_parser->in_my_stash = NULL;
2867
2868         /* check for C<my Dog $spot> when deciding package */
2869         stash = PAD_COMPNAME_TYPE(o->op_targ);
2870         if (!stash)
2871             stash = PL_curstash;
2872         apply_attrs_my(stash, o, attrs, imopsp);
2873     }
2874     o->op_flags |= OPf_MOD;
2875     o->op_private |= OPpLVAL_INTRO;
2876     if (stately)
2877         o->op_private |= OPpPAD_STATE;
2878     return o;
2879 }
2880
2881 OP *
2882 Perl_my_attrs(pTHX_ OP *o, OP *attrs)
2883 {
2884     dVAR;
2885     OP *rops;
2886     int maybe_scalar = 0;
2887
2888     PERL_ARGS_ASSERT_MY_ATTRS;
2889
2890 /* [perl #17376]: this appears to be premature, and results in code such as
2891    C< our(%x); > executing in list mode rather than void mode */
2892 #if 0
2893     if (o->op_flags & OPf_PARENS)
2894         list(o);
2895     else
2896         maybe_scalar = 1;
2897 #else
2898     maybe_scalar = 1;
2899 #endif
2900     if (attrs)
2901         SAVEFREEOP(attrs);
2902     rops = NULL;
2903     o = my_kid(o, attrs, &rops);
2904     if (rops) {
2905         if (maybe_scalar && o->op_type == OP_PADSV) {
2906             o = scalar(op_append_list(OP_LIST, rops, o));
2907             o->op_private |= OPpLVAL_INTRO;
2908         }
2909         else {
2910             /* The listop in rops might have a pushmark at the beginning,
2911                which will mess up list assignment. */
2912             LISTOP * const lrops = (LISTOP *)rops; /* for brevity */
2913             if (rops->op_type == OP_LIST && 
2914                 lrops->op_first && lrops->op_first->op_type == OP_PUSHMARK)
2915             {
2916                 OP * const pushmark = lrops->op_first;
2917                 lrops->op_first = pushmark->op_sibling;
2918                 op_free(pushmark);
2919             }
2920             o = op_append_list(OP_LIST, o, rops);
2921         }
2922     }
2923     PL_parser->in_my = FALSE;
2924     PL_parser->in_my_stash = NULL;
2925     return o;
2926 }
2927
2928 OP *
2929 Perl_sawparens(pTHX_ OP *o)
2930 {
2931     PERL_UNUSED_CONTEXT;
2932     if (o)
2933         o->op_flags |= OPf_PARENS;
2934     return o;
2935 }
2936
2937 OP *
2938 Perl_bind_match(pTHX_ I32 type, OP *left, OP *right)
2939 {
2940     OP *o;
2941     bool ismatchop = 0;
2942     const OPCODE ltype = left->op_type;
2943     const OPCODE rtype = right->op_type;
2944
2945     PERL_ARGS_ASSERT_BIND_MATCH;
2946
2947     if ( (ltype == OP_RV2AV || ltype == OP_RV2HV || ltype == OP_PADAV
2948           || ltype == OP_PADHV) && ckWARN(WARN_MISC))
2949     {
2950       const char * const desc
2951           = PL_op_desc[(
2952                           rtype == OP_SUBST || rtype == OP_TRANS
2953                        || rtype == OP_TRANSR
2954                        )
2955                        ? (int)rtype : OP_MATCH];
2956       const bool isary = ltype == OP_RV2AV || ltype == OP_PADAV;
2957       SV * const name =
2958         S_op_varname(aTHX_ left);
2959       if (name)
2960         Perl_warner(aTHX_ packWARN(WARN_MISC),
2961              "Applying %s to %"SVf" will act on scalar(%"SVf")",
2962              desc, name, name);
2963       else {
2964         const char * const sample = (isary
2965              ? "@array" : "%hash");
2966         Perl_warner(aTHX_ packWARN(WARN_MISC),
2967              "Applying %s to %s will act on scalar(%s)",
2968              desc, sample, sample);
2969       }
2970     }
2971
2972     if (rtype == OP_CONST &&
2973         cSVOPx(right)->op_private & OPpCONST_BARE &&
2974         cSVOPx(right)->op_private & OPpCONST_STRICT)
2975     {
2976         no_bareword_allowed(right);
2977     }
2978
2979     /* !~ doesn't make sense with /r, so error on it for now */
2980     if (rtype == OP_SUBST && (cPMOPx(right)->op_pmflags & PMf_NONDESTRUCT) &&
2981         type == OP_NOT)
2982         /* diag_listed_as: Using !~ with %s doesn't make sense */
2983         yyerror("Using !~ with s///r doesn't make sense");
2984     if (rtype == OP_TRANSR && type == OP_NOT)
2985         /* diag_listed_as: Using !~ with %s doesn't make sense */
2986         yyerror("Using !~ with tr///r doesn't make sense");
2987
2988     ismatchop = (rtype == OP_MATCH ||
2989                  rtype == OP_SUBST ||
2990                  rtype == OP_TRANS || rtype == OP_TRANSR)
2991              && !(right->op_flags & OPf_SPECIAL);
2992     if (ismatchop && right->op_private & OPpTARGET_MY) {
2993         right->op_targ = 0;
2994         right->op_private &= ~OPpTARGET_MY;
2995     }
2996     if (!(right->op_flags & OPf_STACKED) && ismatchop) {
2997         OP *newleft;
2998
2999         right->op_flags |= OPf_STACKED;
3000         if (rtype != OP_MATCH && rtype != OP_TRANSR &&
3001             ! (rtype == OP_TRANS &&
3002                right->op_private & OPpTRANS_IDENTICAL) &&
3003             ! (rtype == OP_SUBST &&
3004                (cPMOPx(right)->op_pmflags & PMf_NONDESTRUCT)))
3005             newleft = op_lvalue(left, rtype);
3006         else
3007             newleft = left;
3008         if (right->op_type == OP_TRANS || right->op_type == OP_TRANSR)
3009             o = newBINOP(OP_NULL, OPf_STACKED, scalar(newleft), right);
3010         else
3011             o = op_prepend_elem(rtype, scalar(newleft), right);
3012         if (type == OP_NOT)
3013             return newUNOP(OP_NOT, 0, scalar(o));
3014         return o;
3015     }
3016     else
3017         return bind_match(type, left,
3018                 pmruntime(newPMOP(OP_MATCH, 0), right, 0, 0));
3019 }
3020
3021 OP *
3022 Perl_invert(pTHX_ OP *o)
3023 {
3024     if (!o)
3025         return NULL;
3026     return newUNOP(OP_NOT, OPf_SPECIAL, scalar(o));
3027 }
3028
3029 /*
3030 =for apidoc Amx|OP *|op_scope|OP *o
3031
3032 Wraps up an op tree with some additional ops so that at runtime a dynamic
3033 scope will be created.  The original ops run in the new dynamic scope,
3034 and then, provided that they exit normally, the scope will be unwound.
3035 The additional ops used to create and unwind the dynamic scope will
3036 normally be an C<enter>/C<leave> pair, but a C<scope> op may be used
3037 instead if the ops are simple enough to not need the full dynamic scope
3038 structure.
3039
3040 =cut
3041 */
3042
3043 OP *
3044 Perl_op_scope(pTHX_ OP *o)
3045 {
3046     dVAR;
3047     if (o) {
3048         if (o->op_flags & OPf_PARENS || PERLDB_NOOPT || TAINTING_get) {
3049             o = op_prepend_elem(OP_LINESEQ, newOP(OP_ENTER, 0), o);
3050             o->op_type = OP_LEAVE;
3051             o->op_ppaddr = PL_ppaddr[OP_LEAVE];
3052         }
3053         else if (o->op_type == OP_LINESEQ) {
3054             OP *kid;
3055             o->op_type = OP_SCOPE;
3056             o->op_ppaddr = PL_ppaddr[OP_SCOPE];
3057             kid = ((LISTOP*)o)->op_first;
3058             if (kid->op_type == OP_NEXTSTATE || kid->op_type == OP_DBSTATE) {
3059                 op_null(kid);
3060
3061                 /* The following deals with things like 'do {1 for 1}' */
3062                 kid = kid->op_sibling;
3063                 if (kid &&
3064                     (kid->op_type == OP_NEXTSTATE || kid->op_type == OP_DBSTATE))
3065                     op_null(kid);
3066             }
3067         }
3068         else
3069             o = newLISTOP(OP_SCOPE, 0, o, NULL);
3070     }
3071     return o;
3072 }
3073
3074 OP *
3075 Perl_op_unscope(pTHX_ OP *o)
3076 {
3077     if (o && o->op_type == OP_LINESEQ) {
3078         OP *kid = cLISTOPo->op_first;
3079         for(; kid; kid = kid->op_sibling)
3080             if (kid->op_type == OP_NEXTSTATE || kid->op_type == OP_DBSTATE)
3081                 op_null(kid);
3082     }
3083     return o;
3084 }
3085
3086 int
3087 Perl_block_start(pTHX_ int full)
3088 {
3089     dVAR;
3090     const int retval = PL_savestack_ix;
3091
3092     pad_block_start(full);
3093     SAVEHINTS();
3094     PL_hints &= ~HINT_BLOCK_SCOPE;
3095     SAVECOMPILEWARNINGS();
3096     PL_compiling.cop_warnings = DUP_WARNINGS(PL_compiling.cop_warnings);
3097
3098     CALL_BLOCK_HOOKS(bhk_start, full);
3099
3100     return retval;
3101 }
3102
3103 OP*
3104 Perl_block_end(pTHX_ I32 floor, OP *seq)
3105 {
3106     dVAR;
3107     const int needblockscope = PL_hints & HINT_BLOCK_SCOPE;
3108     OP* retval = scalarseq(seq);
3109     OP *o;
3110
3111     CALL_BLOCK_HOOKS(bhk_pre_end, &retval);
3112
3113     LEAVE_SCOPE(floor);
3114     if (needblockscope)
3115         PL_hints |= HINT_BLOCK_SCOPE; /* propagate out */
3116     o = pad_leavemy();
3117
3118     if (o) {
3119         /* pad_leavemy has created a sequence of introcv ops for all my
3120            subs declared in the block.  We have to replicate that list with
3121            clonecv ops, to deal with this situation:
3122
3123                sub {
3124                    my sub s1;
3125                    my sub s2;
3126                    sub s1 { state sub foo { \&s2 } }
3127                }->()
3128
3129            Originally, I was going to have introcv clone the CV and turn
3130            off the stale flag.  Since &s1 is declared before &s2, the
3131            introcv op for &s1 is executed (on sub entry) before the one for
3132            &s2.  But the &foo sub inside &s1 (which is cloned when &s1 is
3133            cloned, since it is a state sub) closes over &s2 and expects
3134            to see it in its outer CV’s pad.  If the introcv op clones &s1,
3135            then &s2 is still marked stale.  Since &s1 is not active, and
3136            &foo closes over &s1’s implicit entry for &s2, we get a ‘Varia-
3137            ble will not stay shared’ warning.  Because it is the same stub
3138            that will be used when the introcv op for &s2 is executed, clos-
3139            ing over it is safe.  Hence, we have to turn off the stale flag
3140            on all lexical subs in the block before we clone any of them.
3141            Hence, having introcv clone the sub cannot work.  So we create a
3142            list of ops like this:
3143
3144                lineseq
3145                   |
3146                   +-- introcv
3147                   |
3148                   +-- introcv
3149                   |
3150                   +-- introcv
3151                   |
3152                   .
3153                   .
3154                   .
3155                   |
3156                   +-- clonecv
3157                   |
3158                   +-- clonecv
3159                   |
3160                   +-- clonecv
3161                   |
3162                   .
3163                   .
3164                   .
3165          */
3166         OP *kid = o->op_flags & OPf_KIDS ? cLISTOPo->op_first : o;
3167         OP * const last = o->op_flags & OPf_KIDS ? cLISTOPo->op_last : o;
3168         for (;; kid = kid->op_sibling) {
3169             OP *newkid = newOP(OP_CLONECV, 0);
3170             newkid->op_targ = kid->op_targ;
3171             o = op_append_elem(OP_LINESEQ, o, newkid);
3172             if (kid == last) break;
3173         }
3174         retval = op_prepend_elem(OP_LINESEQ, o, retval);
3175     }
3176
3177     CALL_BLOCK_HOOKS(bhk_post_end, &retval);
3178
3179     return retval;
3180 }
3181
3182 /*
3183 =head1 Compile-time scope hooks
3184
3185 =for apidoc Aox||blockhook_register
3186
3187 Register a set of hooks to be called when the Perl lexical scope changes
3188 at compile time. See L<perlguts/"Compile-time scope hooks">.
3189
3190 =cut
3191 */
3192
3193 void
3194 Perl_blockhook_register(pTHX_ BHK *hk)
3195 {
3196     PERL_ARGS_ASSERT_BLOCKHOOK_REGISTER;
3197
3198     Perl_av_create_and_push(aTHX_ &PL_blockhooks, newSViv(PTR2IV(hk)));
3199 }
3200
3201 STATIC OP *
3202 S_newDEFSVOP(pTHX)
3203 {
3204     dVAR;
3205     const PADOFFSET offset = pad_findmy_pvs("$_", 0);
3206     if (offset == NOT_IN_PAD || PAD_COMPNAME_FLAGS_isOUR(offset)) {
3207         return newSVREF(newGVOP(OP_GV, 0, PL_defgv));
3208     }
3209     else {
3210         OP * const o = newOP(OP_PADSV, 0);
3211         o->op_targ = offset;
3212         return o;
3213     }
3214 }
3215
3216 void
3217 Perl_newPROG(pTHX_ OP *o)
3218 {
3219     dVAR;
3220
3221     PERL_ARGS_ASSERT_NEWPROG;
3222
3223     if (PL_in_eval) {
3224         PERL_CONTEXT *cx;
3225         I32 i;
3226         if (PL_eval_root)
3227                 return;
3228         PL_eval_root = newUNOP(OP_LEAVEEVAL,
3229                                ((PL_in_eval & EVAL_KEEPERR)
3230                                 ? OPf_SPECIAL : 0), o);
3231
3232         cx = &cxstack[cxstack_ix];
3233         assert(CxTYPE(cx) == CXt_EVAL);
3234
3235         if ((cx->blk_gimme & G_WANT) == G_VOID)
3236             scalarvoid(PL_eval_root);
3237         else if ((cx->blk_gimme & G_WANT) == G_ARRAY)
3238             list(PL_eval_root);
3239         else
3240             scalar(PL_eval_root);
3241
3242         PL_eval_start = op_linklist(PL_eval_root);
3243         PL_eval_root->op_private |= OPpREFCOUNTED;
3244         OpREFCNT_set(PL_eval_root, 1);
3245         PL_eval_root->op_next = 0;
3246         i = PL_savestack_ix;
3247         SAVEFREEOP(o);
3248         ENTER;
3249         CALL_PEEP(PL_eval_start);
3250         finalize_optree(PL_eval_root);
3251         LEAVE;
3252         PL_savestack_ix = i;
3253     }
3254     else {
3255         if (o->op_type == OP_STUB) {
3256             /* This block is entered if nothing is compiled for the main
3257                program. This will be the case for an genuinely empty main
3258                program, or one which only has BEGIN blocks etc, so already
3259                run and freed.
3260
3261                Historically (5.000) the guard above was !o. However, commit
3262                f8a08f7b8bd67b28 (Jun 2001), integrated to blead as
3263                c71fccf11fde0068, changed perly.y so that newPROG() is now
3264                called with the output of block_end(), which returns a new
3265                OP_STUB for the case of an empty optree. ByteLoader (and
3266                maybe other things) also take this path, because they set up
3267                PL_main_start and PL_main_root directly, without generating an
3268                optree.
3269
3270                If the parsing the main program aborts (due to parse errors,
3271                or due to BEGIN or similar calling exit), then newPROG()
3272                isn't even called, and hence this code path and its cleanups
3273                are skipped. This shouldn't make a make a difference:
3274                * a non-zero return from perl_parse is a failure, and
3275                  perl_destruct() should be called immediately.
3276                * however, if exit(0) is called during the parse, then
3277                  perl_parse() returns 0, and perl_run() is called. As
3278                  PL_main_start will be NULL, perl_run() will return
3279                  promptly, and the exit code will remain 0.
3280             */
3281
3282             PL_comppad_name = 0;
3283             PL_compcv = 0;
3284             S_op_destroy(aTHX_ o);
3285             return;
3286         }
3287         PL_main_root = op_scope(sawparens(scalarvoid(o)));
3288         PL_curcop = &PL_compiling;
3289         PL_main_start = LINKLIST(PL_main_root);
3290         PL_main_root->op_private |= OPpREFCOUNTED;
3291         OpREFCNT_set(PL_main_root, 1);
3292         PL_main_root->op_next = 0;
3293         CALL_PEEP(PL_main_start);
3294         finalize_optree(PL_main_root);
3295         cv_forget_slab(PL_compcv);
3296         PL_compcv = 0;
3297
3298         /* Register with debugger */
3299         if (PERLDB_INTER) {
3300             CV * const cv = get_cvs("DB::postponed", 0);
3301             if (cv) {
3302                 dSP;
3303                 PUSHMARK(SP);
3304                 XPUSHs(MUTABLE_SV(CopFILEGV(&PL_compiling)));
3305                 PUTBACK;
3306                 call_sv(MUTABLE_SV(cv), G_DISCARD);
3307             }
3308         }
3309     }
3310 }
3311
3312 OP *
3313 Perl_localize(pTHX_ OP *o, I32 lex)
3314 {
3315     dVAR;
3316
3317     PERL_ARGS_ASSERT_LOCALIZE;
3318
3319     if (o->op_flags & OPf_PARENS)
3320 /* [perl #17376]: this appears to be premature, and results in code such as
3321    C< our(%x); > executing in list mode rather than void mode */
3322 #if 0
3323         list(o);
3324 #else
3325         NOOP;
3326 #endif
3327     else {
3328         if ( PL_parser->bufptr > PL_parser->oldbufptr
3329             && PL_parser->bufptr[-1] == ','
3330             && ckWARN(WARN_PARENTHESIS))
3331         {
3332             char *s = PL_parser->bufptr;
3333             bool sigil = FALSE;
3334
3335             /* some heuristics to detect a potential error */
3336             while (*s && (strchr(", \t\n", *s)))
3337                 s++;
3338
3339             while (1) {
3340                 if (*s && strchr("@$%*", *s) && *++s
3341                        && (isWORDCHAR(*s) || UTF8_IS_CONTINUED(*s))) {
3342                     s++;
3343                     sigil = TRUE;
3344                     while (*s && (isWORDCHAR(*s) || UTF8_IS_CONTINUED(*s)))
3345                         s++;
3346                     while (*s && (strchr(", \t\n", *s)))
3347                         s++;
3348                 }
3349                 else
3350                     break;
3351             }
3352             if (sigil && (*s == ';' || *s == '=')) {
3353                 Perl_warner(aTHX_ packWARN(WARN_PARENTHESIS),
3354                                 "Parentheses missing around \"%s\" list",
3355                                 lex
3356                                     ? (PL_parser->in_my == KEY_our
3357                                         ? "our"
3358                                         : PL_parser->in_my == KEY_state
3359                                             ? "state"
3360                                             : "my")
3361                                     : "local");
3362             }
3363         }
3364     }
3365     if (lex)
3366         o = my(o);
3367     else
3368         o = op_lvalue(o, OP_NULL);              /* a bit kludgey */
3369     PL_parser->in_my = FALSE;
3370     PL_parser->in_my_stash = NULL;
3371     return o;
3372 }
3373
3374 OP *
3375 Perl_jmaybe(pTHX_ OP *o)
3376 {
3377     PERL_ARGS_ASSERT_JMAYBE;
3378
3379     if (o->op_type == OP_LIST) {
3380         OP * const o2
3381             = newSVREF(newGVOP(OP_GV, 0, gv_fetchpvs(";", GV_ADD|GV_NOTQUAL, SVt_PV)));
3382         o = convert(OP_JOIN, 0, op_prepend_elem(OP_LIST, o2, o));
3383     }
3384     return o;
3385 }
3386
3387 PERL_STATIC_INLINE OP *
3388 S_op_std_init(pTHX_ OP *o)
3389 {
3390     I32 type = o->op_type;
3391
3392     PERL_ARGS_ASSERT_OP_STD_INIT;
3393
3394     if (PL_opargs[type] & OA_RETSCALAR)
3395         scalar(o);
3396     if (PL_opargs[type] & OA_TARGET && !o->op_targ)
3397         o->op_targ = pad_alloc(type, SVs_PADTMP);
3398
3399     return o;
3400 }
3401
3402 PERL_STATIC_INLINE OP *
3403 S_op_integerize(pTHX_ OP *o)
3404 {
3405     I32 type = o->op_type;
3406
3407     PERL_ARGS_ASSERT_OP_INTEGERIZE;
3408
3409     /* integerize op. */
3410     if ((PL_opargs[type] & OA_OTHERINT) && (PL_hints & HINT_INTEGER))
3411     {
3412         dVAR;
3413         o->op_ppaddr = PL_ppaddr[++(o->op_type)];
3414     }
3415
3416     if (type == OP_NEGATE)
3417         /* XXX might want a ck_negate() for this */
3418         cUNOPo->op_first->op_private &= ~OPpCONST_STRICT;
3419
3420     return o;
3421 }
3422
3423 static OP *
3424 S_fold_constants(pTHX_ OP *o)
3425 {
3426     dVAR;
3427     OP * VOL curop;
3428     OP *newop;
3429     VOL I32 type = o->op_type;
3430     SV * VOL sv = NULL;
3431     int ret = 0;
3432     I32 oldscope;
3433     OP *old_next;
3434     SV * const oldwarnhook = PL_warnhook;
3435     SV * const olddiehook  = PL_diehook;
3436     COP not_compiling;
3437     dJMPENV;
3438
3439     PERL_ARGS_ASSERT_FOLD_CONSTANTS;
3440
3441     if (!(PL_opargs[type] & OA_FOLDCONST))
3442         goto nope;
3443
3444     switch (type) {
3445     case OP_UCFIRST:
3446     case OP_LCFIRST:
3447     case OP_UC:
3448     case OP_LC:
3449     case OP_FC:
3450     case OP_SLT:
3451     case OP_SGT:
3452     case OP_SLE:
3453     case OP_SGE:
3454     case OP_SCMP:
3455     case OP_SPRINTF:
3456         /* XXX what about the numeric ops? */
3457         if (IN_LOCALE_COMPILETIME)
3458             goto nope;
3459         break;
3460     case OP_PACK:
3461         if (!cLISTOPo->op_first->op_sibling
3462           || cLISTOPo->op_first->op_sibling->op_type != OP_CONST)
3463             goto nope;
3464         {
3465             SV * const sv = cSVOPx_sv(cLISTOPo->op_first->op_sibling);
3466             if (!SvPOK(sv) || SvGMAGICAL(sv)) goto nope;
3467             {
3468                 const char *s = SvPVX_const(sv);
3469                 while (s < SvEND(sv)) {
3470                     if (*s == 'p' || *s == 'P') goto nope;
3471                     s++;
3472                 }
3473             }
3474         }
3475         break;
3476     case OP_REPEAT:
3477         if (o->op_private & OPpREPEAT_DOLIST) goto nope;
3478         break;
3479     case OP_SREFGEN:
3480         if (cUNOPx(cUNOPo->op_first)->op_first->op_type != OP_CONST
3481          || SvPADTMP(cSVOPx_sv(cUNOPx(cUNOPo->op_first)->op_first)))
3482             goto nope;
3483     }
3484
3485     if (PL_parser && PL_parser->error_count)
3486         goto nope;              /* Don't try to run w/ errors */
3487
3488     for (curop = LINKLIST(o); curop != o; curop = LINKLIST(curop)) {
3489         const OPCODE type = curop->op_type;
3490         if ((type != OP_CONST || (curop->op_private & OPpCONST_BARE)) &&
3491             type != OP_LIST &&
3492             type != OP_SCALAR &&
3493             type != OP_NULL &&
3494             type != OP_PUSHMARK)
3495         {
3496             goto nope;
3497         }
3498     }
3499
3500     curop = LINKLIST(o);
3501     old_next = o->op_next;
3502     o->op_next = 0;
3503     PL_op = curop;
3504
3505     oldscope = PL_scopestack_ix;
3506     create_eval_scope(G_FAKINGEVAL);
3507
3508     /* Verify that we don't need to save it:  */
3509     assert(PL_curcop == &PL_compiling);
3510     StructCopy(&PL_compiling, &not_compiling, COP);
3511     PL_curcop = &not_compiling;
3512     /* The above ensures that we run with all the correct hints of the
3513        currently compiling COP, but that IN_PERL_RUNTIME is not true. */
3514     assert(IN_PERL_RUNTIME);
3515     PL_warnhook = PERL_WARNHOOK_FATAL;
3516     PL_diehook  = NULL;
3517     JMPENV_PUSH(ret);
3518
3519     switch (ret) {
3520     case 0:
3521         CALLRUNOPS(aTHX);
3522         sv = *(PL_stack_sp--);
3523         if (o->op_targ && sv == PAD_SV(o->op_targ)) {   /* grab pad temp? */
3524 #ifdef PERL_MAD
3525             /* Can't simply swipe the SV from the pad, because that relies on
3526                the op being freed "real soon now". Under MAD, this doesn't
3527                happen (see the #ifdef below).  */
3528             sv = newSVsv(sv);
3529 #else
3530             pad_swipe(o->op_targ,  FALSE);
3531 #endif
3532         }
3533         else if (SvTEMP(sv)) {                  /* grab mortal temp? */
3534             SvREFCNT_inc_simple_void(sv);
3535             SvTEMP_off(sv);
3536         }
3537         else { assert(SvIMMORTAL(sv)); }
3538         break;
3539     case 3:
3540         /* Something tried to die.  Abandon constant folding.  */
3541         /* Pretend the error never happened.  */
3542         CLEAR_ERRSV();
3543         o->op_next = old_next;
3544         break;
3545     default:
3546         JMPENV_POP;
3547         /* Don't expect 1 (setjmp failed) or 2 (something called my_exit)  */
3548         PL_warnhook = oldwarnhook;
3549         PL_diehook  = olddiehook;
3550         /* XXX note that this croak may fail as we've already blown away
3551          * the stack - eg any nested evals */
3552         Perl_croak(aTHX_ "panic: fold_constants JMPENV_PUSH returned %d", ret);
3553     }
3554     JMPENV_POP;
3555     PL_warnhook = oldwarnhook;
3556     PL_diehook  = olddiehook;
3557     PL_curcop = &PL_compiling;
3558
3559     if (PL_scopestack_ix > oldscope)
3560         delete_eval_scope();
3561
3562     if (ret)
3563         goto nope;
3564
3565 #ifndef PERL_MAD
3566     op_free(o);
3567 #endif
3568     assert(sv);
3569     if (type == OP_STRINGIFY) SvPADTMP_off(sv);
3570     else if (!SvIMMORTAL(sv)) SvPADTMP_on(sv);
3571     if (type == OP_RV2GV)
3572         newop = newGVOP(OP_GV, 0, MUTABLE_GV(sv));
3573     else
3574     {
3575         newop = newSVOP(OP_CONST, 0, MUTABLE_SV(sv));
3576         if (type != OP_STRINGIFY) newop->op_folded = 1;
3577     }
3578     op_getmad(o,newop,'f');
3579     return newop;
3580
3581  nope:
3582     return o;
3583 }
3584
3585 static OP *
3586 S_gen_constant_list(pTHX_ OP *o)
3587 {
3588     dVAR;
3589     OP *curop;
3590     const SSize_t oldtmps_floor = PL_tmps_floor;
3591     SV **svp;
3592     AV *av;
3593
3594     list(o);
3595     if (PL_parser && PL_parser->error_count)
3596         return o;               /* Don't attempt to run with errors */
3597
3598     PL_op = curop = LINKLIST(o);
3599     o->op_next = 0;
3600     CALL_PEEP(curop);
3601     Perl_pp_pushmark(aTHX);
3602     CALLRUNOPS(aTHX);
3603     PL_op = curop;
3604     assert (!(curop->op_flags & OPf_SPECIAL));
3605     assert(curop->op_type == OP_RANGE);
3606     Perl_pp_anonlist(aTHX);
3607     PL_tmps_floor = oldtmps_floor;
3608
3609     o->op_type = OP_RV2AV;
3610     o->op_ppaddr = PL_ppaddr[OP_RV2AV];
3611     o->op_flags &= ~OPf_REF;    /* treat \(1..2) like an ordinary list */
3612     o->op_flags |= OPf_PARENS;  /* and flatten \(1..2,3) */
3613     o->op_opt = 0;              /* needs to be revisited in rpeep() */
3614     curop = ((UNOP*)o)->op_first;
3615     av = (AV *)SvREFCNT_inc_NN(*PL_stack_sp--);
3616     ((UNOP*)o)->op_first = newSVOP(OP_CONST, 0, (SV *)av);
3617     if (AvFILLp(av) != -1)
3618         for (svp = AvARRAY(av) + AvFILLp(av); svp >= AvARRAY(av); --svp)
3619             SvPADTMP_on(*svp);
3620 #ifdef PERL_MAD
3621     op_getmad(curop,o,'O');
3622 #else
3623     op_free(curop);
3624 #endif
3625     LINKLIST(o);
3626     return list(o);
3627 }
3628
3629 OP *
3630 Perl_convert(pTHX_ I32 type, I32 flags, OP *o)
3631 {
3632     dVAR;
3633     if (type < 0) type = -type, flags |= OPf_SPECIAL;
3634     if (!o || o->op_type != OP_LIST)
3635         o = newLISTOP(OP_LIST, 0, o, NULL);
3636     else
3637         o->op_flags &= ~OPf_WANT;
3638
3639     if (!(PL_opargs[type] & OA_MARK))
3640         op_null(cLISTOPo->op_first);
3641     else {
3642         OP * const kid2 = cLISTOPo->op_first->op_sibling;
3643         if (kid2 && kid2->op_type == OP_COREARGS) {
3644             op_null(cLISTOPo->op_first);
3645             kid2->op_private |= OPpCOREARGS_PUSHMARK;
3646         }
3647     }   
3648
3649     o->op_type = (OPCODE)type;
3650     o->op_ppaddr = PL_ppaddr[type];
3651     o->op_flags |= flags;
3652
3653     o = CHECKOP(type, o);
3654     if (o->op_type != (unsigned)type)
3655         return o;
3656
3657     return fold_constants(op_integerize(op_std_init(o)));
3658 }
3659
3660 /*
3661 =head1 Optree Manipulation Functions
3662 */
3663
3664 /* List constructors */
3665
3666 /*
3667 =for apidoc Am|OP *|op_append_elem|I32 optype|OP *first|OP *last
3668
3669 Append an item to the list of ops contained directly within a list-type
3670 op, returning the lengthened list.  I<first> is the list-type op,
3671 and I<last> is the op to append to the list.  I<optype> specifies the
3672 intended opcode for the list.  If I<first> is not already a list of the
3673 right type, it will be upgraded into one.  If either I<first> or I<last>
3674 is null, the other is returned unchanged.
3675
3676 =cut
3677 */
3678
3679 OP *
3680 Perl_op_append_elem(pTHX_ I32 type, OP *first, OP *last)
3681 {
3682     if (!first)
3683         return last;
3684
3685     if (!last)
3686         return first;
3687
3688     if (first->op_type != (unsigned)type
3689         || (type == OP_LIST && (first->op_flags & OPf_PARENS)))
3690     {
3691         return newLISTOP(type, 0, first, last);
3692     }
3693
3694     if (first->op_flags & OPf_KIDS)
3695         ((LISTOP*)first)->op_last->op_sibling = last;
3696     else {
3697         first->op_flags |= OPf_KIDS;
3698         ((LISTOP*)first)->op_first = last;
3699     }
3700     ((LISTOP*)first)->op_last = last;
3701     return first;
3702 }
3703
3704 /*
3705 =for apidoc Am|OP *|op_append_list|I32 optype|OP *first|OP *last
3706
3707 Concatenate the lists of ops contained directly within two list-type ops,
3708 returning the combined list.  I<first> and I<last> are the list-type ops
3709 to concatenate.  I<optype> specifies the intended opcode for the list.
3710 If either I<first> or I<last> is not already a list of the right type,
3711 it will be upgraded into one.  If either I<first> or I<last> is null,
3712 the other is returned unchanged.
3713
3714 =cut
3715 */
3716
3717 OP *
3718 Perl_op_append_list(pTHX_ I32 type, OP *first, OP *last)
3719 {
3720     if (!first)
3721         return last;
3722
3723     if (!last)
3724         return first;
3725
3726     if (first->op_type != (unsigned)type)
3727         return op_prepend_elem(type, first, last);
3728
3729     if (last->op_type != (unsigned)type)
3730         return op_append_elem(type, first, last);
3731
3732     ((LISTOP*)first)->op_last->op_sibling = ((LISTOP*)last)->op_first;
3733     ((LISTOP*)first)->op_last = ((LISTOP*)last)->op_last;
3734     first->op_flags |= (last->op_flags & OPf_KIDS);
3735
3736 #ifdef PERL_MAD
3737     if (((LISTOP*)last)->op_first && first->op_madprop) {
3738         MADPROP *mp = ((LISTOP*)last)->op_first->op_madprop;
3739         if (mp) {
3740             while (mp->mad_next)
3741                 mp = mp->mad_next;
3742             mp->mad_next = first->op_madprop;
3743         }
3744         else {
3745             ((LISTOP*)last)->op_first->op_madprop = first->op_madprop;
3746         }
3747     }
3748     first->op_madprop = last->op_madprop;
3749     last->op_madprop = 0;
3750 #endif
3751
3752     S_op_destroy(aTHX_ last);
3753
3754     return first;
3755 }
3756
3757 /*
3758 =for apidoc Am|OP *|op_prepend_elem|I32 optype|OP *first|OP *last
3759
3760 Prepend an item to the list of ops contained directly within a list-type
3761 op, returning the lengthened list.  I<first> is the op to prepend to the
3762 list, and I<last> is the list-type op.  I<optype> specifies the intended
3763 opcode for the list.  If I<last> is not already a list of the right type,
3764 it will be upgraded into one.  If either I<first> or I<last> is null,
3765 the other is returned unchanged.
3766
3767 =cut
3768 */
3769
3770 OP *
3771 Perl_op_prepend_elem(pTHX_ I32 type, OP *first, OP *last)
3772 {
3773     if (!first)
3774         return last;
3775
3776     if (!last)
3777         return first;
3778
3779     if (last->op_type == (unsigned)type) {
3780         if (type == OP_LIST) {  /* already a PUSHMARK there */
3781             first->op_sibling = ((LISTOP*)last)->op_first->op_sibling;
3782             ((LISTOP*)last)->op_first->op_sibling = first;
3783             if (!(first->op_flags & OPf_PARENS))
3784                 last->op_flags &= ~OPf_PARENS;
3785         }
3786         else {
3787             if (!(last->op_flags & OPf_KIDS)) {
3788                 ((LISTOP*)last)->op_last = first;
3789                 last->op_flags |= OPf_KIDS;
3790             }
3791             first->op_sibling = ((LISTOP*)last)->op_first;
3792             ((LISTOP*)last)->op_first = first;
3793         }
3794         last->op_flags |= OPf_KIDS;
3795         return last;
3796     }
3797
3798     return newLISTOP(type, 0, first, last);
3799 }
3800
3801 /* Constructors */
3802
3803 #ifdef PERL_MAD
3804  
3805 TOKEN *
3806 Perl_newTOKEN(pTHX_ I32 optype, YYSTYPE lval, MADPROP* madprop)
3807 {
3808     TOKEN *tk;
3809     Newxz(tk, 1, TOKEN);
3810     tk->tk_type = (OPCODE)optype;
3811     tk->tk_type = 12345;
3812     tk->tk_lval = lval;
3813     tk->tk_mad = madprop;
3814     return tk;
3815 }
3816
3817 void
3818 Perl_token_free(pTHX_ TOKEN* tk)
3819 {
3820     PERL_ARGS_ASSERT_TOKEN_FREE;
3821
3822     if (tk->tk_type != 12345)
3823         return;
3824     mad_free(tk->tk_mad);
3825     Safefree(tk);
3826 }
3827
3828 void
3829 Perl_token_getmad(pTHX_ TOKEN* tk, OP* o, char slot)
3830 {
3831     MADPROP* mp;
3832     MADPROP* tm;
3833
3834     PERL_ARGS_ASSERT_TOKEN_GETMAD;
3835
3836     if (tk->tk_type != 12345) {
3837         Perl_warner(aTHX_ packWARN(WARN_MISC),
3838              "Invalid TOKEN object ignored");
3839         return;
3840     }
3841     tm = tk->tk_mad;
3842     if (!tm)
3843         return;
3844
3845     /* faked up qw list? */
3846     if (slot == '(' &&
3847         tm->mad_type == MAD_SV &&
3848         SvPVX((SV *)tm->mad_val)[0] == 'q')
3849             slot = 'x';
3850
3851     if (o) {
3852         mp = o->op_madprop;
3853         if (mp) {
3854             for (;;) {
3855                 /* pretend constant fold didn't happen? */
3856                 if (mp->mad_key == 'f' &&
3857                     (o->op_type == OP_CONST ||
3858                      o->op_type == OP_GV) )
3859                 {
3860                     token_getmad(tk,(OP*)mp->mad_val,slot);
3861                     return;
3862                 }
3863                 if (!mp->mad_next)
3864                     break;
3865                 mp = mp->mad_next;
3866             }
3867             mp->mad_next = tm;
3868             mp = mp->mad_next;
3869         }
3870         else {
3871             o->op_madprop = tm;
3872             mp = o->op_madprop;
3873         }
3874         if (mp->mad_key == 'X')
3875             mp->mad_key = slot; /* just change the first one */
3876
3877         tk->tk_mad = 0;
3878     }
3879     else
3880         mad_free(tm);
3881     Safefree(tk);
3882 }
3883
3884 void
3885 Perl_op_getmad_weak(pTHX_ OP* from, OP* o, char slot)
3886 {
3887     MADPROP* mp;
3888     if (!from)
3889         return;
3890     if (o) {
3891         mp = o->op_madprop;
3892         if (mp) {
3893             for (;;) {
3894                 /* pretend constant fold didn't happen? */
3895                 if (mp->mad_key == 'f' &&
3896                     (o->op_type == OP_CONST ||
3897                      o->op_type == OP_GV) )
3898                 {
3899                     op_getmad(from,(OP*)mp->mad_val,slot);
3900                     return;
3901                 }
3902                 if (!mp->mad_next)
3903                     break;
3904                 mp = mp->mad_next;
3905             }
3906             mp->mad_next = newMADPROP(slot,MAD_OP,from,0);
3907         }
3908         else {
3909             o->op_madprop = newMADPROP(slot,MAD_OP,from,0);
3910         }
3911     }
3912 }
3913
3914 void
3915 Perl_op_getmad(pTHX_ OP* from, OP* o, char slot)
3916 {
3917     MADPROP* mp;
3918     if (!from)
3919         return;
3920     if (o) {
3921         mp = o->op_madprop;
3922         if (mp) {
3923             for (;;) {
3924                 /* pretend constant fold didn't happen? */
3925                 if (mp->mad_key == 'f' &&
3926                     (o->op_type == OP_CONST ||
3927                      o->op_type == OP_GV) )
3928                 {
3929                     op_getmad(from,(OP*)mp->mad_val,slot);
3930                     return;
3931                 }
3932                 if (!mp->mad_next)
3933                     break;
3934                 mp = mp->mad_next;
3935             }
3936             mp->mad_next = newMADPROP(slot,MAD_OP,from,1);
3937         }
3938         else {
3939             o->op_madprop = newMADPROP(slot,MAD_OP,from,1);
3940         }
3941     }
3942     else {
3943         PerlIO_printf(PerlIO_stderr(),
3944                       "DESTROYING op = %0"UVxf"\n", PTR2UV(from));
3945         op_free(from);
3946     }
3947 }
3948
3949 void
3950 Perl_prepend_madprops(pTHX_ MADPROP* mp, OP* o, char slot)
3951 {
3952     MADPROP* tm;
3953     if (!mp || !o)
3954         return;
3955     if (slot)
3956         mp->mad_key = slot;
3957     tm = o->op_madprop;
3958     o->op_madprop = mp;
3959     for (;;) {
3960         if (!mp->mad_next)
3961             break;
3962         mp = mp->mad_next;
3963     }
3964     mp->mad_next = tm;
3965 }
3966
3967 void
3968 Perl_append_madprops(pTHX_ MADPROP* tm, OP* o, char slot)
3969 {
3970     if (!o)
3971         return;
3972     addmad(tm, &(o->op_madprop), slot);
3973 }
3974
3975 void
3976 Perl_addmad(pTHX_ MADPROP* tm, MADPROP** root, char slot)
3977 {
3978     MADPROP* mp;
3979     if (!tm || !root)
3980         return;
3981     if (slot)
3982         tm->mad_key = slot;
3983     mp = *root;
3984     if (!mp) {
3985         *root = tm;
3986         return;
3987     }
3988     for (;;) {
3989         if (!mp->mad_next)
3990             break;
3991         mp = mp->mad_next;
3992     }
3993     mp->mad_next = tm;
3994 }
3995
3996 MADPROP *
3997 Perl_newMADsv(pTHX_ char key, SV* sv)
3998 {
3999     PERL_ARGS_ASSERT_NEWMADSV;
4000
4001     return newMADPROP(key, MAD_SV, sv, 0);
4002 }
4003
4004 MADPROP *
4005 Perl_newMADPROP(pTHX_ char key, char type, void* val, I32 vlen)
4006 {
4007     MADPROP *const mp = (MADPROP *) PerlMemShared_malloc(sizeof(MADPROP));
4008     mp->mad_next = 0;
4009     mp->mad_key = key;
4010     mp->mad_vlen = vlen;
4011     mp->mad_type = type;
4012     mp->mad_val = val;
4013 /*    PerlIO_printf(PerlIO_stderr(), "NEW  mp = %0x\n", mp);  */
4014     return mp;
4015 }
4016
4017 void
4018 Perl_mad_free(pTHX_ MADPROP* mp)
4019 {
4020 /*    PerlIO_printf(PerlIO_stderr(), "FREE mp = %0x\n", mp); */
4021     if (!mp)
4022         return;
4023     if (mp->mad_next)
4024         mad_free(mp->mad_next);
4025 /*    if (PL_parser && PL_parser->lex_state != LEX_NOTPARSING && mp->mad_vlen)
4026         PerlIO_printf(PerlIO_stderr(), "DESTROYING '%c'=<%s>\n", mp->mad_key & 255, mp->mad_val); */
4027     switch (mp->mad_type) {
4028     case MAD_NULL:
4029         break;
4030     case MAD_PV:
4031         Safefree(mp->mad_val);
4032         break;
4033     case MAD_OP:
4034         if (mp->mad_vlen)       /* vlen holds "strong/weak" boolean */
4035             op_free((OP*)mp->mad_val);
4036         break;
4037     case MAD_SV:
4038         sv_free(MUTABLE_SV(mp->mad_val));
4039         break;
4040     default:
4041         PerlIO_printf(PerlIO_stderr(), "Unrecognized mad\n");
4042         break;
4043     }
4044     PerlMemShared_free(mp);
4045 }
4046
4047 #endif
4048
4049 /*
4050 =head1 Optree construction
4051
4052 =for apidoc Am|OP *|newNULLLIST
4053
4054 Constructs, checks, and returns a new C<stub> op, which represents an
4055 empty list expression.
4056
4057 =cut
4058 */
4059
4060 OP *
4061 Perl_newNULLLIST(pTHX)
4062 {
4063     return newOP(OP_STUB, 0);
4064 }
4065
4066 static OP *
4067 S_force_list(pTHX_ OP *o)
4068 {
4069     if (!o || o->op_type != OP_LIST)
4070         o = newLISTOP(OP_LIST, 0, o, NULL);
4071     op_null(o);
4072     return o;
4073 }
4074
4075 /*
4076 =for apidoc Am|OP *|newLISTOP|I32 type|I32 flags|OP *first|OP *last
4077
4078 Constructs, checks, and returns an op of any list type.  I<type> is
4079 the opcode.  I<flags> gives the eight bits of C<op_flags>, except that
4080 C<OPf_KIDS> will be set automatically if required.  I<first> and I<last>
4081 supply up to two ops to be direct children of the list op; they are
4082 consumed by this function and become part of the constructed op tree.
4083
4084 =cut
4085 */
4086
4087 OP *
4088 Perl_newLISTOP(pTHX_ I32 type, I32 flags, OP *first, OP *last)
4089 {
4090     dVAR;
4091     LISTOP *listop;
4092
4093     assert((PL_opargs[type] & OA_CLASS_MASK) == OA_LISTOP);
4094
4095     NewOp(1101, listop, 1, LISTOP);
4096
4097     listop->op_type = (OPCODE)type;
4098     listop->op_ppaddr = PL_ppaddr[type];
4099     if (first || last)
4100         flags |= OPf_KIDS;
4101     listop->op_flags = (U8)flags;
4102
4103     if (!last && first)
4104         last = first;
4105     else if (!first && last)
4106         first = last;
4107     else if (first)
4108         first->op_sibling = last;
4109     listop->op_first = first;
4110     listop->op_last = last;
4111     if (type == OP_LIST) {
4112         OP* const pushop = newOP(OP_PUSHMARK, 0);
4113         pushop->op_sibling = first;
4114         listop->op_first = pushop;
4115         listop->op_flags |= OPf_KIDS;
4116         if (!last)
4117             listop->op_last = pushop;
4118     }
4119
4120     return CHECKOP(type, listop);
4121 }
4122
4123 /*
4124 =for apidoc Am|OP *|newOP|I32 type|I32 flags
4125
4126 Constructs, checks, and returns an op of any base type (any type that
4127 has no extra fields).  I<type> is the opcode.  I<flags> gives the
4128 eight bits of C<op_flags>, and, shifted up eight bits, the eight bits
4129 of C<op_private>.
4130
4131 =cut
4132 */
4133
4134 OP *
4135 Perl_newOP(pTHX_ I32 type, I32 flags)
4136 {
4137     dVAR;
4138     OP *o;
4139
4140     if (type == -OP_ENTEREVAL) {
4141         type = OP_ENTEREVAL;
4142         flags |= OPpEVAL_BYTES<<8;
4143     }
4144
4145     assert((PL_opargs[type] & OA_CLASS_MASK) == OA_BASEOP
4146         || (PL_opargs[type] & OA_CLASS_MASK) == OA_BASEOP_OR_UNOP
4147         || (PL_opargs[type] & OA_CLASS_MASK) == OA_FILESTATOP
4148         || (PL_opargs[type] & OA_CLASS_MASK) == OA_LOOPEXOP);
4149
4150     NewOp(1101, o, 1, OP);
4151     o->op_type = (OPCODE)type;
4152     o->op_ppaddr = PL_ppaddr[type];
4153     o->op_flags = (U8)flags;
4154
4155     o->op_next = o;
4156     o->op_private = (U8)(0 | (flags >> 8));
4157     if (PL_opargs[type] & OA_RETSCALAR)
4158         scalar(o);
4159     if (PL_opargs[type] & OA_TARGET)
4160         o->op_targ = pad_alloc(type, SVs_PADTMP);
4161     return CHECKOP(type, o);
4162 }
4163
4164 /*
4165 =for apidoc Am|OP *|newUNOP|I32 type|I32 flags|OP *first
4166
4167 Constructs, checks, and returns an op of any unary type.  I<type> is
4168 the opcode.  I<flags> gives the eight bits of C<op_flags>, except that
4169 C<OPf_KIDS> will be set automatically if required, and, shifted up eight
4170 bits, the eight bits of C<op_private>, except that the bit with value 1
4171 is automatically set.  I<first> supplies an optional op to be the direct
4172 child of the unary op; it is consumed by this function and become part
4173 of the constructed op tree.
4174
4175 =cut
4176 */
4177
4178 OP *
4179 Perl_newUNOP(pTHX_ I32 type, I32 flags, OP *first)
4180 {
4181     dVAR;
4182     UNOP *unop;
4183
4184     if (type == -OP_ENTEREVAL) {
4185         type = OP_ENTEREVAL;
4186         flags |= OPpEVAL_BYTES<<8;
4187     }
4188
4189     assert((PL_opargs[type] & OA_CLASS_MASK) == OA_UNOP
4190         || (PL_opargs[type] & OA_CLASS_MASK) == OA_BASEOP_OR_UNOP
4191         || (PL_opargs[type] & OA_CLASS_MASK) == OA_FILESTATOP
4192         || (PL_opargs[type] & OA_CLASS_MASK) == OA_LOOPEXOP
4193         || type == OP_SASSIGN
4194         || type == OP_ENTERTRY
4195         || type == OP_NULL );
4196
4197     if (!first)
4198         first = newOP(OP_STUB, 0);
4199     if (PL_opargs[type] & OA_MARK)
4200         first = force_list(first);
4201
4202     NewOp(1101, unop, 1, UNOP);
4203     unop->op_type = (OPCODE)type;
4204     unop->op_ppaddr = PL_ppaddr[type];
4205     unop->op_first = first;
4206     unop->op_flags = (U8)(flags | OPf_KIDS);
4207     unop->op_private = (U8)(1 | (flags >> 8));
4208     unop = (UNOP*) CHECKOP(type, unop);
4209     if (unop->op_next)
4210         return (OP*)unop;
4211
4212     return fold_constants(op_integerize(op_std_init((OP *) unop)));
4213 }
4214
4215 /*
4216 =for apidoc Am|OP *|newBINOP|I32 type|I32 flags|OP *first|OP *last
4217
4218 Constructs, checks, and returns an op of any binary type.  I<type>
4219 is the opcode.  I<flags> gives the eight bits of C<op_flags>, except
4220 that C<OPf_KIDS> will be set automatically, and, shifted up eight bits,
4221 the eight bits of C<op_private>, except that the bit with value 1 or
4222 2 is automatically set as required.  I<first> and I<last> supply up to
4223 two ops to be the direct children of the binary op; they are consumed
4224 by this function and become part of the constructed op tree.
4225
4226 =cut
4227 */
4228
4229 OP *
4230 Perl_newBINOP(pTHX_ I32 type, I32 flags, OP *first, OP *last)
4231 {
4232     dVAR;
4233     BINOP *binop;
4234
4235     assert((PL_opargs[type] & OA_CLASS_MASK) == OA_BINOP
4236         || type == OP_SASSIGN || type == OP_NULL );
4237
4238     NewOp(1101, binop, 1, BINOP);
4239
4240     if (!first)
4241         first = newOP(OP_NULL, 0);
4242
4243     binop->op_type = (OPCODE)type;
4244     binop->op_ppaddr = PL_ppaddr[type];
4245     binop->op_first = first;
4246     binop->op_flags = (U8)(flags | OPf_KIDS);
4247     if (!last) {
4248         last = first;
4249         binop->op_private = (U8)(1 | (flags >> 8));
4250     }
4251     else {
4252         binop->op_private = (U8)(2 | (flags >> 8));
4253         first->op_sibling = last;
4254     }
4255
4256     binop = (BINOP*)CHECKOP(type, binop);
4257     if (binop->op_next || binop->op_type != (OPCODE)type)
4258         return (OP*)binop;
4259
4260     binop->op_last = binop->op_first->op_sibling;
4261
4262     return fold_constants(op_integerize(op_std_init((OP *)binop)));
4263 }
4264
4265 static int uvcompare(const void *a, const void *b)
4266     __attribute__nonnull__(1)
4267     __attribute__nonnull__(2)
4268     __attribute__pure__;
4269 static int uvcompare(const void *a, const void *b)
4270 {
4271     if (*((const UV *)a) < (*(const UV *)b))
4272         return -1;
4273     if (*((const UV *)a) > (*(const UV *)b))
4274         return 1;
4275     if (*((const UV *)a+1) < (*(const UV *)b+1))
4276         return -1;
4277     if (*((const UV *)a+1) > (*(const UV *)b+1))
4278         return 1;
4279     return 0;
4280 }
4281
4282 static OP *
4283 S_pmtrans(pTHX_ OP *o, OP *expr, OP *repl)
4284 {
4285     dVAR;
4286     SV * const tstr = ((SVOP*)expr)->op_sv;
4287     SV * const rstr =
4288 #ifdef PERL_MAD
4289                         (repl->op_type == OP_NULL)
4290                             ? ((SVOP*)((LISTOP*)repl)->op_first)->op_sv :
4291 #endif
4292                               ((SVOP*)repl)->op_sv;
4293     STRLEN tlen;
4294     STRLEN rlen;
4295     const U8 *t = (U8*)SvPV_const(tstr, tlen);
4296     const U8 *r = (U8*)SvPV_const(rstr, rlen);
4297     I32 i;
4298     I32 j;
4299     I32 grows = 0;
4300     short *tbl;
4301
4302     const I32 complement = o->op_private & OPpTRANS_COMPLEMENT;
4303     const I32 squash     = o->op_private & OPpTRANS_SQUASH;
4304     I32 del              = o->op_private & OPpTRANS_DELETE;
4305     SV* swash;
4306
4307     PERL_ARGS_ASSERT_PMTRANS;
4308
4309     PL_hints |= HINT_BLOCK_SCOPE;
4310
4311     if (SvUTF8(tstr))
4312         o->op_private |= OPpTRANS_FROM_UTF;
4313
4314     if (SvUTF8(rstr))
4315         o->op_private |= OPpTRANS_TO_UTF;
4316
4317     if (o->op_private & (OPpTRANS_FROM_UTF|OPpTRANS_TO_UTF)) {
4318         SV* const listsv = newSVpvs("# comment\n");
4319         SV* transv = NULL;
4320         const U8* tend = t + tlen;
4321         const U8* rend = r + rlen;
4322         STRLEN ulen;
4323         UV tfirst = 1;
4324         UV tlast = 0;
4325         IV tdiff;
4326         UV rfirst = 1;
4327         UV rlast = 0;
4328         IV rdiff;
4329         IV diff;
4330         I32 none = 0;
4331         U32 max = 0;
4332         I32 bits;
4333         I32 havefinal = 0;
4334         U32 final = 0;
4335         const I32 from_utf  = o->op_private & OPpTRANS_FROM_UTF;
4336         const I32 to_utf    = o->op_private & OPpTRANS_TO_UTF;
4337         U8* tsave = NULL;
4338         U8* rsave = NULL;
4339         const U32 flags = UTF8_ALLOW_DEFAULT;
4340
4341         if (!from_utf) {
4342             STRLEN len = tlen;
4343             t = tsave = bytes_to_utf8(t, &len);
4344             tend = t + len;
4345         }
4346         if (!to_utf && rlen) {
4347             STRLEN len = rlen;
4348             r = rsave = bytes_to_utf8(r, &len);
4349             rend = r + len;
4350         }
4351
4352 /* There is a  snag with this code on EBCDIC: scan_const() in toke.c has
4353  * encoded chars in native encoding which makes ranges in the EBCDIC 0..255
4354  * odd.  */
4355
4356         if (complement) {
4357             U8 tmpbuf[UTF8_MAXBYTES+1];
4358             UV *cp;
4359             UV nextmin = 0;
4360             Newx(cp, 2*tlen, UV);
4361             i = 0;
4362             transv = newSVpvs("");
4363             while (t < tend) {
4364                 cp[2*i] = utf8n_to_uvchr(t, tend-t, &ulen, flags);
4365                 t += ulen;
4366                 if (t < tend && *t == ILLEGAL_UTF8_BYTE) {
4367                     t++;
4368                     cp[2*i+1] = utf8n_to_uvchr(t, tend-t, &ulen, flags);
4369                     t += ulen;
4370                 }
4371                 else {
4372                  cp[2*i+1] = cp[2*i];
4373                 }
4374                 i++;
4375             }
4376             qsort(cp, i, 2*sizeof(UV), uvcompare);
4377             for (j = 0; j < i; j++) {
4378                 UV  val = cp[2*j];
4379                 diff = val - nextmin;
4380                 if (diff > 0) {
4381                     t = uvchr_to_utf8(tmpbuf,nextmin);
4382                     sv_catpvn(transv, (char*)tmpbuf, t - tmpbuf);
4383                     if (diff > 1) {
4384                         U8  range_mark = ILLEGAL_UTF8_BYTE;
4385                         t = uvchr_to_utf8(tmpbuf, val - 1);
4386                         sv_catpvn(transv, (char *)&range_mark, 1);
4387                         sv_catpvn(transv, (char*)tmpbuf, t - tmpbuf);
4388                     }
4389                 }
4390                 val = cp[2*j+1];
4391                 if (val >= nextmin)
4392                     nextmin = val + 1;
4393             }
4394             t = uvchr_to_utf8(tmpbuf,nextmin);
4395             sv_catpvn(transv, (char*)tmpbuf, t - tmpbuf);
4396             {
4397                 U8 range_mark = ILLEGAL_UTF8_BYTE;
4398                 sv_catpvn(transv, (char *)&range_mark, 1);
4399             }
4400             t = uvchr_to_utf8(tmpbuf, 0x7fffffff);
4401             sv_catpvn(transv, (char*)tmpbuf, t - tmpbuf);
4402             t = (const U8*)SvPVX_const(transv);
4403             tlen = SvCUR(transv);
4404             tend = t + tlen;
4405             Safefree(cp);
4406         }
4407         else if (!rlen && !del) {
4408             r = t; rlen = tlen; rend = tend;
4409         }
4410         if (!squash) {
4411                 if ((!rlen && !del) || t == r ||
4412                     (tlen == rlen && memEQ((char *)t, (char *)r, tlen)))
4413                 {
4414                     o->op_private |= OPpTRANS_IDENTICAL;
4415                 }
4416         }
4417
4418         while (t < tend || tfirst <= tlast) {
4419             /* see if we need more "t" chars */
4420             if (tfirst > tlast) {
4421                 tfirst = (I32)utf8n_to_uvchr(t, tend - t, &ulen, flags);
4422                 t += ulen;
4423                 if (t < tend && *t == ILLEGAL_UTF8_BYTE) {      /* illegal utf8 val indicates range */
4424                     t++;
4425                     tlast = (I32)utf8n_to_uvchr(t, tend - t, &ulen, flags);
4426                     t += ulen;
4427                 }
4428                 else
4429                     tlast = tfirst;
4430             }
4431
4432             /* now see if we need more "r" chars */
4433             if (rfirst > rlast) {
4434                 if (r < rend) {
4435                     rfirst = (I32)utf8n_to_uvchr(r, rend - r, &ulen, flags);
4436                     r += ulen;
4437                     if (r < rend && *r == ILLEGAL_UTF8_BYTE) {  /* illegal utf8 val indicates range */
4438                         r++;
4439                         rlast = (I32)utf8n_to_uvchr(r, rend - r, &ulen, flags);
4440                         r += ulen;
4441                     }
4442                     else
4443                         rlast = rfirst;
4444                 }
4445                 else {
4446                     if (!havefinal++)
4447                         final = rlast;
4448                     rfirst = rlast = 0xffffffff;
4449                 }
4450             }
4451
4452             /* now see which range will peter our first, if either. */
4453             tdiff = tlast - tfirst;
4454             rdiff = rlast - rfirst;
4455
4456             if (tdiff <= rdiff)
4457                 diff = tdiff;
4458             else
4459                 diff = rdiff;
4460
4461             if (rfirst == 0xffffffff) {
4462                 diff = tdiff;   /* oops, pretend rdiff is infinite */
4463                 if (diff > 0)
4464                     Perl_sv_catpvf(aTHX_ listsv, "%04lx\t%04lx\tXXXX\n",
4465                                    (long)tfirst, (long)tlast);
4466                 else
4467                     Perl_sv_catpvf(aTHX_ listsv, "%04lx\t\tXXXX\n", (long)tfirst);
4468             }
4469             else {
4470                 if (diff > 0)
4471                     Perl_sv_catpvf(aTHX_ listsv, "%04lx\t%04lx\t%04lx\n",
4472                                    (long)tfirst, (long)(tfirst + diff),
4473                                    (long)rfirst);
4474                 else
4475                     Perl_sv_catpvf(aTHX_ listsv, "%04lx\t\t%04lx\n",
4476                                    (long)tfirst, (long)rfirst);
4477
4478                 if (rfirst + diff > max)
4479                     max = rfirst + diff;
4480                 if (!grows)
4481                     grows = (tfirst < rfirst &&
4482                              UNISKIP(tfirst) < UNISKIP(rfirst + diff));
4483                 rfirst += diff + 1;
4484             }
4485             tfirst += diff + 1;
4486         }
4487
4488         none = ++max;
4489         if (del)
4490             del = ++max;
4491
4492         if (max > 0xffff)
4493             bits = 32;
4494         else if (max > 0xff)
4495             bits = 16;
4496         else
4497             bits = 8;
4498
4499         swash = MUTABLE_SV(swash_init("utf8", "", listsv, bits, none));
4500 #ifdef USE_ITHREADS
4501         cPADOPo->op_padix = pad_alloc(OP_TRANS, SVf_READONLY);
4502         SvREFCNT_dec(PAD_SVl(cPADOPo->op_padix));
4503         PAD_SETSV(cPADOPo->op_padix, swash);
4504         SvPADTMP_on(swash);
4505         SvREADONLY_on(swash);
4506 #else
4507         cSVOPo->op_sv = swash;
4508 #endif
4509         SvREFCNT_dec(listsv);
4510         SvREFCNT_dec(transv);
4511
4512         if (!del && havefinal && rlen)
4513             (void)hv_store(MUTABLE_HV(SvRV(swash)), "FINAL", 5,
4514                            newSVuv((UV)final), 0);
4515
4516         if (grows)
4517             o->op_private |= OPpTRANS_GROWS;
4518
4519         Safefree(tsave);
4520         Safefree(rsave);
4521
4522 #ifdef PERL_MAD
4523         op_getmad(expr,o,'e');
4524         op_getmad(repl,o,'r');
4525 #else
4526         op_free(expr);
4527         op_free(repl);
4528 #endif
4529         return o;
4530     }
4531
4532     tbl = (short*)PerlMemShared_calloc(
4533         (o->op_private & OPpTRANS_COMPLEMENT) &&
4534             !(o->op_private & OPpTRANS_DELETE) ? 258 : 256,
4535         sizeof(short));
4536     cPVOPo->op_pv = (char*)tbl;
4537     if (complement) {
4538         for (i = 0; i < (I32)tlen; i++)
4539             tbl[t[i]] = -1;
4540         for (i = 0, j = 0; i < 256; i++) {
4541             if (!tbl[i]) {
4542                 if (j >= (I32)rlen) {
4543                     if (del)
4544                         tbl[i] = -2;
4545                     else if (rlen)
4546                         tbl[i] = r[j-1];
4547                     else
4548                         tbl[i] = (short)i;
4549                 }
4550                 else {
4551                     if (i < 128 && r[j] >= 128)
4552                         grows = 1;
4553                     tbl[i] = r[j++];
4554                 }
4555             }
4556         }
4557         if (!del) {
4558             if (!rlen) {
4559                 j = rlen;
4560                 if (!squash)
4561                     o->op_private |= OPpTRANS_IDENTICAL;
4562             }
4563             else if (j >= (I32)rlen)
4564                 j = rlen - 1;
4565             else {
4566                 tbl = 
4567                     (short *)
4568                     PerlMemShared_realloc(tbl,
4569                                           (0x101+rlen-j) * sizeof(short));
4570                 cPVOPo->op_pv = (char*)tbl;
4571             }
4572             tbl[0x100] = (short)(rlen - j);
4573             for (i=0; i < (I32)rlen - j; i++)
4574                 tbl[0x101+i] = r[j+i];
4575         }
4576     }
4577     else {
4578         if (!rlen && !del) {
4579             r = t; rlen = tlen;
4580             if (!squash)
4581                 o->op_private |= OPpTRANS_IDENTICAL;
4582         }
4583         else if (!squash && rlen == tlen && memEQ((char*)t, (char*)r, tlen)) {
4584             o->op_private |= OPpTRANS_IDENTICAL;
4585         }
4586         for (i = 0; i < 256; i++)
4587             tbl[i] = -1;
4588         for (i = 0, j = 0; i < (I32)tlen; i++,j++) {
4589             if (j >= (I32)rlen) {
4590                 if (del) {
4591                     if (tbl[t[i]] == -1)
4592                         tbl[t[i]] = -2;
4593                     continue;
4594                 }
4595                 --j;
4596             }
4597             if (tbl[t[i]] == -1) {
4598                 if (t[i] < 128 && r[j] >= 128)
4599                     grows = 1;
4600                 tbl[t[i]] = r[j];
4601             }
4602         }
4603     }
4604
4605     if(del && rlen == tlen) {
4606         Perl_ck_warner(aTHX_ packWARN(WARN_MISC), "Useless use of /d modifier in transliteration operator"); 
4607     } else if(rlen > tlen && !complement) {
4608         Perl_ck_warner(aTHX_ packWARN(WARN_MISC), "Replacement list is longer than search list");
4609     }
4610
4611     if (grows)
4612         o->op_private |= OPpTRANS_GROWS;
4613 #ifdef PERL_MAD
4614     op_getmad(expr,o,'e');
4615     op_getmad(repl,o,'r');
4616 #else
4617     op_free(expr);
4618     op_free(repl);
4619 #endif
4620
4621     return o;
4622 }
4623
4624 /*
4625 =for apidoc Am|OP *|newPMOP|I32 type|I32 flags
4626
4627 Constructs, checks, and returns an op of any pattern matching type.
4628 I<type> is the opcode.  I<flags> gives the eight bits of C<op_flags>
4629 and, shifted up eight bits, the eight bits of C<op_private>.
4630
4631 =cut
4632 */
4633
4634 OP *
4635 Perl_newPMOP(pTHX_ I32 type, I32 flags)
4636 {
4637     dVAR;
4638     PMOP *pmop;
4639
4640     assert((PL_opargs[type] & OA_CLASS_MASK) == OA_PMOP);
4641
4642     NewOp(1101, pmop, 1, PMOP);
4643     pmop->op_type = (OPCODE)type;
4644     pmop->op_ppaddr = PL_ppaddr[type];
4645     pmop->op_flags = (U8)flags;
4646     pmop->op_private = (U8)(0 | (flags >> 8));
4647
4648     if (PL_hints & HINT_RE_TAINT)
4649         pmop->op_pmflags |= PMf_RETAINT;
4650     if (IN_LOCALE_COMPILETIME) {
4651         set_regex_charset(&(pmop->op_pmflags), REGEX_LOCALE_CHARSET);
4652     }
4653     else if ((! (PL_hints & HINT_BYTES))
4654                 /* Both UNI_8_BIT and locale :not_characters imply Unicode */
4655              && (PL_hints & (HINT_UNI_8_BIT|HINT_LOCALE_NOT_CHARS)))
4656     {
4657         set_regex_charset(&(pmop->op_pmflags), REGEX_UNICODE_CHARSET);
4658     }
4659     if (PL_hints & HINT_RE_FLAGS) {
4660         SV *reflags = Perl_refcounted_he_fetch_pvn(aTHX_
4661          PL_compiling.cop_hints_hash, STR_WITH_LEN("reflags"), 0, 0
4662         );
4663         if (reflags && SvOK(reflags)) pmop->op_pmflags |= SvIV(reflags);
4664         reflags = Perl_refcounted_he_fetch_pvn(aTHX_
4665          PL_compiling.cop_hints_hash, STR_WITH_LEN("reflags_charset"), 0, 0
4666         );
4667         if (reflags && SvOK(reflags)) {
4668             set_regex_charset(&(pmop->op_pmflags), (regex_charset)SvIV(reflags));
4669         }
4670     }
4671
4672
4673 #ifdef USE_ITHREADS
4674     assert(SvPOK(PL_regex_pad[0]));
4675     if (SvCUR(PL_regex_pad[0])) {
4676         /* Pop off the "packed" IV from the end.  */
4677         SV *const repointer_list = PL_regex_pad[0];
4678         const char *p = SvEND(repointer_list) - sizeof(IV);
4679         const IV offset = *((IV*)p);
4680
4681         assert(SvCUR(repointer_list) % sizeof(IV) == 0);
4682
4683         SvEND_set(repointer_list, p);
4684
4685         pmop->op_pmoffset = offset;
4686         /* This slot should be free, so assert this:  */
4687         assert(PL_regex_pad[offset] == &PL_sv_undef);
4688     } else {
4689         SV * const repointer = &PL_sv_undef;
4690         av_push(PL_regex_padav, repointer);
4691         pmop->op_pmoffset = av_len(PL_regex_padav);
4692         PL_regex_pad = AvARRAY(PL_regex_padav);
4693     }
4694 #endif
4695
4696     return CHECKOP(type, pmop);
4697 }
4698
4699 /* Given some sort of match op o, and an expression expr containing a
4700  * pattern, either compile expr into a regex and attach it to o (if it's
4701  * constant), or convert expr into a runtime regcomp op sequence (if it's
4702  * not)
4703  *
4704  * isreg indicates that the pattern is part of a regex construct, eg
4705  * $x =~ /pattern/ or split /pattern/, as opposed to $x =~ $pattern or
4706  * split "pattern", which aren't. In the former case, expr will be a list
4707  * if the pattern contains more than one term (eg /a$b/) or if it contains
4708  * a replacement, ie s/// or tr///.
4709  *
4710  * When the pattern has been compiled within a new anon CV (for
4711  * qr/(?{...})/ ), then floor indicates the savestack level just before
4712  * the new sub was created
4713  */
4714
4715 OP *
4716 Perl_pmruntime(pTHX_ OP *o, OP *expr, bool isreg, I32 floor)
4717 {
4718     dVAR;
4719     PMOP *pm;
4720     LOGOP *rcop;
4721     I32 repl_has_vars = 0;
4722     OP* repl = NULL;
4723     bool is_trans = (o->op_type == OP_TRANS || o->op_type == OP_TRANSR);
4724     bool is_compiletime;
4725     bool has_code;
4726
4727     PERL_ARGS_ASSERT_PMRUNTIME;
4728
4729     /* for s/// and tr///, last element in list is the replacement; pop it */
4730
4731     if (is_trans || o->op_type == OP_SUBST) {
4732         OP* kid;
4733         repl = cLISTOPx(expr)->op_last;
4734         kid = cLISTOPx(expr)->op_first;
4735         while (kid->op_sibling != repl)
4736             kid = kid->op_sibling;
4737         kid->op_sibling = NULL;
4738         cLISTOPx(expr)->op_last = kid;
4739     }
4740
4741     /* for TRANS, convert LIST/PUSH/CONST into CONST, and pass to pmtrans() */
4742
4743     if (is_trans) {
4744         OP* const oe = expr;
4745         assert(expr->op_type == OP_LIST);
4746         assert(cLISTOPx(expr)->op_first->op_type == OP_PUSHMARK);
4747         assert(cLISTOPx(expr)->op_first->op_sibling == cLISTOPx(expr)->op_last);
4748         expr = cLISTOPx(oe)->op_last;
4749         cLISTOPx(oe)->op_first->op_sibling = NULL;
4750         cLISTOPx(oe)->op_last = NULL;
4751         op_free(oe);
4752
4753         return pmtrans(o, expr, repl);
4754     }
4755
4756     /* find whether we have any runtime or code elements;
4757      * at the same time, temporarily set the op_next of each DO block;
4758      * then when we LINKLIST, this will cause the DO blocks to be excluded
4759      * from the op_next chain (and from having LINKLIST recursively
4760      * applied to them). We fix up the DOs specially later */
4761
4762     is_compiletime = 1;
4763     has_code = 0;
4764     if (expr->op_type == OP_LIST) {
4765         OP *o;
4766         for (o = cLISTOPx(expr)->op_first; o; o = o->op_sibling) {
4767             if (o->op_type == OP_NULL && (o->op_flags & OPf_SPECIAL)) {
4768                 has_code = 1;
4769                 assert(!o->op_next && o->op_sibling);
4770                 o->op_next = o->op_sibling;
4771             }
4772             else if (o->op_type != OP_CONST && o->op_type != OP_PUSHMARK)
4773                 is_compiletime = 0;
4774         }
4775     }
4776     else if (expr->op_type != OP_CONST)
4777         is_compiletime = 0;
4778
4779     LINKLIST(expr);
4780
4781     /* fix up DO blocks; treat each one as a separate little sub;
4782      * also, mark any arrays as LIST/REF */
4783
4784     if (expr->op_type == OP_LIST) {
4785         OP *o;
4786         for (o = cLISTOPx(expr)->op_first; o; o = o->op_sibling) {
4787
4788             if (o->op_type == OP_PADAV || o->op_type == OP_RV2AV) {
4789                 assert( !(o->op_flags  & OPf_WANT));
4790                 /* push the array rather than its contents. The regex
4791                  * engine will retrieve and join the elements later */
4792                 o->op_flags |= (OPf_WANT_LIST | OPf_REF);
4793                 continue;
4794             }
4795
4796             if (!(o->op_type == OP_NULL && (o->op_flags & OPf_SPECIAL)))
4797                 continue;
4798             o->op_next = NULL; /* undo temporary hack from above */
4799             scalar(o);
4800             LINKLIST(o);
4801             if (cLISTOPo->op_first->op_type == OP_LEAVE) {
4802                 LISTOP *leaveop = cLISTOPx(cLISTOPo->op_first);
4803                 /* skip ENTER */
4804                 assert(leaveop->op_first->op_type == OP_ENTER);
4805                 assert(leaveop->op_first->op_sibling);
4806                 o->op_next = leaveop->op_first->op_sibling;
4807                 /* skip leave */
4808                 assert(leaveop->op_flags & OPf_KIDS);
4809                 assert(leaveop->op_last->op_next == (OP*)leaveop);
4810                 leaveop->op_next = NULL; /* stop on last op */
4811                 op_null((OP*)leaveop);
4812             }
4813             else {
4814                 /* skip SCOPE */
4815                 OP *scope = cLISTOPo->op_first;
4816                 assert(scope->op_type == OP_SCOPE);
4817                 assert(scope->op_flags & OPf_KIDS);
4818                 scope->op_next = NULL; /* stop on last op */
4819                 op_null(scope);
4820             }
4821             /* have to peep the DOs individually as we've removed it from
4822              * the op_next chain */
4823             CALL_PEEP(o);
4824             if (is_compiletime)
4825                 /* runtime finalizes as part of finalizing whole tree */
4826                 finalize_optree(o);
4827         }
4828     }
4829     else if (expr->op_type == OP_PADAV || expr->op_type == OP_RV2AV) {
4830         assert( !(expr->op_flags  & OPf_WANT));
4831         /* push the array rather than its contents. The regex
4832          * engine will retrieve and join the elements later */
4833         expr->op_flags |= (OPf_WANT_LIST | OPf_REF);
4834     }
4835
4836     PL_hints |= HINT_BLOCK_SCOPE;
4837     pm = (PMOP*)o;
4838     assert(floor==0 || (pm->op_pmflags & PMf_HAS_CV));
4839
4840     if (is_compiletime) {
4841         U32 rx_flags = pm->op_pmflags & RXf_PMf_COMPILETIME;
4842         regexp_engine const *eng = current_re_engine();
4843
4844         if (o->op_flags & OPf_SPECIAL)
4845             rx_flags |= RXf_SPLIT;
4846
4847         if (!has_code || !eng->op_comp) {
4848             /* compile-time simple constant pattern */
4849
4850             if ((pm->op_pmflags & PMf_HAS_CV) && !has_code) {
4851                 /* whoops! we guessed that a qr// had a code block, but we
4852                  * were wrong (e.g. /[(?{}]/ ). Throw away the PL_compcv
4853                  * that isn't required now. Note that we have to be pretty
4854                  * confident that nothing used that CV's pad while the
4855                  * regex was parsed */
4856                 assert(AvFILLp(PL_comppad) == 0); /* just @_ */
4857                 /* But we know that one op is using this CV's slab. */
4858                 cv_forget_slab(PL_compcv);
4859                 LEAVE_SCOPE(floor);
4860                 pm->op_pmflags &= ~PMf_HAS_CV;
4861             }
4862
4863             PM_SETRE(pm,
4864                 eng->op_comp
4865                     ? eng->op_comp(aTHX_ NULL, 0, expr, eng, NULL, NULL,
4866                                         rx_flags, pm->op_pmflags)
4867                     : Perl_re_op_compile(aTHX_ NULL, 0, expr, eng, NULL, NULL,
4868                                         rx_flags, pm->op_pmflags)
4869             );
4870 #ifdef PERL_MAD
4871             op_getmad(expr,(OP*)pm,'e');
4872 #else
4873             op_free(expr);
4874 #endif
4875         }
4876         else {
4877             /* compile-time pattern that includes literal code blocks */
4878             REGEXP* re = eng->op_comp(aTHX_ NULL, 0, expr, eng, NULL, NULL,
4879                         rx_flags,
4880                         (pm->op_pmflags |
4881                             ((PL_hints & HINT_RE_EVAL) ? PMf_USE_RE_EVAL : 0))
4882                     );
4883             PM_SETRE(pm, re);
4884             if (pm->op_pmflags & PMf_HAS_CV) {
4885                 CV *cv;
4886                 /* this QR op (and the anon sub we embed it in) is never
4887                  * actually executed. It's just a placeholder where we can
4888                  * squirrel away expr in op_code_list without the peephole
4889                  * optimiser etc processing it for a second time */
4890                 OP *qr = newPMOP(OP_QR, 0);
4891                 ((PMOP*)qr)->op_code_list = expr;
4892
4893                 /* handle the implicit sub{} wrapped round the qr/(?{..})/ */
4894                 SvREFCNT_inc_simple_void(PL_compcv);
4895                 cv = newATTRSUB(floor, 0, NULL, NULL, qr);
4896                 ReANY(re)->qr_anoncv = cv;
4897
4898                 /* attach the anon CV to the pad so that
4899                  * pad_fixup_inner_anons() can find it */
4900                 (void)pad_add_anon(cv, o->op_type);
4901                 SvREFCNT_inc_simple_void(cv);
4902             }
4903             else {
4904                 pm->op_code_list = expr;
4905             }
4906         }
4907     }
4908     else {
4909         /* runtime pattern: build chain of regcomp etc ops */
4910         bool reglist;
4911         PADOFFSET cv_targ = 0;
4912
4913         reglist = isreg && expr->op_type == OP_LIST;
4914         if (reglist)
4915             op_null(expr);
4916
4917         if (has_code) {
4918             pm->op_code_list = expr;
4919             /* don't free op_code_list; its ops are embedded elsewhere too */
4920             pm->op_pmflags |= PMf_CODELIST_PRIVATE;
4921         }
4922
4923         if (o->op_flags & OPf_SPECIAL)
4924             pm->op_pmflags |= PMf_SPLIT;
4925
4926         /* the OP_REGCMAYBE is a placeholder in the non-threaded case
4927          * to allow its op_next to be pointed past the regcomp and
4928          * preceding stacking ops;
4929          * OP_REGCRESET is there to reset taint before executing the
4930          * stacking ops */
4931         if (pm->op_pmflags & PMf_KEEP || TAINTING_get)
4932             expr = newUNOP((TAINTING_get ? OP_REGCRESET : OP_REGCMAYBE),0,expr);
4933
4934         if (pm->op_pmflags & PMf_HAS_CV) {
4935             /* we have a runtime qr with literal code. This means
4936              * that the qr// has been wrapped in a new CV, which
4937              * means that runtime consts, vars etc will have been compiled
4938              * against a new pad. So... we need to execute those ops
4939              * within the environment of the new CV. So wrap them in a call
4940              * to a new anon sub. i.e. for
4941              *
4942              *     qr/a$b(?{...})/,
4943              *
4944              * we build an anon sub that looks like
4945              *
4946              *     sub { "a", $b, '(?{...})' }
4947              *
4948              * and call it, passing the returned list to regcomp.
4949              * Or to put it another way, the list of ops that get executed
4950              * are:
4951              *
4952              *     normal              PMf_HAS_CV
4953              *     ------              -------------------
4954              *                         pushmark (for regcomp)
4955              *                         pushmark (for entersub)
4956              *                         pushmark (for refgen)
4957              *                         anoncode
4958              *                         refgen
4959              *                         entersub
4960              *     regcreset                  regcreset
4961              *     pushmark                   pushmark
4962              *     const("a")                 const("a")
4963              *     gvsv(b)                    gvsv(b)
4964              *     const("(?{...})")          const("(?{...})")
4965              *                                leavesub
4966              *     regcomp             regcomp
4967              */
4968
4969             SvREFCNT_inc_simple_void(PL_compcv);
4970             /* these lines are just an unrolled newANONATTRSUB */
4971             expr = newSVOP(OP_ANONCODE, 0,
4972                     MUTABLE_SV(newATTRSUB(floor, 0, NULL, NULL, expr)));
4973             cv_targ = expr->op_targ;
4974             expr = newUNOP(OP_REFGEN, 0, expr);
4975
4976             expr = list(force_list(newUNOP(OP_ENTERSUB, 0, scalar(expr))));
4977         }
4978
4979         NewOp(1101, rcop, 1, LOGOP);
4980         rcop->op_type = OP_REGCOMP;
4981         rcop->op_ppaddr = PL_ppaddr[OP_REGCOMP];
4982         rcop->op_first = scalar(expr);
4983         rcop->op_flags |= OPf_KIDS
4984                             | ((PL_hints & HINT_RE_EVAL) ? OPf_SPECIAL : 0)
4985                             | (reglist ? OPf_STACKED : 0);
4986         rcop->op_private = 0;
4987         rcop->op_other = o;
4988         rcop->op_targ = cv_targ;
4989
4990         /* /$x/ may cause an eval, since $x might be qr/(?{..})/  */
4991         if (PL_hints & HINT_RE_EVAL) PL_cv_has_eval = 1;
4992
4993         /* establish postfix order */
4994         if (expr->op_type == OP_REGCRESET || expr->op_type == OP_REGCMAYBE) {
4995             LINKLIST(expr);
4996             rcop->op_next = expr;
4997             ((UNOP*)expr)->op_first->op_next = (OP*)rcop;
4998         }
4999         else {
5000             rcop->op_next = LINKLIST(expr);
5001             expr->op_next = (OP*)rcop;
5002         }
5003
5004         op_prepend_elem(o->op_type, scalar((OP*)rcop), o);
5005     }
5006
5007     if (repl) {
5008         OP *curop = repl;
5009         bool konst;
5010         /* If we are looking at s//.../e with a single statement, get past
5011            the implicit do{}. */
5012         if (curop->op_type == OP_NULL && curop->op_flags & OPf_KIDS
5013          && cUNOPx(curop)->op_first->op_type == OP_SCOPE
5014          && cUNOPx(curop)->op_first->op_flags & OPf_KIDS) {
5015             OP *kid = cUNOPx(cUNOPx(curop)->op_first)->op_first;
5016             if (kid->op_type == OP_NULL && kid->op_sibling
5017              && !kid->op_sibling->op_sibling)
5018                 curop = kid->op_sibling;
5019         }
5020         if (curop->op_type == OP_CONST)
5021             konst = TRUE;
5022         else if (( (curop->op_type == OP_RV2SV ||
5023                     curop->op_type == OP_RV2AV ||
5024                     curop->op_type == OP_RV2HV ||
5025                     curop->op_type == OP_RV2GV)
5026                    && cUNOPx(curop)->op_first
5027                    && cUNOPx(curop)->op_first->op_type == OP_GV )
5028                 || curop->op_type == OP_PADSV
5029                 || curop->op_type == OP_PADAV
5030                 || curop->op_type == OP_PADHV
5031                 || curop->op_type == OP_PADANY) {
5032             repl_has_vars = 1;
5033             konst = TRUE;
5034         }
5035         else konst = FALSE;
5036         if (konst
5037             && !(repl_has_vars
5038                  && (!PM_GETRE(pm)
5039                      || !RX_PRELEN(PM_GETRE(pm))
5040                      || RX_EXTFLAGS(PM_GETRE(pm)) & RXf_EVAL_SEEN)))
5041         {
5042             pm->op_pmflags |= PMf_CONST;        /* const for long enough */
5043             op_prepend_elem(o->op_type, scalar(repl), o);
5044         }
5045         else {
5046             NewOp(1101, rcop, 1, LOGOP);
5047             rcop->op_type = OP_SUBSTCONT;
5048             rcop->op_ppaddr = PL_ppaddr[OP_SUBSTCONT];
5049             rcop->op_first = scalar(repl);
5050             rcop->op_flags |= OPf_KIDS;
5051             rcop->op_private = 1;
5052             rcop->op_other = o;
5053
5054             /* establish postfix order */
5055             rcop->op_next = LINKLIST(repl);
5056             repl->op_next = (OP*)rcop;
5057
5058             pm->op_pmreplrootu.op_pmreplroot = scalar((OP*)rcop);
5059             assert(!(pm->op_pmflags & PMf_ONCE));
5060             pm->op_pmstashstartu.op_pmreplstart = LINKLIST(rcop);
5061             rcop->op_next = 0;
5062         }
5063     }
5064
5065     return (OP*)pm;
5066 }
5067
5068 /*
5069 =for apidoc Am|OP *|newSVOP|I32 type|I32 flags|SV *sv
5070
5071 Constructs, checks, and returns an op of any type that involves an
5072 embedded SV.  I<type> is the opcode.  I<flags> gives the eight bits
5073 of C<op_flags>.  I<sv> gives the SV to embed in the op; this function
5074 takes ownership of one reference to it.
5075
5076 =cut
5077 */
5078
5079 OP *
5080 Perl_newSVOP(pTHX_ I32 type, I32 flags, SV *sv)
5081 {
5082     dVAR;
5083     SVOP *svop;
5084
5085     PERL_ARGS_ASSERT_NEWSVOP;
5086
5087     assert((PL_opargs[type] & OA_CLASS_MASK) == OA_SVOP
5088         || (PL_opargs[type] & OA_CLASS_MASK) == OA_PVOP_OR_SVOP
5089         || (PL_opargs[type] & OA_CLASS_MASK) == OA_FILESTATOP);
5090
5091     NewOp(1101, svop, 1, SVOP);
5092     svop->op_type = (OPCODE)type;
5093     svop->op_ppaddr = PL_ppaddr[type];
5094     svop->op_sv = sv;
5095     svop->op_next = (OP*)svop;
5096     svop->op_flags = (U8)flags;
5097     svop->op_private = (U8)(0 | (flags >> 8));
5098     if (PL_opargs[type] & OA_RETSCALAR)
5099         scalar((OP*)svop);
5100     if (PL_opargs[type] & OA_TARGET)
5101         svop->op_targ = pad_alloc(type, SVs_PADTMP);
5102     return CHECKOP(type, svop);
5103 }
5104
5105 #ifdef USE_ITHREADS
5106
5107 /*
5108 =for apidoc Am|OP *|newPADOP|I32 type|I32 flags|SV *sv
5109
5110 Constructs, checks, and returns an op of any type that involves a
5111 reference to a pad element.  I<type> is the opcode.  I<flags> gives the
5112 eight bits of C<op_flags>.  A pad slot is automatically allocated, and
5113 is populated with I<sv>; this function takes ownership of one reference
5114 to it.
5115
5116 This function only exists if Perl has been compiled to use ithreads.
5117
5118 =cut
5119 */
5120
5121 OP *
5122 Perl_newPADOP(pTHX_ I32 type, I32 flags, SV *sv)
5123 {
5124     dVAR;
5125     PADOP *padop;
5126
5127     PERL_ARGS_ASSERT_NEWPADOP;
5128
5129     assert((PL_opargs[type] & OA_CLASS_MASK) == OA_SVOP
5130         || (PL_opargs[type] & OA_CLASS_MASK) == OA_PVOP_OR_SVOP
5131         || (PL_opargs[type] & OA_CLASS_MASK) == OA_FILESTATOP);
5132
5133     NewOp(1101, padop, 1, PADOP);
5134     padop->op_type = (OPCODE)type;
5135     padop->op_ppaddr = PL_ppaddr[type];
5136     padop->op_padix = pad_alloc(type, SVs_PADTMP);
5137     SvREFCNT_dec(PAD_SVl(padop->op_padix));
5138     PAD_SETSV(padop->op_padix, sv);
5139     assert(sv);
5140     SvPADTMP_on(sv);
5141     padop->op_next = (OP*)padop;
5142     padop->op_flags = (U8)flags;
5143     if (PL_opargs[type] & OA_RETSCALAR)
5144         scalar((OP*)padop);
5145     if (PL_opargs[type] & OA_TARGET)
5146         padop->op_targ = pad_alloc(type, SVs_PADTMP);
5147     return CHECKOP(type, padop);
5148 }
5149
5150 #endif /* USE_ITHREADS */
5151
5152 /*
5153 =for apidoc Am|OP *|newGVOP|I32 type|I32 flags|GV *gv
5154
5155 Constructs, checks, and returns an op of any type that involves an
5156 embedded reference to a GV.  I<type> is the opcode.  I<flags> gives the
5157 eight bits of C<op_flags>.  I<gv> identifies the GV that the op should
5158 reference; calling this function does not transfer ownership of any
5159 reference to it.
5160
5161 =cut
5162 */
5163
5164 OP *
5165 Perl_newGVOP(pTHX_ I32 type, I32 flags, GV *gv)
5166 {
5167     dVAR;
5168
5169     PERL_ARGS_ASSERT_NEWGVOP;
5170
5171 #ifdef USE_ITHREADS
5172     GvIN_PAD_on(gv);
5173     return newPADOP(type, flags, SvREFCNT_inc_simple_NN(gv));
5174 #else
5175     return newSVOP(type, flags, SvREFCNT_inc_simple_NN(gv));
5176 #endif
5177 }
5178
5179 /*
5180 =for apidoc Am|OP *|newPVOP|I32 type|I32 flags|char *pv
5181
5182 Constructs, checks, and returns an op of any type that involves an
5183 embedded C-level pointer (PV).  I<type> is the opcode.  I<flags> gives
5184 the eight bits of C<op_flags>.  I<pv> supplies the C-level pointer, which
5185 must have been allocated using C<PerlMemShared_malloc>; the memory will
5186 be freed when the op is destroyed.
5187
5188 =cut
5189 */
5190
5191 OP *
5192 Perl_newPVOP(pTHX_ I32 type, I32 flags, char *pv)
5193 {
5194     dVAR;
5195     const bool utf8 = cBOOL(flags & SVf_UTF8);
5196     PVOP *pvop;
5197
5198     flags &= ~SVf_UTF8;
5199
5200     assert((PL_opargs[type] & OA_CLASS_MASK) == OA_PVOP_OR_SVOP
5201         || type == OP_RUNCV
5202         || (PL_opargs[type] & OA_CLASS_MASK) == OA_LOOPEXOP);
5203
5204     NewOp(1101, pvop, 1, PVOP);
5205     pvop->op_type = (OPCODE)type;
5206     pvop->op_ppaddr = PL_ppaddr[type];
5207     pvop->op_pv = pv;
5208     pvop->op_next = (OP*)pvop;
5209     pvop->op_flags = (U8)flags;
5210     pvop->op_private = utf8 ? OPpPV_IS_UTF8 : 0;
5211     if (PL_opargs[type] & OA_RETSCALAR)
5212         scalar((OP*)pvop);
5213     if (PL_opargs[type] & OA_TARGET)
5214         pvop->op_targ = pad_alloc(type, SVs_PADTMP);
5215     return CHECKOP(type, pvop);
5216 }
5217
5218 #ifdef PERL_MAD
5219 OP*
5220 #else
5221 void
5222 #endif
5223 Perl_package(pTHX_ OP *o)
5224 {
5225     dVAR;
5226     SV *const sv = cSVOPo->op_sv;
5227 #ifdef PERL_MAD
5228     OP *pegop;
5229 #endif
5230
5231     PERL_ARGS_ASSERT_PACKAGE;
5232
5233     SAVEGENERICSV(PL_curstash);
5234     save_item(PL_curstname);
5235
5236     PL_curstash = (HV *)SvREFCNT_inc(gv_stashsv(sv, GV_ADD));
5237
5238     sv_setsv(PL_curstname, sv);
5239
5240     PL_hints |= HINT_BLOCK_SCOPE;
5241     PL_parser->copline = NOLINE;
5242     PL_parser->expect = XSTATE;
5243
5244 #ifndef PERL_MAD
5245     op_free(o);
5246 #else
5247     if (!PL_madskills) {
5248         op_free(o);
5249         return NULL;
5250     }
5251
5252     pegop = newOP(OP_NULL,0);
5253     op_getmad(o,pegop,'P');
5254     return pegop;
5255 #endif
5256 }
5257
5258 void
5259 Perl_package_version( pTHX_ OP *v )
5260 {
5261     dVAR;
5262     U32 savehints = PL_hints;
5263     PERL_ARGS_ASSERT_PACKAGE_VERSION;
5264     PL_hints &= ~HINT_STRICT_VARS;
5265     sv_setsv( GvSV(gv_fetchpvs("VERSION", GV_ADDMULTI, SVt_PV)), cSVOPx(v)->op_sv );
5266     PL_hints = savehints;
5267     op_free(v);
5268 }
5269
5270 #ifdef PERL_MAD
5271 OP*
5272 #else
5273 void
5274 #endif
5275 Perl_utilize(pTHX_ int aver, I32 floor, OP *version, OP *idop, OP *arg)
5276 {
5277     dVAR;
5278     OP *pack;
5279     OP *imop;
5280     OP *veop;
5281 #ifdef PERL_MAD
5282     OP *pegop = PL_madskills ? newOP(OP_NULL,0) : NULL;
5283 #endif
5284     SV *use_version = NULL;
5285
5286     PERL_ARGS_ASSERT_UTILIZE;
5287
5288     if (idop->op_type != OP_CONST)
5289         Perl_croak(aTHX_ "Module name must be constant");
5290
5291     if (PL_madskills)
5292         op_getmad(idop,pegop,'U');
5293
5294     veop = NULL;
5295
5296     if (version) {
5297         SV * const vesv = ((SVOP*)version)->op_sv;
5298
5299         if (PL_madskills)
5300             op_getmad(version,pegop,'V');
5301         if (!arg && !SvNIOKp(vesv)) {
5302             arg = version;
5303         }
5304         else {
5305             OP *pack;
5306             SV *meth;
5307
5308             if (version->op_type != OP_CONST || !SvNIOKp(vesv))
5309                 Perl_croak(aTHX_ "Version number must be a constant number");
5310
5311             /* Make copy of idop so we don't free it twice */
5312             pack = newSVOP(OP_CONST, 0, newSVsv(((SVOP*)idop)->op_sv));
5313
5314             /* Fake up a method call to VERSION */
5315             meth = newSVpvs_share("VERSION");
5316             veop = convert(OP_ENTERSUB, OPf_STACKED|OPf_SPECIAL,
5317                             op_append_elem(OP_LIST,
5318                                         op_prepend_elem(OP_LIST, pack, list(version)),
5319                                         newSVOP(OP_METHOD_NAMED, 0, meth)));
5320         }
5321     }
5322
5323     /* Fake up an import/unimport */
5324     if (arg && arg->op_type == OP_STUB) {
5325         if (PL_madskills)
5326             op_getmad(arg,pegop,'S');
5327         imop = arg;             /* no import on explicit () */
5328     }
5329     else if (SvNIOKp(((SVOP*)idop)->op_sv)) {
5330         imop = NULL;            /* use 5.0; */
5331         if (aver)
5332             use_version = ((SVOP*)idop)->op_sv;
5333         else
5334             idop->op_private |= OPpCONST_NOVER;
5335     }
5336     else {
5337         SV *meth;
5338
5339         if (PL_madskills)
5340             op_getmad(arg,pegop,'A');
5341
5342         /* Make copy of idop so we don't free it twice */
5343         pack = newSVOP(OP_CONST, 0, newSVsv(((SVOP*)idop)->op_sv));
5344
5345         /* Fake up a method call to import/unimport */
5346         meth = aver
5347             ? newSVpvs_share("import") : newSVpvs_share("unimport");
5348         imop = convert(OP_ENTERSUB, OPf_STACKED|OPf_SPECIAL,
5349                        op_append_elem(OP_LIST,
5350                                    op_prepend_elem(OP_LIST, pack, list(arg)),
5351                                    newSVOP(OP_METHOD_NAMED, 0, meth)));
5352     }
5353
5354     /* Fake up the BEGIN {}, which does its thing immediately. */
5355     newATTRSUB(floor,
5356         newSVOP(OP_CONST, 0, newSVpvs_share("BEGIN")),
5357         NULL,
5358         NULL,
5359         op_append_elem(OP_LINESEQ,
5360             op_append_elem(OP_LINESEQ,
5361                 newSTATEOP(0, NULL, newUNOP(OP_REQUIRE, 0, idop)),
5362                 newSTATEOP(0, NULL, veop)),
5363             newSTATEOP(0, NULL, imop) ));
5364
5365     if (use_version) {
5366         /* Enable the
5367          * feature bundle that corresponds to the required version. */
5368         use_version = sv_2mortal(new_version(use_version));
5369         S_enable_feature_bundle(aTHX_ use_version);
5370
5371         /* If a version >= 5.11.0 is requested, strictures are on by default! */
5372         if (vcmp(use_version,
5373                  sv_2mortal(upg_version(newSVnv(5.011000), FALSE))) >= 0) {
5374             if (!(PL_hints & HINT_EXPLICIT_STRICT_REFS))
5375                 PL_hints |= HINT_STRICT_REFS;
5376             if (!(PL_hints & HINT_EXPLICIT_STRICT_SUBS))
5377                 PL_hints |= HINT_STRICT_SUBS;
5378             if (!(PL_hints & HINT_EXPLICIT_STRICT_VARS))
5379                 PL_hints |= HINT_STRICT_VARS;
5380         }
5381         /* otherwise they are off */
5382         else {
5383             if (!(PL_hints & HINT_EXPLICIT_STRICT_REFS))
5384                 PL_hints &= ~HINT_STRICT_REFS;
5385             if (!(PL_hints & HINT_EXPLICIT_STRICT_SUBS))
5386                 PL_hints &= ~HINT_STRICT_SUBS;
5387             if (!(PL_hints & HINT_EXPLICIT_STRICT_VARS))
5388                 PL_hints &= ~HINT_STRICT_VARS;
5389         }
5390     }
5391
5392     /* The "did you use incorrect case?" warning used to be here.
5393      * The problem is that on case-insensitive filesystems one
5394      * might get false positives for "use" (and "require"):
5395      * "use Strict" or "require CARP" will work.  This causes
5396      * portability problems for the script: in case-strict
5397      * filesystems the script will stop working.
5398      *
5399      * The "incorrect case" warning checked whether "use Foo"
5400      * imported "Foo" to your namespace, but that is wrong, too:
5401      * there is no requirement nor promise in the language that
5402      * a Foo.pm should or would contain anything in package "Foo".
5403      *
5404      * There is very little Configure-wise that can be done, either:
5405      * the case-sensitivity of the build filesystem of Perl does not
5406      * help in guessing the case-sensitivity of the runtime environment.
5407      */
5408
5409     PL_hints |= HINT_BLOCK_SCOPE;
5410     PL_parser->copline = NOLINE;
5411     PL_parser->expect = XSTATE;
5412     PL_cop_seqmax++; /* Purely for B::*'s benefit */
5413     if (PL_cop_seqmax == PERL_PADSEQ_INTRO) /* not a legal value */
5414         PL_cop_seqmax++;
5415
5416 #ifdef PERL_MAD
5417     return pegop;
5418 #endif
5419 }
5420
5421 /*
5422 =head1 Embedding Functions
5423
5424 =for apidoc load_module
5425
5426 Loads the module whose name is pointed to by the string part of name.
5427 Note that the actual module name, not its filename, should be given.
5428 Eg, "Foo::Bar" instead of "Foo/Bar.pm".  flags can be any of
5429 PERL_LOADMOD_DENY, PERL_LOADMOD_NOIMPORT, or PERL_LOADMOD_IMPORT_OPS
5430 (or 0 for no flags). ver, if specified and not NULL, provides version semantics
5431 similar to C<use Foo::Bar VERSION>.  The optional trailing SV*
5432 arguments can be used to specify arguments to the module's import()
5433 method, similar to C<use Foo::Bar VERSION LIST>.  They must be
5434 terminated with a final NULL pointer.  Note that this list can only
5435 be omitted when the PERL_LOADMOD_NOIMPORT flag has been used.
5436 Otherwise at least a single NULL pointer to designate the default
5437 import list is required.
5438
5439 The reference count for each specified C<SV*> parameter is decremented.
5440
5441 =cut */
5442
5443 void
5444 Perl_load_module(pTHX_ U32 flags, SV *name, SV *ver, ...)
5445 {
5446     va_list args;
5447
5448     PERL_ARGS_ASSERT_LOAD_MODULE;
5449
5450     va_start(args, ver);
5451     vload_module(flags, name, ver, &args);
5452     va_end(args);
5453 }
5454
5455 #ifdef PERL_IMPLICIT_CONTEXT
5456 void
5457 Perl_load_module_nocontext(U32 flags, SV *name, SV *ver, ...)
5458 {
5459     dTHX;
5460     va_list args;
5461     PERL_ARGS_ASSERT_LOAD_MODULE_NOCONTEXT;
5462     va_start(args, ver);
5463     vload_module(flags, name, ver, &args);
5464     va_end(args);
5465 }
5466 #endif
5467
5468 void
5469 Perl_vload_module(pTHX_ U32 flags, SV *name, SV *ver, va_list *args)
5470 {
5471     dVAR;
5472     OP *veop, *imop;
5473     OP * const modname = newSVOP(OP_CONST, 0, name);
5474
5475     PERL_ARGS_ASSERT_VLOAD_MODULE;
5476
5477     modname->op_private |= OPpCONST_BARE;
5478     if (ver) {
5479         veop = newSVOP(OP_CONST, 0, ver);
5480     }
5481     else
5482         veop = NULL;
5483     if (flags & PERL_LOADMOD_NOIMPORT) {
5484         imop = sawparens(newNULLLIST());
5485     }
5486     else if (flags & PERL_LOADMOD_IMPORT_OPS) {
5487         imop = va_arg(*args, OP*);
5488     }
5489     else {
5490         SV *sv;
5491         imop = NULL;
5492         sv = va_arg(*args, SV*);
5493         while (sv) {
5494             imop = op_append_elem(OP_LIST, imop, newSVOP(OP_CONST, 0, sv));
5495             sv = va_arg(*args, SV*);
5496         }
5497     }
5498
5499     /* utilize() fakes up a BEGIN { require ..; import ... }, so make sure
5500      * that it has a PL_parser to play with while doing that, and also
5501      * that it doesn't mess with any existing parser, by creating a tmp
5502      * new parser with lex_start(). This won't actually be used for much,
5503      * since pp_require() will create another parser for the real work. */
5504
5505     ENTER;
5506     SAVEVPTR(PL_curcop);
5507     lex_start(NULL, NULL, LEX_START_SAME_FILTER);
5508     utilize(!(flags & PERL_LOADMOD_DENY), start_subparse(FALSE, 0),
5509             veop, modname, imop);
5510     LEAVE;
5511 }
5512
5513 PERL_STATIC_INLINE OP *
5514 S_new_entersubop(pTHX_ GV *gv, OP *arg)
5515 {
5516     return newUNOP(OP_ENTERSUB, OPf_STACKED,
5517                    newLISTOP(OP_LIST, 0, arg,
5518                              newUNOP(OP_RV2CV, 0,
5519                                      newGVOP(OP_GV, 0, gv))));
5520 }
5521
5522 OP *
5523 Perl_dofile(pTHX_ OP *term, I32 force_builtin)
5524 {
5525     dVAR;
5526     OP *doop;
5527     GV *gv;
5528
5529     PERL_ARGS_ASSERT_DOFILE;
5530
5531     if (!force_builtin && (gv = gv_override("do", 2))) {
5532         doop = S_new_entersubop(aTHX_ gv, term);
5533     }
5534     else {
5535         doop = newUNOP(OP_DOFILE, 0, scalar(term));
5536     }
5537     return doop;
5538 }
5539
5540 /*
5541 =head1 Optree construction
5542
5543 =for apidoc Am|OP *|newSLICEOP|I32 flags|OP *subscript|OP *listval
5544
5545 Constructs, checks, and returns an C<lslice> (list slice) op.  I<flags>
5546 gives the eight bits of C<op_flags>, except that C<OPf_KIDS> will
5547 be set automatically, and, shifted up eight bits, the eight bits of
5548 C<op_private>, except that the bit with value 1 or 2 is automatically
5549 set as required.  I<listval> and I<subscript> supply the parameters of
5550 the slice; they are consumed by this function and become part of the
5551 constructed op tree.
5552
5553 =cut
5554 */
5555
5556 OP *
5557 Perl_newSLICEOP(pTHX_ I32 flags, OP *subscript, OP *listval)
5558 {
5559     return newBINOP(OP_LSLICE, flags,
5560             list(force_list(subscript)),
5561             list(force_list(listval)) );
5562 }
5563
5564 STATIC I32
5565 S_is_list_assignment(pTHX_ const OP *o)
5566 {
5567     unsigned type;
5568     U8 flags;
5569
5570     if (!o)
5571         return TRUE;
5572
5573     if ((o->op_type == OP_NULL) && (o->op_flags & OPf_KIDS))
5574         o = cUNOPo->op_first;
5575
5576     flags = o->op_flags;
5577     type = o->op_type;
5578     if (type == OP_COND_EXPR) {
5579         const I32 t = is_list_assignment(cLOGOPo->op_first->op_sibling);
5580         const I32 f = is_list_assignment(cLOGOPo->op_first->op_sibling->op_sibling);
5581
5582         if (t && f)
5583             return TRUE;
5584         if (t || f)
5585             yyerror("Assignment to both a list and a scalar");
5586         return FALSE;
5587     }
5588
5589     if (type == OP_LIST &&
5590         (flags & OPf_WANT) == OPf_WANT_SCALAR &&
5591         o->op_private & OPpLVAL_INTRO)
5592         return FALSE;
5593
5594     if (type == OP_LIST || flags & OPf_PARENS ||
5595         type == OP_RV2AV || type == OP_RV2HV ||
5596         type == OP_ASLICE || type == OP_HSLICE ||
5597         type == OP_KVASLICE || type == OP_KVHSLICE)
5598         return TRUE;
5599
5600     if (type == OP_PADAV || type == OP_PADHV)
5601         return TRUE;
5602
5603     if (type == OP_RV2SV)
5604         return FALSE;
5605
5606     return FALSE;
5607 }
5608
5609 /*
5610   Helper function for newASSIGNOP to detection commonality between the
5611   lhs and the rhs.  Marks all variables with PL_generation.  If it
5612   returns TRUE the assignment must be able to handle common variables.
5613 */
5614 PERL_STATIC_INLINE bool
5615 S_aassign_common_vars(pTHX_ OP* o)
5616 {
5617     OP *curop;
5618     for (curop = cUNOPo->op_first; curop; curop=curop->op_sibling) {
5619         if (PL_opargs[curop->op_type] & OA_DANGEROUS) {
5620             if (curop->op_type == OP_GV) {
5621                 GV *gv = cGVOPx_gv(curop);
5622                 if (gv == PL_defgv
5623                     || (int)GvASSIGN_GENERATION(gv) == PL_generation)
5624                     return TRUE;
5625                 GvASSIGN_GENERATION_set(gv, PL_generation);
5626             }
5627             else if (curop->op_type == OP_PADSV ||
5628                 curop->op_type == OP_PADAV ||
5629                 curop->op_type == OP_PADHV ||
5630                 curop->op_type == OP_PADANY)
5631                 {
5632                     if (PAD_COMPNAME_GEN(curop->op_targ)
5633                         == (STRLEN)PL_generation)
5634                         return TRUE;
5635                     PAD_COMPNAME_GEN_set(curop->op_targ, PL_generation);
5636
5637                 }
5638             else if (curop->op_type == OP_RV2CV)
5639                 return T