This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Add a line directive to op.c and perl.c such that error messages refer to the origina...
[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
106 #define CALL_PEEP(o) CALL_FPTR(PL_peepp)(aTHX_ o)
107 #define CALL_OPFREEHOOK(o) if (PL_opfreehook) CALL_FPTR(PL_opfreehook)(aTHX_ o)
108
109 #if defined(PL_OP_SLAB_ALLOC)
110
111 #ifdef PERL_DEBUG_READONLY_OPS
112 #  define PERL_SLAB_SIZE 4096
113 #  include <sys/mman.h>
114 #endif
115
116 #ifndef PERL_SLAB_SIZE
117 #define PERL_SLAB_SIZE 2048
118 #endif
119
120 void *
121 Perl_Slab_Alloc(pTHX_ size_t sz)
122 {
123     dVAR;
124     /*
125      * To make incrementing use count easy PL_OpSlab is an I32 *
126      * To make inserting the link to slab PL_OpPtr is I32 **
127      * So compute size in units of sizeof(I32 *) as that is how Pl_OpPtr increments
128      * Add an overhead for pointer to slab and round up as a number of pointers
129      */
130     sz = (sz + 2*sizeof(I32 *) -1)/sizeof(I32 *);
131     if ((PL_OpSpace -= sz) < 0) {
132 #ifdef PERL_DEBUG_READONLY_OPS
133         /* We need to allocate chunk by chunk so that we can control the VM
134            mapping */
135         PL_OpPtr = (I32**) mmap(0, PERL_SLAB_SIZE*sizeof(I32*), PROT_READ|PROT_WRITE,
136                         MAP_ANON|MAP_PRIVATE, -1, 0);
137
138         DEBUG_m(PerlIO_printf(Perl_debug_log, "mapped %lu at %p\n",
139                               (unsigned long) PERL_SLAB_SIZE*sizeof(I32*),
140                               PL_OpPtr));
141         if(PL_OpPtr == MAP_FAILED) {
142             perror("mmap failed");
143             abort();
144         }
145 #else
146
147         PL_OpPtr = (I32 **) PerlMemShared_calloc(PERL_SLAB_SIZE,sizeof(I32*)); 
148 #endif
149         if (!PL_OpPtr) {
150             return NULL;
151         }
152         /* We reserve the 0'th I32 sized chunk as a use count */
153         PL_OpSlab = (I32 *) PL_OpPtr;
154         /* Reduce size by the use count word, and by the size we need.
155          * Latter is to mimic the '-=' in the if() above
156          */
157         PL_OpSpace = PERL_SLAB_SIZE - (sizeof(I32)+sizeof(I32 **)-1)/sizeof(I32 **) - sz;
158         /* Allocation pointer starts at the top.
159            Theory: because we build leaves before trunk allocating at end
160            means that at run time access is cache friendly upward
161          */
162         PL_OpPtr += PERL_SLAB_SIZE;
163
164 #ifdef PERL_DEBUG_READONLY_OPS
165         /* We remember this slab.  */
166         /* This implementation isn't efficient, but it is simple. */
167         PL_slabs = (I32**) realloc(PL_slabs, sizeof(I32**) * (PL_slab_count + 1));
168         PL_slabs[PL_slab_count++] = PL_OpSlab;
169         DEBUG_m(PerlIO_printf(Perl_debug_log, "Allocate %p\n", PL_OpSlab));
170 #endif
171     }
172     assert( PL_OpSpace >= 0 );
173     /* Move the allocation pointer down */
174     PL_OpPtr   -= sz;
175     assert( PL_OpPtr > (I32 **) PL_OpSlab );
176     *PL_OpPtr   = PL_OpSlab;    /* Note which slab it belongs to */
177     (*PL_OpSlab)++;             /* Increment use count of slab */
178     assert( PL_OpPtr+sz <= ((I32 **) PL_OpSlab + PERL_SLAB_SIZE) );
179     assert( *PL_OpSlab > 0 );
180     return (void *)(PL_OpPtr + 1);
181 }
182
183 #ifdef PERL_DEBUG_READONLY_OPS
184 void
185 Perl_pending_Slabs_to_ro(pTHX) {
186     /* Turn all the allocated op slabs read only.  */
187     U32 count = PL_slab_count;
188     I32 **const slabs = PL_slabs;
189
190     /* Reset the array of pending OP slabs, as we're about to turn this lot
191        read only. Also, do it ahead of the loop in case the warn triggers,
192        and a warn handler has an eval */
193
194     PL_slabs = NULL;
195     PL_slab_count = 0;
196
197     /* Force a new slab for any further allocation.  */
198     PL_OpSpace = 0;
199
200     while (count--) {
201         void *const start = slabs[count];
202         const size_t size = PERL_SLAB_SIZE* sizeof(I32*);
203         if(mprotect(start, size, PROT_READ)) {
204             Perl_warn(aTHX_ "mprotect for %p %lu failed with %d",
205                       start, (unsigned long) size, errno);
206         }
207     }
208
209     free(slabs);
210 }
211
212 STATIC void
213 S_Slab_to_rw(pTHX_ void *op)
214 {
215     I32 * const * const ptr = (I32 **) op;
216     I32 * const slab = ptr[-1];
217
218     PERL_ARGS_ASSERT_SLAB_TO_RW;
219
220     assert( ptr-1 > (I32 **) slab );
221     assert( ptr < ( (I32 **) slab + PERL_SLAB_SIZE) );
222     assert( *slab > 0 );
223     if(mprotect(slab, PERL_SLAB_SIZE*sizeof(I32*), PROT_READ|PROT_WRITE)) {
224         Perl_warn(aTHX_ "mprotect RW for %p %lu failed with %d",
225                   slab, (unsigned long) PERL_SLAB_SIZE*sizeof(I32*), errno);
226     }
227 }
228
229 OP *
230 Perl_op_refcnt_inc(pTHX_ OP *o)
231 {
232     if(o) {
233         Slab_to_rw(o);
234         ++o->op_targ;
235     }
236     return o;
237
238 }
239
240 PADOFFSET
241 Perl_op_refcnt_dec(pTHX_ OP *o)
242 {
243     PERL_ARGS_ASSERT_OP_REFCNT_DEC;
244     Slab_to_rw(o);
245     return --o->op_targ;
246 }
247 #else
248 #  define Slab_to_rw(op)
249 #endif
250
251 void
252 Perl_Slab_Free(pTHX_ void *op)
253 {
254     I32 * const * const ptr = (I32 **) op;
255     I32 * const slab = ptr[-1];
256     PERL_ARGS_ASSERT_SLAB_FREE;
257     assert( ptr-1 > (I32 **) slab );
258     assert( ptr < ( (I32 **) slab + PERL_SLAB_SIZE) );
259     assert( *slab > 0 );
260     Slab_to_rw(op);
261     if (--(*slab) == 0) {
262 #  ifdef NETWARE
263 #    define PerlMemShared PerlMem
264 #  endif
265         
266 #ifdef PERL_DEBUG_READONLY_OPS
267         U32 count = PL_slab_count;
268         /* Need to remove this slab from our list of slabs */
269         if (count) {
270             while (count--) {
271                 if (PL_slabs[count] == slab) {
272                     dVAR;
273                     /* Found it. Move the entry at the end to overwrite it.  */
274                     DEBUG_m(PerlIO_printf(Perl_debug_log,
275                                           "Deallocate %p by moving %p from %lu to %lu\n",
276                                           PL_OpSlab,
277                                           PL_slabs[PL_slab_count - 1],
278                                           PL_slab_count, count));
279                     PL_slabs[count] = PL_slabs[--PL_slab_count];
280                     /* Could realloc smaller at this point, but probably not
281                        worth it.  */
282                     if(munmap(slab, PERL_SLAB_SIZE*sizeof(I32*))) {
283                         perror("munmap failed");
284                         abort();
285                     }
286                     break;
287                 }
288             }
289         }
290 #else
291     PerlMemShared_free(slab);
292 #endif
293         if (slab == PL_OpSlab) {
294             PL_OpSpace = 0;
295         }
296     }
297 }
298 #endif
299 /*
300  * In the following definition, the ", (OP*)0" is just to make the compiler
301  * think the expression is of the right type: croak actually does a Siglongjmp.
302  */
303 #define CHECKOP(type,o) \
304     ((PL_op_mask && PL_op_mask[type])                           \
305      ? ( op_free((OP*)o),                                       \
306          Perl_croak(aTHX_ "'%s' trapped by operation mask", PL_op_desc[type]),  \
307          (OP*)0 )                                               \
308      : CALL_FPTR(PL_check[type])(aTHX_ (OP*)o))
309
310 #define RETURN_UNLIMITED_NUMBER (PERL_INT_MAX / 2)
311
312 STATIC const char*
313 S_gv_ename(pTHX_ GV *gv)
314 {
315     SV* const tmpsv = sv_newmortal();
316
317     PERL_ARGS_ASSERT_GV_ENAME;
318
319     gv_efullname3(tmpsv, gv, NULL);
320     return SvPV_nolen_const(tmpsv);
321 }
322
323 STATIC OP *
324 S_no_fh_allowed(pTHX_ OP *o)
325 {
326     PERL_ARGS_ASSERT_NO_FH_ALLOWED;
327
328     yyerror(Perl_form(aTHX_ "Missing comma after first argument to %s function",
329                  OP_DESC(o)));
330     return o;
331 }
332
333 STATIC OP *
334 S_too_few_arguments(pTHX_ OP *o, const char *name)
335 {
336     PERL_ARGS_ASSERT_TOO_FEW_ARGUMENTS;
337
338     yyerror(Perl_form(aTHX_ "Not enough arguments for %s", name));
339     return o;
340 }
341
342 STATIC OP *
343 S_too_many_arguments(pTHX_ OP *o, const char *name)
344 {
345     PERL_ARGS_ASSERT_TOO_MANY_ARGUMENTS;
346
347     yyerror(Perl_form(aTHX_ "Too many arguments for %s", name));
348     return o;
349 }
350
351 STATIC void
352 S_bad_type(pTHX_ I32 n, const char *t, const char *name, const OP *kid)
353 {
354     PERL_ARGS_ASSERT_BAD_TYPE;
355
356     yyerror(Perl_form(aTHX_ "Type of arg %d to %s must be %s (not %s)",
357                  (int)n, name, t, OP_DESC(kid)));
358 }
359
360 STATIC void
361 S_no_bareword_allowed(pTHX_ const OP *o)
362 {
363     PERL_ARGS_ASSERT_NO_BAREWORD_ALLOWED;
364
365     if (PL_madskills)
366         return;         /* various ok barewords are hidden in extra OP_NULL */
367     qerror(Perl_mess(aTHX_
368                      "Bareword \"%"SVf"\" not allowed while \"strict subs\" in use",
369                      SVfARG(cSVOPo_sv)));
370 }
371
372 /* "register" allocation */
373
374 PADOFFSET
375 Perl_allocmy(pTHX_ const char *const name)
376 {
377     dVAR;
378     PADOFFSET off;
379     const bool is_our = (PL_parser->in_my == KEY_our);
380
381     PERL_ARGS_ASSERT_ALLOCMY;
382
383     /* complain about "my $<special_var>" etc etc */
384     if (*name &&
385         !(is_our ||
386           isALPHA(name[1]) ||
387           (USE_UTF8_IN_NAMES && UTF8_IS_START(name[1])) ||
388           (name[1] == '_' && (*name == '$' || name[2]))))
389     {
390         /* name[2] is true if strlen(name) > 2  */
391         if (!isPRINT(name[1]) || strchr("\t\n\r\f", name[1])) {
392             yyerror(Perl_form(aTHX_ "Can't use global %c^%c%s in \"%s\"",
393                               name[0], toCTRL(name[1]), name + 2,
394                               PL_parser->in_my == KEY_state ? "state" : "my"));
395         } else {
396             yyerror(Perl_form(aTHX_ "Can't use global %s in \"%s\"",name,
397                               PL_parser->in_my == KEY_state ? "state" : "my"));
398         }
399     }
400
401     /* check for duplicate declaration */
402     pad_check_dup(name, is_our, (PL_curstash ? PL_curstash : PL_defstash));
403
404     /* allocate a spare slot and store the name in that slot */
405
406     off = pad_add_name(name,
407                     PL_parser->in_my_stash,
408                     (is_our
409                         /* $_ is always in main::, even with our */
410                         ? (PL_curstash && !strEQ(name,"$_") ? PL_curstash : PL_defstash)
411                         : NULL
412                     ),
413                     0, /*  not fake */
414                     PL_parser->in_my == KEY_state
415     );
416     /* anon sub prototypes contains state vars should always be cloned,
417      * otherwise the state var would be shared between anon subs */
418
419     if (PL_parser->in_my == KEY_state && CvANON(PL_compcv))
420         CvCLONE_on(PL_compcv);
421
422     return off;
423 }
424
425 /* free the body of an op without examining its contents.
426  * Always use this rather than FreeOp directly */
427
428 static void
429 S_op_destroy(pTHX_ OP *o)
430 {
431     if (o->op_latefree) {
432         o->op_latefreed = 1;
433         return;
434     }
435     FreeOp(o);
436 }
437
438 #ifdef USE_ITHREADS
439 #  define forget_pmop(a,b)      S_forget_pmop(aTHX_ a,b)
440 #else
441 #  define forget_pmop(a,b)      S_forget_pmop(aTHX_ a)
442 #endif
443
444 /* Destructor */
445
446 void
447 Perl_op_free(pTHX_ OP *o)
448 {
449     dVAR;
450     OPCODE type;
451
452     if (!o)
453         return;
454     if (o->op_latefreed) {
455         if (o->op_latefree)
456             return;
457         goto do_free;
458     }
459
460     type = o->op_type;
461     if (o->op_private & OPpREFCOUNTED) {
462         switch (type) {
463         case OP_LEAVESUB:
464         case OP_LEAVESUBLV:
465         case OP_LEAVEEVAL:
466         case OP_LEAVE:
467         case OP_SCOPE:
468         case OP_LEAVEWRITE:
469             {
470             PADOFFSET refcnt;
471             OP_REFCNT_LOCK;
472             refcnt = OpREFCNT_dec(o);
473             OP_REFCNT_UNLOCK;
474             if (refcnt) {
475                 /* Need to find and remove any pattern match ops from the list
476                    we maintain for reset().  */
477                 find_and_forget_pmops(o);
478                 return;
479             }
480             }
481             break;
482         default:
483             break;
484         }
485     }
486
487     /* Call the op_free hook if it has been set. Do it now so that it's called
488      * at the right time for refcounted ops, but still before all of the kids
489      * are freed. */
490     CALL_OPFREEHOOK(o);
491
492     if (o->op_flags & OPf_KIDS) {
493         register OP *kid, *nextkid;
494         for (kid = cUNOPo->op_first; kid; kid = nextkid) {
495             nextkid = kid->op_sibling; /* Get before next freeing kid */
496             op_free(kid);
497         }
498     }
499
500 #ifdef PERL_DEBUG_READONLY_OPS
501     Slab_to_rw(o);
502 #endif
503
504     /* COP* is not cleared by op_clear() so that we may track line
505      * numbers etc even after null() */
506     if (type == OP_NEXTSTATE || type == OP_DBSTATE
507             || (type == OP_NULL /* the COP might have been null'ed */
508                 && ((OPCODE)o->op_targ == OP_NEXTSTATE
509                     || (OPCODE)o->op_targ == OP_DBSTATE))) {
510         cop_free((COP*)o);
511     }
512
513     if (type == OP_NULL)
514         type = (OPCODE)o->op_targ;
515
516     op_clear(o);
517     if (o->op_latefree) {
518         o->op_latefreed = 1;
519         return;
520     }
521   do_free:
522     FreeOp(o);
523 #ifdef DEBUG_LEAKING_SCALARS
524     if (PL_op == o)
525         PL_op = NULL;
526 #endif
527 }
528
529 void
530 Perl_op_clear(pTHX_ OP *o)
531 {
532
533     dVAR;
534
535     PERL_ARGS_ASSERT_OP_CLEAR;
536
537 #ifdef PERL_MAD
538     /* if (o->op_madprop && o->op_madprop->mad_next)
539        abort(); */
540     /* FIXME for MAD - if I uncomment these two lines t/op/pack.t fails with
541        "modification of a read only value" for a reason I can't fathom why.
542        It's the "" stringification of $_, where $_ was set to '' in a foreach
543        loop, but it defies simplification into a small test case.
544        However, commenting them out has caused ext/List/Util/t/weak.t to fail
545        the last test.  */
546     /*
547       mad_free(o->op_madprop);
548       o->op_madprop = 0;
549     */
550 #endif    
551
552  retry:
553     switch (o->op_type) {
554     case OP_NULL:       /* Was holding old type, if any. */
555         if (PL_madskills && o->op_targ != OP_NULL) {
556             o->op_type = (Optype)o->op_targ;
557             o->op_targ = 0;
558             goto retry;
559         }
560     case OP_ENTEREVAL:  /* Was holding hints. */
561         o->op_targ = 0;
562         break;
563     default:
564         if (!(o->op_flags & OPf_REF)
565             || (PL_check[o->op_type] != MEMBER_TO_FPTR(Perl_ck_ftst)))
566             break;
567         /* FALL THROUGH */
568     case OP_GVSV:
569     case OP_GV:
570     case OP_AELEMFAST:
571         if (! (o->op_type == OP_AELEMFAST && o->op_flags & OPf_SPECIAL)) {
572             /* not an OP_PADAV replacement */
573 #ifdef USE_ITHREADS
574             if (cPADOPo->op_padix > 0) {
575                 /* No GvIN_PAD_off(cGVOPo_gv) here, because other references
576                  * may still exist on the pad */
577                 pad_swipe(cPADOPo->op_padix, TRUE);
578                 cPADOPo->op_padix = 0;
579             }
580 #else
581             SvREFCNT_dec(cSVOPo->op_sv);
582             cSVOPo->op_sv = NULL;
583 #endif
584         }
585         break;
586     case OP_METHOD_NAMED:
587     case OP_CONST:
588     case OP_HINTSEVAL:
589         SvREFCNT_dec(cSVOPo->op_sv);
590         cSVOPo->op_sv = NULL;
591 #ifdef USE_ITHREADS
592         /** Bug #15654
593           Even if op_clear does a pad_free for the target of the op,
594           pad_free doesn't actually remove the sv that exists in the pad;
595           instead it lives on. This results in that it could be reused as 
596           a target later on when the pad was reallocated.
597         **/
598         if(o->op_targ) {
599           pad_swipe(o->op_targ,1);
600           o->op_targ = 0;
601         }
602 #endif
603         break;
604     case OP_GOTO:
605     case OP_NEXT:
606     case OP_LAST:
607     case OP_REDO:
608         if (o->op_flags & (OPf_SPECIAL|OPf_STACKED|OPf_KIDS))
609             break;
610         /* FALL THROUGH */
611     case OP_TRANS:
612         if (o->op_private & (OPpTRANS_FROM_UTF|OPpTRANS_TO_UTF)) {
613 #ifdef USE_ITHREADS
614             if (cPADOPo->op_padix > 0) {
615                 pad_swipe(cPADOPo->op_padix, TRUE);
616                 cPADOPo->op_padix = 0;
617             }
618 #else
619             SvREFCNT_dec(cSVOPo->op_sv);
620             cSVOPo->op_sv = NULL;
621 #endif
622         }
623         else {
624             PerlMemShared_free(cPVOPo->op_pv);
625             cPVOPo->op_pv = NULL;
626         }
627         break;
628     case OP_SUBST:
629         op_free(cPMOPo->op_pmreplrootu.op_pmreplroot);
630         goto clear_pmop;
631     case OP_PUSHRE:
632 #ifdef USE_ITHREADS
633         if (cPMOPo->op_pmreplrootu.op_pmtargetoff) {
634             /* No GvIN_PAD_off here, because other references may still
635              * exist on the pad */
636             pad_swipe(cPMOPo->op_pmreplrootu.op_pmtargetoff, TRUE);
637         }
638 #else
639         SvREFCNT_dec(MUTABLE_SV(cPMOPo->op_pmreplrootu.op_pmtargetgv));
640 #endif
641         /* FALL THROUGH */
642     case OP_MATCH:
643     case OP_QR:
644 clear_pmop:
645         forget_pmop(cPMOPo, 1);
646         cPMOPo->op_pmreplrootu.op_pmreplroot = NULL;
647         /* we use the same protection as the "SAFE" version of the PM_ macros
648          * here since sv_clean_all might release some PMOPs
649          * after PL_regex_padav has been cleared
650          * and the clearing of PL_regex_padav needs to
651          * happen before sv_clean_all
652          */
653 #ifdef USE_ITHREADS
654         if(PL_regex_pad) {        /* We could be in destruction */
655             const IV offset = (cPMOPo)->op_pmoffset;
656             ReREFCNT_dec(PM_GETRE(cPMOPo));
657             PL_regex_pad[offset] = &PL_sv_undef;
658             sv_catpvn_nomg(PL_regex_pad[0], (const char *)&offset,
659                            sizeof(offset));
660         }
661 #else
662         ReREFCNT_dec(PM_GETRE(cPMOPo));
663         PM_SETRE(cPMOPo, NULL);
664 #endif
665
666         break;
667     }
668
669     if (o->op_targ > 0) {
670         pad_free(o->op_targ);
671         o->op_targ = 0;
672     }
673 }
674
675 STATIC void
676 S_cop_free(pTHX_ COP* cop)
677 {
678     PERL_ARGS_ASSERT_COP_FREE;
679
680     CopFILE_free(cop);
681     CopSTASH_free(cop);
682     if (! specialWARN(cop->cop_warnings))
683         PerlMemShared_free(cop->cop_warnings);
684     Perl_refcounted_he_free(aTHX_ cop->cop_hints_hash);
685 }
686
687 STATIC void
688 S_forget_pmop(pTHX_ PMOP *const o
689 #ifdef USE_ITHREADS
690               , U32 flags
691 #endif
692               )
693 {
694     HV * const pmstash = PmopSTASH(o);
695
696     PERL_ARGS_ASSERT_FORGET_PMOP;
697
698     if (pmstash && !SvIS_FREED(pmstash)) {
699         MAGIC * const mg = mg_find((const SV *)pmstash, PERL_MAGIC_symtab);
700         if (mg) {
701             PMOP **const array = (PMOP**) mg->mg_ptr;
702             U32 count = mg->mg_len / sizeof(PMOP**);
703             U32 i = count;
704
705             while (i--) {
706                 if (array[i] == o) {
707                     /* Found it. Move the entry at the end to overwrite it.  */
708                     array[i] = array[--count];
709                     mg->mg_len = count * sizeof(PMOP**);
710                     /* Could realloc smaller at this point always, but probably
711                        not worth it. Probably worth free()ing if we're the
712                        last.  */
713                     if(!count) {
714                         Safefree(mg->mg_ptr);
715                         mg->mg_ptr = NULL;
716                     }
717                     break;
718                 }
719             }
720         }
721     }
722     if (PL_curpm == o) 
723         PL_curpm = NULL;
724 #ifdef USE_ITHREADS
725     if (flags)
726         PmopSTASH_free(o);
727 #endif
728 }
729
730 STATIC void
731 S_find_and_forget_pmops(pTHX_ OP *o)
732 {
733     PERL_ARGS_ASSERT_FIND_AND_FORGET_PMOPS;
734
735     if (o->op_flags & OPf_KIDS) {
736         OP *kid = cUNOPo->op_first;
737         while (kid) {
738             switch (kid->op_type) {
739             case OP_SUBST:
740             case OP_PUSHRE:
741             case OP_MATCH:
742             case OP_QR:
743                 forget_pmop((PMOP*)kid, 0);
744             }
745             find_and_forget_pmops(kid);
746             kid = kid->op_sibling;
747         }
748     }
749 }
750
751 void
752 Perl_op_null(pTHX_ OP *o)
753 {
754     dVAR;
755
756     PERL_ARGS_ASSERT_OP_NULL;
757
758     if (o->op_type == OP_NULL)
759         return;
760     if (!PL_madskills)
761         op_clear(o);
762     o->op_targ = o->op_type;
763     o->op_type = OP_NULL;
764     o->op_ppaddr = PL_ppaddr[OP_NULL];
765 }
766
767 void
768 Perl_op_refcnt_lock(pTHX)
769 {
770     dVAR;
771     PERL_UNUSED_CONTEXT;
772     OP_REFCNT_LOCK;
773 }
774
775 void
776 Perl_op_refcnt_unlock(pTHX)
777 {
778     dVAR;
779     PERL_UNUSED_CONTEXT;
780     OP_REFCNT_UNLOCK;
781 }
782
783 /* Contextualizers */
784
785 #define LINKLIST(o) ((o)->op_next ? (o)->op_next : linklist((OP*)o))
786
787 static OP *
788 S_linklist(pTHX_ OP *o)
789 {
790     OP *first;
791
792     PERL_ARGS_ASSERT_LINKLIST;
793
794     if (o->op_next)
795         return o->op_next;
796
797     /* establish postfix order */
798     first = cUNOPo->op_first;
799     if (first) {
800         register OP *kid;
801         o->op_next = LINKLIST(first);
802         kid = first;
803         for (;;) {
804             if (kid->op_sibling) {
805                 kid->op_next = LINKLIST(kid->op_sibling);
806                 kid = kid->op_sibling;
807             } else {
808                 kid->op_next = o;
809                 break;
810             }
811         }
812     }
813     else
814         o->op_next = o;
815
816     return o->op_next;
817 }
818
819 static OP *
820 S_scalarkids(pTHX_ OP *o)
821 {
822     if (o && o->op_flags & OPf_KIDS) {
823         OP *kid;
824         for (kid = cLISTOPo->op_first; kid; kid = kid->op_sibling)
825             scalar(kid);
826     }
827     return o;
828 }
829
830 STATIC OP *
831 S_scalarboolean(pTHX_ OP *o)
832 {
833     dVAR;
834
835     PERL_ARGS_ASSERT_SCALARBOOLEAN;
836
837     if (o->op_type == OP_SASSIGN && cBINOPo->op_first->op_type == OP_CONST) {
838         if (ckWARN(WARN_SYNTAX)) {
839             const line_t oldline = CopLINE(PL_curcop);
840
841             if (PL_parser && PL_parser->copline != NOLINE)
842                 CopLINE_set(PL_curcop, PL_parser->copline);
843             Perl_warner(aTHX_ packWARN(WARN_SYNTAX), "Found = in conditional, should be ==");
844             CopLINE_set(PL_curcop, oldline);
845         }
846     }
847     return scalar(o);
848 }
849
850 OP *
851 Perl_scalar(pTHX_ OP *o)
852 {
853     dVAR;
854     OP *kid;
855
856     /* assumes no premature commitment */
857     if (!o || (PL_parser && PL_parser->error_count)
858          || (o->op_flags & OPf_WANT)
859          || o->op_type == OP_RETURN)
860     {
861         return o;
862     }
863
864     o->op_flags = (o->op_flags & ~OPf_WANT) | OPf_WANT_SCALAR;
865
866     switch (o->op_type) {
867     case OP_REPEAT:
868         scalar(cBINOPo->op_first);
869         break;
870     case OP_OR:
871     case OP_AND:
872     case OP_COND_EXPR:
873         for (kid = cUNOPo->op_first->op_sibling; kid; kid = kid->op_sibling)
874             scalar(kid);
875         break;
876         /* FALL THROUGH */
877     case OP_SPLIT:
878     case OP_MATCH:
879     case OP_QR:
880     case OP_SUBST:
881     case OP_NULL:
882     default:
883         if (o->op_flags & OPf_KIDS) {
884             for (kid = cUNOPo->op_first; kid; kid = kid->op_sibling)
885                 scalar(kid);
886         }
887         break;
888     case OP_LEAVE:
889     case OP_LEAVETRY:
890         kid = cLISTOPo->op_first;
891         scalar(kid);
892         while ((kid = kid->op_sibling)) {
893             if (kid->op_sibling)
894                 scalarvoid(kid);
895             else
896                 scalar(kid);
897         }
898         PL_curcop = &PL_compiling;
899         break;
900     case OP_SCOPE:
901     case OP_LINESEQ:
902     case OP_LIST:
903         for (kid = cLISTOPo->op_first; kid; kid = kid->op_sibling) {
904             if (kid->op_sibling)
905                 scalarvoid(kid);
906             else
907                 scalar(kid);
908         }
909         PL_curcop = &PL_compiling;
910         break;
911     case OP_SORT:
912         Perl_ck_warner(aTHX_ packWARN(WARN_VOID), "Useless use of sort in scalar context");
913         break;
914     }
915     return o;
916 }
917
918 OP *
919 Perl_scalarvoid(pTHX_ OP *o)
920 {
921     dVAR;
922     OP *kid;
923     const char* useless = NULL;
924     SV* sv;
925     U8 want;
926
927     PERL_ARGS_ASSERT_SCALARVOID;
928
929     /* trailing mad null ops don't count as "there" for void processing */
930     if (PL_madskills &&
931         o->op_type != OP_NULL &&
932         o->op_sibling &&
933         o->op_sibling->op_type == OP_NULL)
934     {
935         OP *sib;
936         for (sib = o->op_sibling;
937                 sib && sib->op_type == OP_NULL;
938                 sib = sib->op_sibling) ;
939         
940         if (!sib)
941             return o;
942     }
943
944     if (o->op_type == OP_NEXTSTATE
945         || o->op_type == OP_DBSTATE
946         || (o->op_type == OP_NULL && (o->op_targ == OP_NEXTSTATE
947                                       || o->op_targ == OP_DBSTATE)))
948         PL_curcop = (COP*)o;            /* for warning below */
949
950     /* assumes no premature commitment */
951     want = o->op_flags & OPf_WANT;
952     if ((want && want != OPf_WANT_SCALAR)
953          || (PL_parser && PL_parser->error_count)
954          || o->op_type == OP_RETURN)
955     {
956         return o;
957     }
958
959     if ((o->op_private & OPpTARGET_MY)
960         && (PL_opargs[o->op_type] & OA_TARGLEX))/* OPp share the meaning */
961     {
962         return scalar(o);                       /* As if inside SASSIGN */
963     }
964
965     o->op_flags = (o->op_flags & ~OPf_WANT) | OPf_WANT_VOID;
966
967     switch (o->op_type) {
968     default:
969         if (!(PL_opargs[o->op_type] & OA_FOLDCONST))
970             break;
971         /* FALL THROUGH */
972     case OP_REPEAT:
973         if (o->op_flags & OPf_STACKED)
974             break;
975         goto func_ops;
976     case OP_SUBSTR:
977         if (o->op_private == 4)
978             break;
979         /* FALL THROUGH */
980     case OP_GVSV:
981     case OP_WANTARRAY:
982     case OP_GV:
983     case OP_SMARTMATCH:
984     case OP_PADSV:
985     case OP_PADAV:
986     case OP_PADHV:
987     case OP_PADANY:
988     case OP_AV2ARYLEN:
989     case OP_REF:
990     case OP_REFGEN:
991     case OP_SREFGEN:
992     case OP_DEFINED:
993     case OP_HEX:
994     case OP_OCT:
995     case OP_LENGTH:
996     case OP_VEC:
997     case OP_INDEX:
998     case OP_RINDEX:
999     case OP_SPRINTF:
1000     case OP_AELEM:
1001     case OP_AELEMFAST:
1002     case OP_ASLICE:
1003     case OP_HELEM:
1004     case OP_HSLICE:
1005     case OP_UNPACK:
1006     case OP_PACK:
1007     case OP_JOIN:
1008     case OP_LSLICE:
1009     case OP_ANONLIST:
1010     case OP_ANONHASH:
1011     case OP_SORT:
1012     case OP_REVERSE:
1013     case OP_RANGE:
1014     case OP_FLIP:
1015     case OP_FLOP:
1016     case OP_CALLER:
1017     case OP_FILENO:
1018     case OP_EOF:
1019     case OP_TELL:
1020     case OP_GETSOCKNAME:
1021     case OP_GETPEERNAME:
1022     case OP_READLINK:
1023     case OP_TELLDIR:
1024     case OP_GETPPID:
1025     case OP_GETPGRP:
1026     case OP_GETPRIORITY:
1027     case OP_TIME:
1028     case OP_TMS:
1029     case OP_LOCALTIME:
1030     case OP_GMTIME:
1031     case OP_GHBYNAME:
1032     case OP_GHBYADDR:
1033     case OP_GHOSTENT:
1034     case OP_GNBYNAME:
1035     case OP_GNBYADDR:
1036     case OP_GNETENT:
1037     case OP_GPBYNAME:
1038     case OP_GPBYNUMBER:
1039     case OP_GPROTOENT:
1040     case OP_GSBYNAME:
1041     case OP_GSBYPORT:
1042     case OP_GSERVENT:
1043     case OP_GPWNAM:
1044     case OP_GPWUID:
1045     case OP_GGRNAM:
1046     case OP_GGRGID:
1047     case OP_GETLOGIN:
1048     case OP_PROTOTYPE:
1049       func_ops:
1050         if (!(o->op_private & (OPpLVAL_INTRO|OPpOUR_INTRO)))
1051             /* Otherwise it's "Useless use of grep iterator" */
1052             useless = OP_DESC(o);
1053         break;
1054
1055     case OP_NOT:
1056        kid = cUNOPo->op_first;
1057        if (kid->op_type != OP_MATCH && kid->op_type != OP_SUBST &&
1058            kid->op_type != OP_TRANS) {
1059                 goto func_ops;
1060        }
1061        useless = "negative pattern binding (!~)";
1062        break;
1063
1064     case OP_RV2GV:
1065     case OP_RV2SV:
1066     case OP_RV2AV:
1067     case OP_RV2HV:
1068         if (!(o->op_private & (OPpLVAL_INTRO|OPpOUR_INTRO)) &&
1069                 (!o->op_sibling || o->op_sibling->op_type != OP_READLINE))
1070             useless = "a variable";
1071         break;
1072
1073     case OP_CONST:
1074         sv = cSVOPo_sv;
1075         if (cSVOPo->op_private & OPpCONST_STRICT)
1076             no_bareword_allowed(o);
1077         else {
1078             if (ckWARN(WARN_VOID)) {
1079                 if (SvOK(sv)) {
1080                     SV* msv = sv_2mortal(Perl_newSVpvf(aTHX_
1081                                 "a constant (%"SVf")", sv));
1082                     useless = SvPV_nolen(msv);
1083                 }
1084                 else
1085                     useless = "a constant (undef)";
1086                 if (o->op_private & OPpCONST_ARYBASE)
1087                     useless = NULL;
1088                 /* don't warn on optimised away booleans, eg 
1089                  * use constant Foo, 5; Foo || print; */
1090                 if (cSVOPo->op_private & OPpCONST_SHORTCIRCUIT)
1091                     useless = NULL;
1092                 /* the constants 0 and 1 are permitted as they are
1093                    conventionally used as dummies in constructs like
1094                         1 while some_condition_with_side_effects;  */
1095                 else if (SvNIOK(sv) && (SvNV(sv) == 0.0 || SvNV(sv) == 1.0))
1096                     useless = NULL;
1097                 else if (SvPOK(sv)) {
1098                   /* perl4's way of mixing documentation and code
1099                      (before the invention of POD) was based on a
1100                      trick to mix nroff and perl code. The trick was
1101                      built upon these three nroff macros being used in
1102                      void context. The pink camel has the details in
1103                      the script wrapman near page 319. */
1104                     const char * const maybe_macro = SvPVX_const(sv);
1105                     if (strnEQ(maybe_macro, "di", 2) ||
1106                         strnEQ(maybe_macro, "ds", 2) ||
1107                         strnEQ(maybe_macro, "ig", 2))
1108                             useless = NULL;
1109                 }
1110             }
1111         }
1112         op_null(o);             /* don't execute or even remember it */
1113         break;
1114
1115     case OP_POSTINC:
1116         o->op_type = OP_PREINC;         /* pre-increment is faster */
1117         o->op_ppaddr = PL_ppaddr[OP_PREINC];
1118         break;
1119
1120     case OP_POSTDEC:
1121         o->op_type = OP_PREDEC;         /* pre-decrement is faster */
1122         o->op_ppaddr = PL_ppaddr[OP_PREDEC];
1123         break;
1124
1125     case OP_I_POSTINC:
1126         o->op_type = OP_I_PREINC;       /* pre-increment is faster */
1127         o->op_ppaddr = PL_ppaddr[OP_I_PREINC];
1128         break;
1129
1130     case OP_I_POSTDEC:
1131         o->op_type = OP_I_PREDEC;       /* pre-decrement is faster */
1132         o->op_ppaddr = PL_ppaddr[OP_I_PREDEC];
1133         break;
1134
1135     case OP_OR:
1136     case OP_AND:
1137         kid = cLOGOPo->op_first;
1138         if (kid->op_type == OP_NOT
1139             && (kid->op_flags & OPf_KIDS)
1140             && !PL_madskills) {
1141             if (o->op_type == OP_AND) {
1142                 o->op_type = OP_OR;
1143                 o->op_ppaddr = PL_ppaddr[OP_OR];
1144             } else {
1145                 o->op_type = OP_AND;
1146                 o->op_ppaddr = PL_ppaddr[OP_AND];
1147             }
1148             op_null(kid);
1149         }
1150
1151     case OP_DOR:
1152     case OP_COND_EXPR:
1153     case OP_ENTERGIVEN:
1154     case OP_ENTERWHEN:
1155         for (kid = cUNOPo->op_first->op_sibling; kid; kid = kid->op_sibling)
1156             scalarvoid(kid);
1157         break;
1158
1159     case OP_NULL:
1160         if (o->op_flags & OPf_STACKED)
1161             break;
1162         /* FALL THROUGH */
1163     case OP_NEXTSTATE:
1164     case OP_DBSTATE:
1165     case OP_ENTERTRY:
1166     case OP_ENTER:
1167         if (!(o->op_flags & OPf_KIDS))
1168             break;
1169         /* FALL THROUGH */
1170     case OP_SCOPE:
1171     case OP_LEAVE:
1172     case OP_LEAVETRY:
1173     case OP_LEAVELOOP:
1174     case OP_LINESEQ:
1175     case OP_LIST:
1176     case OP_LEAVEGIVEN:
1177     case OP_LEAVEWHEN:
1178         for (kid = cLISTOPo->op_first; kid; kid = kid->op_sibling)
1179             scalarvoid(kid);
1180         break;
1181     case OP_ENTEREVAL:
1182         scalarkids(o);
1183         break;
1184     case OP_REQUIRE:
1185         /* all requires must return a boolean value */
1186         o->op_flags &= ~OPf_WANT;
1187         /* FALL THROUGH */
1188     case OP_SCALAR:
1189         return scalar(o);
1190     }
1191     if (useless)
1192         Perl_ck_warner(aTHX_ packWARN(WARN_VOID), "Useless use of %s in void context", useless);
1193     return o;
1194 }
1195
1196 static OP *
1197 S_listkids(pTHX_ OP *o)
1198 {
1199     if (o && o->op_flags & OPf_KIDS) {
1200         OP *kid;
1201         for (kid = cLISTOPo->op_first; kid; kid = kid->op_sibling)
1202             list(kid);
1203     }
1204     return o;
1205 }
1206
1207 OP *
1208 Perl_list(pTHX_ OP *o)
1209 {
1210     dVAR;
1211     OP *kid;
1212
1213     /* assumes no premature commitment */
1214     if (!o || (o->op_flags & OPf_WANT)
1215          || (PL_parser && PL_parser->error_count)
1216          || o->op_type == OP_RETURN)
1217     {
1218         return o;
1219     }
1220
1221     if ((o->op_private & OPpTARGET_MY)
1222         && (PL_opargs[o->op_type] & OA_TARGLEX))/* OPp share the meaning */
1223     {
1224         return o;                               /* As if inside SASSIGN */
1225     }
1226
1227     o->op_flags = (o->op_flags & ~OPf_WANT) | OPf_WANT_LIST;
1228
1229     switch (o->op_type) {
1230     case OP_FLOP:
1231     case OP_REPEAT:
1232         list(cBINOPo->op_first);
1233         break;
1234     case OP_OR:
1235     case OP_AND:
1236     case OP_COND_EXPR:
1237         for (kid = cUNOPo->op_first->op_sibling; kid; kid = kid->op_sibling)
1238             list(kid);
1239         break;
1240     default:
1241     case OP_MATCH:
1242     case OP_QR:
1243     case OP_SUBST:
1244     case OP_NULL:
1245         if (!(o->op_flags & OPf_KIDS))
1246             break;
1247         if (!o->op_next && cUNOPo->op_first->op_type == OP_FLOP) {
1248             list(cBINOPo->op_first);
1249             return gen_constant_list(o);
1250         }
1251     case OP_LIST:
1252         listkids(o);
1253         break;
1254     case OP_LEAVE:
1255     case OP_LEAVETRY:
1256         kid = cLISTOPo->op_first;
1257         list(kid);
1258         while ((kid = kid->op_sibling)) {
1259             if (kid->op_sibling)
1260                 scalarvoid(kid);
1261             else
1262                 list(kid);
1263         }
1264         PL_curcop = &PL_compiling;
1265         break;
1266     case OP_SCOPE:
1267     case OP_LINESEQ:
1268         for (kid = cLISTOPo->op_first; kid; kid = kid->op_sibling) {
1269             if (kid->op_sibling)
1270                 scalarvoid(kid);
1271             else
1272                 list(kid);
1273         }
1274         PL_curcop = &PL_compiling;
1275         break;
1276     case OP_REQUIRE:
1277         /* all requires must return a boolean value */
1278         o->op_flags &= ~OPf_WANT;
1279         return scalar(o);
1280     }
1281     return o;
1282 }
1283
1284 static OP *
1285 S_scalarseq(pTHX_ OP *o)
1286 {
1287     dVAR;
1288     if (o) {
1289         const OPCODE type = o->op_type;
1290
1291         if (type == OP_LINESEQ || type == OP_SCOPE ||
1292             type == OP_LEAVE || type == OP_LEAVETRY)
1293         {
1294             OP *kid;
1295             for (kid = cLISTOPo->op_first; kid; kid = kid->op_sibling) {
1296                 if (kid->op_sibling) {
1297                     scalarvoid(kid);
1298                 }
1299             }
1300             PL_curcop = &PL_compiling;
1301         }
1302         o->op_flags &= ~OPf_PARENS;
1303         if (PL_hints & HINT_BLOCK_SCOPE)
1304             o->op_flags |= OPf_PARENS;
1305     }
1306     else
1307         o = newOP(OP_STUB, 0);
1308     return o;
1309 }
1310
1311 STATIC OP *
1312 S_modkids(pTHX_ OP *o, I32 type)
1313 {
1314     if (o && o->op_flags & OPf_KIDS) {
1315         OP *kid;
1316         for (kid = cLISTOPo->op_first; kid; kid = kid->op_sibling)
1317             mod(kid, type);
1318     }
1319     return o;
1320 }
1321
1322 /* Propagate lvalue ("modifiable") context to an op and its children.
1323  * 'type' represents the context type, roughly based on the type of op that
1324  * would do the modifying, although local() is represented by OP_NULL.
1325  * It's responsible for detecting things that can't be modified,  flag
1326  * things that need to behave specially in an lvalue context (e.g., "$$x = 5"
1327  * might have to vivify a reference in $x), and so on.
1328  *
1329  * For example, "$a+1 = 2" would cause mod() to be called with o being
1330  * OP_ADD and type being OP_SASSIGN, and would output an error.
1331  */
1332
1333 OP *
1334 Perl_mod(pTHX_ OP *o, I32 type)
1335 {
1336     dVAR;
1337     OP *kid;
1338     /* -1 = error on localize, 0 = ignore localize, 1 = ok to localize */
1339     int localize = -1;
1340
1341     if (!o || (PL_parser && PL_parser->error_count))
1342         return o;
1343
1344     if ((o->op_private & OPpTARGET_MY)
1345         && (PL_opargs[o->op_type] & OA_TARGLEX))/* OPp share the meaning */
1346     {
1347         return o;
1348     }
1349
1350     switch (o->op_type) {
1351     case OP_UNDEF:
1352         localize = 0;
1353         PL_modcount++;
1354         return o;
1355     case OP_CONST:
1356         if (!(o->op_private & OPpCONST_ARYBASE))
1357             goto nomod;
1358         localize = 0;
1359         if (PL_eval_start && PL_eval_start->op_type == OP_CONST) {
1360             CopARYBASE_set(&PL_compiling,
1361                            (I32)SvIV(cSVOPx(PL_eval_start)->op_sv));
1362             PL_eval_start = 0;
1363         }
1364         else if (!type) {
1365             SAVECOPARYBASE(&PL_compiling);
1366             CopARYBASE_set(&PL_compiling, 0);
1367         }
1368         else if (type == OP_REFGEN)
1369             goto nomod;
1370         else
1371             Perl_croak(aTHX_ "That use of $[ is unsupported");
1372         break;
1373     case OP_STUB:
1374         if ((o->op_flags & OPf_PARENS) || PL_madskills)
1375             break;
1376         goto nomod;
1377     case OP_ENTERSUB:
1378         if ((type == OP_UNDEF || type == OP_REFGEN) &&
1379             !(o->op_flags & OPf_STACKED)) {
1380             o->op_type = OP_RV2CV;              /* entersub => rv2cv */
1381             /* The default is to set op_private to the number of children,
1382                which for a UNOP such as RV2CV is always 1. And w're using
1383                the bit for a flag in RV2CV, so we need it clear.  */
1384             o->op_private &= ~1;
1385             o->op_ppaddr = PL_ppaddr[OP_RV2CV];
1386             assert(cUNOPo->op_first->op_type == OP_NULL);
1387             op_null(((LISTOP*)cUNOPo->op_first)->op_first);/* disable pushmark */
1388             break;
1389         }
1390         else if (o->op_private & OPpENTERSUB_NOMOD)
1391             return o;
1392         else {                          /* lvalue subroutine call */
1393             o->op_private |= OPpLVAL_INTRO;
1394             PL_modcount = RETURN_UNLIMITED_NUMBER;
1395             if (type == OP_GREPSTART || type == OP_ENTERSUB || type == OP_REFGEN) {
1396                 /* Backward compatibility mode: */
1397                 o->op_private |= OPpENTERSUB_INARGS;
1398                 break;
1399             }
1400             else {                      /* Compile-time error message: */
1401                 OP *kid = cUNOPo->op_first;
1402                 CV *cv;
1403                 OP *okid;
1404
1405                 if (kid->op_type != OP_PUSHMARK) {
1406                     if (kid->op_type != OP_NULL || kid->op_targ != OP_LIST)
1407                         Perl_croak(aTHX_
1408                                 "panic: unexpected lvalue entersub "
1409                                 "args: type/targ %ld:%"UVuf,
1410                                 (long)kid->op_type, (UV)kid->op_targ);
1411                     kid = kLISTOP->op_first;
1412                 }
1413                 while (kid->op_sibling)
1414                     kid = kid->op_sibling;
1415                 if (!(kid->op_type == OP_NULL && kid->op_targ == OP_RV2CV)) {
1416                     /* Indirect call */
1417                     if (kid->op_type == OP_METHOD_NAMED
1418                         || kid->op_type == OP_METHOD)
1419                     {
1420                         UNOP *newop;
1421
1422                         NewOp(1101, newop, 1, UNOP);
1423                         newop->op_type = OP_RV2CV;
1424                         newop->op_ppaddr = PL_ppaddr[OP_RV2CV];
1425                         newop->op_first = NULL;
1426                         newop->op_next = (OP*)newop;
1427                         kid->op_sibling = (OP*)newop;
1428                         newop->op_private |= OPpLVAL_INTRO;
1429                         newop->op_private &= ~1;
1430                         break;
1431                     }
1432
1433                     if (kid->op_type != OP_RV2CV)
1434                         Perl_croak(aTHX_
1435                                    "panic: unexpected lvalue entersub "
1436                                    "entry via type/targ %ld:%"UVuf,
1437                                    (long)kid->op_type, (UV)kid->op_targ);
1438                     kid->op_private |= OPpLVAL_INTRO;
1439                     break;      /* Postpone until runtime */
1440                 }
1441
1442                 okid = kid;
1443                 kid = kUNOP->op_first;
1444                 if (kid->op_type == OP_NULL && kid->op_targ == OP_RV2SV)
1445                     kid = kUNOP->op_first;
1446                 if (kid->op_type == OP_NULL)
1447                     Perl_croak(aTHX_
1448                                "Unexpected constant lvalue entersub "
1449                                "entry via type/targ %ld:%"UVuf,
1450                                (long)kid->op_type, (UV)kid->op_targ);
1451                 if (kid->op_type != OP_GV) {
1452                     /* Restore RV2CV to check lvalueness */
1453                   restore_2cv:
1454                     if (kid->op_next && kid->op_next != kid) { /* Happens? */
1455                         okid->op_next = kid->op_next;
1456                         kid->op_next = okid;
1457                     }
1458                     else
1459                         okid->op_next = NULL;
1460                     okid->op_type = OP_RV2CV;
1461                     okid->op_targ = 0;
1462                     okid->op_ppaddr = PL_ppaddr[OP_RV2CV];
1463                     okid->op_private |= OPpLVAL_INTRO;
1464                     okid->op_private &= ~1;
1465                     break;
1466                 }
1467
1468                 cv = GvCV(kGVOP_gv);
1469                 if (!cv)
1470                     goto restore_2cv;
1471                 if (CvLVALUE(cv))
1472                     break;
1473             }
1474         }
1475         /* FALL THROUGH */
1476     default:
1477       nomod:
1478         /* grep, foreach, subcalls, refgen */
1479         if (type == OP_GREPSTART || type == OP_ENTERSUB || type == OP_REFGEN)
1480             break;
1481         yyerror(Perl_form(aTHX_ "Can't modify %s in %s",
1482                      (o->op_type == OP_NULL && (o->op_flags & OPf_SPECIAL)
1483                       ? "do block"
1484                       : (o->op_type == OP_ENTERSUB
1485                         ? "non-lvalue subroutine call"
1486                         : OP_DESC(o))),
1487                      type ? PL_op_desc[type] : "local"));
1488         return o;
1489
1490     case OP_PREINC:
1491     case OP_PREDEC:
1492     case OP_POW:
1493     case OP_MULTIPLY:
1494     case OP_DIVIDE:
1495     case OP_MODULO:
1496     case OP_REPEAT:
1497     case OP_ADD:
1498     case OP_SUBTRACT:
1499     case OP_CONCAT:
1500     case OP_LEFT_SHIFT:
1501     case OP_RIGHT_SHIFT:
1502     case OP_BIT_AND:
1503     case OP_BIT_XOR:
1504     case OP_BIT_OR:
1505     case OP_I_MULTIPLY:
1506     case OP_I_DIVIDE:
1507     case OP_I_MODULO:
1508     case OP_I_ADD:
1509     case OP_I_SUBTRACT:
1510         if (!(o->op_flags & OPf_STACKED))
1511             goto nomod;
1512         PL_modcount++;
1513         break;
1514
1515     case OP_COND_EXPR:
1516         localize = 1;
1517         for (kid = cUNOPo->op_first->op_sibling; kid; kid = kid->op_sibling)
1518             mod(kid, type);
1519         break;
1520
1521     case OP_RV2AV:
1522     case OP_RV2HV:
1523         if (type == OP_REFGEN && o->op_flags & OPf_PARENS) {
1524            PL_modcount = RETURN_UNLIMITED_NUMBER;
1525             return o;           /* Treat \(@foo) like ordinary list. */
1526         }
1527         /* FALL THROUGH */
1528     case OP_RV2GV:
1529         if (scalar_mod_type(o, type))
1530             goto nomod;
1531         ref(cUNOPo->op_first, o->op_type);
1532         /* FALL THROUGH */
1533     case OP_ASLICE:
1534     case OP_HSLICE:
1535         if (type == OP_LEAVESUBLV)
1536             o->op_private |= OPpMAYBE_LVSUB;
1537         localize = 1;
1538         /* FALL THROUGH */
1539     case OP_AASSIGN:
1540     case OP_NEXTSTATE:
1541     case OP_DBSTATE:
1542        PL_modcount = RETURN_UNLIMITED_NUMBER;
1543         break;
1544     case OP_AV2ARYLEN:
1545         PL_hints |= HINT_BLOCK_SCOPE;
1546         if (type == OP_LEAVESUBLV)
1547             o->op_private |= OPpMAYBE_LVSUB;
1548         PL_modcount++;
1549         break;
1550     case OP_RV2SV:
1551         ref(cUNOPo->op_first, o->op_type);
1552         localize = 1;
1553         /* FALL THROUGH */
1554     case OP_GV:
1555         PL_hints |= HINT_BLOCK_SCOPE;
1556     case OP_SASSIGN:
1557     case OP_ANDASSIGN:
1558     case OP_ORASSIGN:
1559     case OP_DORASSIGN:
1560         PL_modcount++;
1561         break;
1562
1563     case OP_AELEMFAST:
1564         localize = -1;
1565         PL_modcount++;
1566         break;
1567
1568     case OP_PADAV:
1569     case OP_PADHV:
1570        PL_modcount = RETURN_UNLIMITED_NUMBER;
1571         if (type == OP_REFGEN && o->op_flags & OPf_PARENS)
1572             return o;           /* Treat \(@foo) like ordinary list. */
1573         if (scalar_mod_type(o, type))
1574             goto nomod;
1575         if (type == OP_LEAVESUBLV)
1576             o->op_private |= OPpMAYBE_LVSUB;
1577         /* FALL THROUGH */
1578     case OP_PADSV:
1579         PL_modcount++;
1580         if (!type) /* local() */
1581             Perl_croak(aTHX_ "Can't localize lexical variable %s",
1582                  PAD_COMPNAME_PV(o->op_targ));
1583         break;
1584
1585     case OP_PUSHMARK:
1586         localize = 0;
1587         break;
1588
1589     case OP_KEYS:
1590         if (type != OP_SASSIGN)
1591             goto nomod;
1592         goto lvalue_func;
1593     case OP_SUBSTR:
1594         if (o->op_private == 4) /* don't allow 4 arg substr as lvalue */
1595             goto nomod;
1596         /* FALL THROUGH */
1597     case OP_POS:
1598     case OP_VEC:
1599         if (type == OP_LEAVESUBLV)
1600             o->op_private |= OPpMAYBE_LVSUB;
1601       lvalue_func:
1602         pad_free(o->op_targ);
1603         o->op_targ = pad_alloc(o->op_type, SVs_PADMY);
1604         assert(SvTYPE(PAD_SV(o->op_targ)) == SVt_NULL);
1605         if (o->op_flags & OPf_KIDS)
1606             mod(cBINOPo->op_first->op_sibling, type);
1607         break;
1608
1609     case OP_AELEM:
1610     case OP_HELEM:
1611         ref(cBINOPo->op_first, o->op_type);
1612         if (type == OP_ENTERSUB &&
1613              !(o->op_private & (OPpLVAL_INTRO | OPpDEREF)))
1614             o->op_private |= OPpLVAL_DEFER;
1615         if (type == OP_LEAVESUBLV)
1616             o->op_private |= OPpMAYBE_LVSUB;
1617         localize = 1;
1618         PL_modcount++;
1619         break;
1620
1621     case OP_SCOPE:
1622     case OP_LEAVE:
1623     case OP_ENTER:
1624     case OP_LINESEQ:
1625         localize = 0;
1626         if (o->op_flags & OPf_KIDS)
1627             mod(cLISTOPo->op_last, type);
1628         break;
1629
1630     case OP_NULL:
1631         localize = 0;
1632         if (o->op_flags & OPf_SPECIAL)          /* do BLOCK */
1633             goto nomod;
1634         else if (!(o->op_flags & OPf_KIDS))
1635             break;
1636         if (o->op_targ != OP_LIST) {
1637             mod(cBINOPo->op_first, type);
1638             break;
1639         }
1640         /* FALL THROUGH */
1641     case OP_LIST:
1642         localize = 0;
1643         for (kid = cLISTOPo->op_first; kid; kid = kid->op_sibling)
1644             mod(kid, type);
1645         break;
1646
1647     case OP_RETURN:
1648         if (type != OP_LEAVESUBLV)
1649             goto nomod;
1650         break; /* mod()ing was handled by ck_return() */
1651     }
1652
1653     /* [20011101.069] File test operators interpret OPf_REF to mean that
1654        their argument is a filehandle; thus \stat(".") should not set
1655        it. AMS 20011102 */
1656     if (type == OP_REFGEN &&
1657         PL_check[o->op_type] == MEMBER_TO_FPTR(Perl_ck_ftst))
1658         return o;
1659
1660     if (type != OP_LEAVESUBLV)
1661         o->op_flags |= OPf_MOD;
1662
1663     if (type == OP_AASSIGN || type == OP_SASSIGN)
1664         o->op_flags |= OPf_SPECIAL|OPf_REF;
1665     else if (!type) { /* local() */
1666         switch (localize) {
1667         case 1:
1668             o->op_private |= OPpLVAL_INTRO;
1669             o->op_flags &= ~OPf_SPECIAL;
1670             PL_hints |= HINT_BLOCK_SCOPE;
1671             break;
1672         case 0:
1673             break;
1674         case -1:
1675             Perl_ck_warner(aTHX_ packWARN(WARN_SYNTAX),
1676                            "Useless localization of %s", OP_DESC(o));
1677         }
1678     }
1679     else if (type != OP_GREPSTART && type != OP_ENTERSUB
1680              && type != OP_LEAVESUBLV)
1681         o->op_flags |= OPf_REF;
1682     return o;
1683 }
1684
1685 STATIC bool
1686 S_scalar_mod_type(const OP *o, I32 type)
1687 {
1688     PERL_ARGS_ASSERT_SCALAR_MOD_TYPE;
1689
1690     switch (type) {
1691     case OP_SASSIGN:
1692         if (o->op_type == OP_RV2GV)
1693             return FALSE;
1694         /* FALL THROUGH */
1695     case OP_PREINC:
1696     case OP_PREDEC:
1697     case OP_POSTINC:
1698     case OP_POSTDEC:
1699     case OP_I_PREINC:
1700     case OP_I_PREDEC:
1701     case OP_I_POSTINC:
1702     case OP_I_POSTDEC:
1703     case OP_POW:
1704     case OP_MULTIPLY:
1705     case OP_DIVIDE:
1706     case OP_MODULO:
1707     case OP_REPEAT:
1708     case OP_ADD:
1709     case OP_SUBTRACT:
1710     case OP_I_MULTIPLY:
1711     case OP_I_DIVIDE:
1712     case OP_I_MODULO:
1713     case OP_I_ADD:
1714     case OP_I_SUBTRACT:
1715     case OP_LEFT_SHIFT:
1716     case OP_RIGHT_SHIFT:
1717     case OP_BIT_AND:
1718     case OP_BIT_XOR:
1719     case OP_BIT_OR:
1720     case OP_CONCAT:
1721     case OP_SUBST:
1722     case OP_TRANS:
1723     case OP_READ:
1724     case OP_SYSREAD:
1725     case OP_RECV:
1726     case OP_ANDASSIGN:
1727     case OP_ORASSIGN:
1728     case OP_DORASSIGN:
1729         return TRUE;
1730     default:
1731         return FALSE;
1732     }
1733 }
1734
1735 STATIC bool
1736 S_is_handle_constructor(const OP *o, I32 numargs)
1737 {
1738     PERL_ARGS_ASSERT_IS_HANDLE_CONSTRUCTOR;
1739
1740     switch (o->op_type) {
1741     case OP_PIPE_OP:
1742     case OP_SOCKPAIR:
1743         if (numargs == 2)
1744             return TRUE;
1745         /* FALL THROUGH */
1746     case OP_SYSOPEN:
1747     case OP_OPEN:
1748     case OP_SELECT:             /* XXX c.f. SelectSaver.pm */
1749     case OP_SOCKET:
1750     case OP_OPEN_DIR:
1751     case OP_ACCEPT:
1752         if (numargs == 1)
1753             return TRUE;
1754         /* FALLTHROUGH */
1755     default:
1756         return FALSE;
1757     }
1758 }
1759
1760 static OP *
1761 S_refkids(pTHX_ OP *o, I32 type)
1762 {
1763     if (o && o->op_flags & OPf_KIDS) {
1764         OP *kid;
1765         for (kid = cLISTOPo->op_first; kid; kid = kid->op_sibling)
1766             ref(kid, type);
1767     }
1768     return o;
1769 }
1770
1771 OP *
1772 Perl_doref(pTHX_ OP *o, I32 type, bool set_op_ref)
1773 {
1774     dVAR;
1775     OP *kid;
1776
1777     PERL_ARGS_ASSERT_DOREF;
1778
1779     if (!o || (PL_parser && PL_parser->error_count))
1780         return o;
1781
1782     switch (o->op_type) {
1783     case OP_ENTERSUB:
1784         if ((type == OP_EXISTS || type == OP_DEFINED || type == OP_LOCK) &&
1785             !(o->op_flags & OPf_STACKED)) {
1786             o->op_type = OP_RV2CV;             /* entersub => rv2cv */
1787             o->op_ppaddr = PL_ppaddr[OP_RV2CV];
1788             assert(cUNOPo->op_first->op_type == OP_NULL);
1789             op_null(((LISTOP*)cUNOPo->op_first)->op_first);     /* disable pushmark */
1790             o->op_flags |= OPf_SPECIAL;
1791             o->op_private &= ~1;
1792         }
1793         break;
1794
1795     case OP_COND_EXPR:
1796         for (kid = cUNOPo->op_first->op_sibling; kid; kid = kid->op_sibling)
1797             doref(kid, type, set_op_ref);
1798         break;
1799     case OP_RV2SV:
1800         if (type == OP_DEFINED)
1801             o->op_flags |= OPf_SPECIAL;         /* don't create GV */
1802         doref(cUNOPo->op_first, o->op_type, set_op_ref);
1803         /* FALL THROUGH */
1804     case OP_PADSV:
1805         if (type == OP_RV2SV || type == OP_RV2AV || type == OP_RV2HV) {
1806             o->op_private |= (type == OP_RV2AV ? OPpDEREF_AV
1807                               : type == OP_RV2HV ? OPpDEREF_HV
1808                               : OPpDEREF_SV);
1809             o->op_flags |= OPf_MOD;
1810         }
1811         break;
1812
1813     case OP_RV2AV:
1814     case OP_RV2HV:
1815         if (set_op_ref)
1816             o->op_flags |= OPf_REF;
1817         /* FALL THROUGH */
1818     case OP_RV2GV:
1819         if (type == OP_DEFINED)
1820             o->op_flags |= OPf_SPECIAL;         /* don't create GV */
1821         doref(cUNOPo->op_first, o->op_type, set_op_ref);
1822         break;
1823
1824     case OP_PADAV:
1825     case OP_PADHV:
1826         if (set_op_ref)
1827             o->op_flags |= OPf_REF;
1828         break;
1829
1830     case OP_SCALAR:
1831     case OP_NULL:
1832         if (!(o->op_flags & OPf_KIDS))
1833             break;
1834         doref(cBINOPo->op_first, type, set_op_ref);
1835         break;
1836     case OP_AELEM:
1837     case OP_HELEM:
1838         doref(cBINOPo->op_first, o->op_type, set_op_ref);
1839         if (type == OP_RV2SV || type == OP_RV2AV || type == OP_RV2HV) {
1840             o->op_private |= (type == OP_RV2AV ? OPpDEREF_AV
1841                               : type == OP_RV2HV ? OPpDEREF_HV
1842                               : OPpDEREF_SV);
1843             o->op_flags |= OPf_MOD;
1844         }
1845         break;
1846
1847     case OP_SCOPE:
1848     case OP_LEAVE:
1849         set_op_ref = FALSE;
1850         /* FALL THROUGH */
1851     case OP_ENTER:
1852     case OP_LIST:
1853         if (!(o->op_flags & OPf_KIDS))
1854             break;
1855         doref(cLISTOPo->op_last, type, set_op_ref);
1856         break;
1857     default:
1858         break;
1859     }
1860     return scalar(o);
1861
1862 }
1863
1864 STATIC OP *
1865 S_dup_attrlist(pTHX_ OP *o)
1866 {
1867     dVAR;
1868     OP *rop;
1869
1870     PERL_ARGS_ASSERT_DUP_ATTRLIST;
1871
1872     /* An attrlist is either a simple OP_CONST or an OP_LIST with kids,
1873      * where the first kid is OP_PUSHMARK and the remaining ones
1874      * are OP_CONST.  We need to push the OP_CONST values.
1875      */
1876     if (o->op_type == OP_CONST)
1877         rop = newSVOP(OP_CONST, o->op_flags, SvREFCNT_inc_NN(cSVOPo->op_sv));
1878 #ifdef PERL_MAD
1879     else if (o->op_type == OP_NULL)
1880         rop = NULL;
1881 #endif
1882     else {
1883         assert((o->op_type == OP_LIST) && (o->op_flags & OPf_KIDS));
1884         rop = NULL;
1885         for (o = cLISTOPo->op_first; o; o=o->op_sibling) {
1886             if (o->op_type == OP_CONST)
1887                 rop = append_elem(OP_LIST, rop,
1888                                   newSVOP(OP_CONST, o->op_flags,
1889                                           SvREFCNT_inc_NN(cSVOPo->op_sv)));
1890         }
1891     }
1892     return rop;
1893 }
1894
1895 STATIC void
1896 S_apply_attrs(pTHX_ HV *stash, SV *target, OP *attrs, bool for_my)
1897 {
1898     dVAR;
1899     SV *stashsv;
1900
1901     PERL_ARGS_ASSERT_APPLY_ATTRS;
1902
1903     /* fake up C<use attributes $pkg,$rv,@attrs> */
1904     ENTER;              /* need to protect against side-effects of 'use' */
1905     stashsv = stash ? newSVhek(HvNAME_HEK(stash)) : &PL_sv_no;
1906
1907 #define ATTRSMODULE "attributes"
1908 #define ATTRSMODULE_PM "attributes.pm"
1909
1910     if (for_my) {
1911         /* Don't force the C<use> if we don't need it. */
1912         SV * const * const svp = hv_fetchs(GvHVn(PL_incgv), ATTRSMODULE_PM, FALSE);
1913         if (svp && *svp != &PL_sv_undef)
1914             NOOP;       /* already in %INC */
1915         else
1916             Perl_load_module(aTHX_ PERL_LOADMOD_NOIMPORT,
1917                              newSVpvs(ATTRSMODULE), NULL);
1918     }
1919     else {
1920         Perl_load_module(aTHX_ PERL_LOADMOD_IMPORT_OPS,
1921                          newSVpvs(ATTRSMODULE),
1922                          NULL,
1923                          prepend_elem(OP_LIST,
1924                                       newSVOP(OP_CONST, 0, stashsv),
1925                                       prepend_elem(OP_LIST,
1926                                                    newSVOP(OP_CONST, 0,
1927                                                            newRV(target)),
1928                                                    dup_attrlist(attrs))));
1929     }
1930     LEAVE;
1931 }
1932
1933 STATIC void
1934 S_apply_attrs_my(pTHX_ HV *stash, OP *target, OP *attrs, OP **imopsp)
1935 {
1936     dVAR;
1937     OP *pack, *imop, *arg;
1938     SV *meth, *stashsv;
1939
1940     PERL_ARGS_ASSERT_APPLY_ATTRS_MY;
1941
1942     if (!attrs)
1943         return;
1944
1945     assert(target->op_type == OP_PADSV ||
1946            target->op_type == OP_PADHV ||
1947            target->op_type == OP_PADAV);
1948
1949     /* Ensure that attributes.pm is loaded. */
1950     apply_attrs(stash, PAD_SV(target->op_targ), attrs, TRUE);
1951
1952     /* Need package name for method call. */
1953     pack = newSVOP(OP_CONST, 0, newSVpvs(ATTRSMODULE));
1954
1955     /* Build up the real arg-list. */
1956     stashsv = stash ? newSVhek(HvNAME_HEK(stash)) : &PL_sv_no;
1957
1958     arg = newOP(OP_PADSV, 0);
1959     arg->op_targ = target->op_targ;
1960     arg = prepend_elem(OP_LIST,
1961                        newSVOP(OP_CONST, 0, stashsv),
1962                        prepend_elem(OP_LIST,
1963                                     newUNOP(OP_REFGEN, 0,
1964                                             mod(arg, OP_REFGEN)),
1965                                     dup_attrlist(attrs)));
1966
1967     /* Fake up a method call to import */
1968     meth = newSVpvs_share("import");
1969     imop = convert(OP_ENTERSUB, OPf_STACKED|OPf_SPECIAL|OPf_WANT_VOID,
1970                    append_elem(OP_LIST,
1971                                prepend_elem(OP_LIST, pack, list(arg)),
1972                                newSVOP(OP_METHOD_NAMED, 0, meth)));
1973     imop->op_private |= OPpENTERSUB_NOMOD;
1974
1975     /* Combine the ops. */
1976     *imopsp = append_elem(OP_LIST, *imopsp, imop);
1977 }
1978
1979 /*
1980 =notfor apidoc apply_attrs_string
1981
1982 Attempts to apply a list of attributes specified by the C<attrstr> and
1983 C<len> arguments to the subroutine identified by the C<cv> argument which
1984 is expected to be associated with the package identified by the C<stashpv>
1985 argument (see L<attributes>).  It gets this wrong, though, in that it
1986 does not correctly identify the boundaries of the individual attribute
1987 specifications within C<attrstr>.  This is not really intended for the
1988 public API, but has to be listed here for systems such as AIX which
1989 need an explicit export list for symbols.  (It's called from XS code
1990 in support of the C<ATTRS:> keyword from F<xsubpp>.)  Patches to fix it
1991 to respect attribute syntax properly would be welcome.
1992
1993 =cut
1994 */
1995
1996 void
1997 Perl_apply_attrs_string(pTHX_ const char *stashpv, CV *cv,
1998                         const char *attrstr, STRLEN len)
1999 {
2000     OP *attrs = NULL;
2001
2002     PERL_ARGS_ASSERT_APPLY_ATTRS_STRING;
2003
2004     if (!len) {
2005         len = strlen(attrstr);
2006     }
2007
2008     while (len) {
2009         for (; isSPACE(*attrstr) && len; --len, ++attrstr) ;
2010         if (len) {
2011             const char * const sstr = attrstr;
2012             for (; !isSPACE(*attrstr) && len; --len, ++attrstr) ;
2013             attrs = append_elem(OP_LIST, attrs,
2014                                 newSVOP(OP_CONST, 0,
2015                                         newSVpvn(sstr, attrstr-sstr)));
2016         }
2017     }
2018
2019     Perl_load_module(aTHX_ PERL_LOADMOD_IMPORT_OPS,
2020                      newSVpvs(ATTRSMODULE),
2021                      NULL, prepend_elem(OP_LIST,
2022                                   newSVOP(OP_CONST, 0, newSVpv(stashpv,0)),
2023                                   prepend_elem(OP_LIST,
2024                                                newSVOP(OP_CONST, 0,
2025                                                        newRV(MUTABLE_SV(cv))),
2026                                                attrs)));
2027 }
2028
2029 STATIC OP *
2030 S_my_kid(pTHX_ OP *o, OP *attrs, OP **imopsp)
2031 {
2032     dVAR;
2033     I32 type;
2034
2035     PERL_ARGS_ASSERT_MY_KID;
2036
2037     if (!o || (PL_parser && PL_parser->error_count))
2038         return o;
2039
2040     type = o->op_type;
2041     if (PL_madskills && type == OP_NULL && o->op_flags & OPf_KIDS) {
2042         (void)my_kid(cUNOPo->op_first, attrs, imopsp);
2043         return o;
2044     }
2045
2046     if (type == OP_LIST) {
2047         OP *kid;
2048         for (kid = cLISTOPo->op_first; kid; kid = kid->op_sibling)
2049             my_kid(kid, attrs, imopsp);
2050     } else if (type == OP_UNDEF
2051 #ifdef PERL_MAD
2052                || type == OP_STUB
2053 #endif
2054                ) {
2055         return o;
2056     } else if (type == OP_RV2SV ||      /* "our" declaration */
2057                type == OP_RV2AV ||
2058                type == OP_RV2HV) { /* XXX does this let anything illegal in? */
2059         if (cUNOPo->op_first->op_type != OP_GV) { /* MJD 20011224 */
2060             yyerror(Perl_form(aTHX_ "Can't declare %s in \"%s\"",
2061                         OP_DESC(o),
2062                         PL_parser->in_my == KEY_our
2063                             ? "our"
2064                             : PL_parser->in_my == KEY_state ? "state" : "my"));
2065         } else if (attrs) {
2066             GV * const gv = cGVOPx_gv(cUNOPo->op_first);
2067             PL_parser->in_my = FALSE;
2068             PL_parser->in_my_stash = NULL;
2069             apply_attrs(GvSTASH(gv),
2070                         (type == OP_RV2SV ? GvSV(gv) :
2071                          type == OP_RV2AV ? MUTABLE_SV(GvAV(gv)) :
2072                          type == OP_RV2HV ? MUTABLE_SV(GvHV(gv)) : MUTABLE_SV(gv)),
2073                         attrs, FALSE);
2074         }
2075         o->op_private |= OPpOUR_INTRO;
2076         return o;
2077     }
2078     else if (type != OP_PADSV &&
2079              type != OP_PADAV &&
2080              type != OP_PADHV &&
2081              type != OP_PUSHMARK)
2082     {
2083         yyerror(Perl_form(aTHX_ "Can't declare %s in \"%s\"",
2084                           OP_DESC(o),
2085                           PL_parser->in_my == KEY_our
2086                             ? "our"
2087                             : PL_parser->in_my == KEY_state ? "state" : "my"));
2088         return o;
2089     }
2090     else if (attrs && type != OP_PUSHMARK) {
2091         HV *stash;
2092
2093         PL_parser->in_my = FALSE;
2094         PL_parser->in_my_stash = NULL;
2095
2096         /* check for C<my Dog $spot> when deciding package */
2097         stash = PAD_COMPNAME_TYPE(o->op_targ);
2098         if (!stash)
2099             stash = PL_curstash;
2100         apply_attrs_my(stash, o, attrs, imopsp);
2101     }
2102     o->op_flags |= OPf_MOD;
2103     o->op_private |= OPpLVAL_INTRO;
2104     if (PL_parser->in_my == KEY_state)
2105         o->op_private |= OPpPAD_STATE;
2106     return o;
2107 }
2108
2109 OP *
2110 Perl_my_attrs(pTHX_ OP *o, OP *attrs)
2111 {
2112     dVAR;
2113     OP *rops;
2114     int maybe_scalar = 0;
2115
2116     PERL_ARGS_ASSERT_MY_ATTRS;
2117
2118 /* [perl #17376]: this appears to be premature, and results in code such as
2119    C< our(%x); > executing in list mode rather than void mode */
2120 #if 0
2121     if (o->op_flags & OPf_PARENS)
2122         list(o);
2123     else
2124         maybe_scalar = 1;
2125 #else
2126     maybe_scalar = 1;
2127 #endif
2128     if (attrs)
2129         SAVEFREEOP(attrs);
2130     rops = NULL;
2131     o = my_kid(o, attrs, &rops);
2132     if (rops) {
2133         if (maybe_scalar && o->op_type == OP_PADSV) {
2134             o = scalar(append_list(OP_LIST, (LISTOP*)rops, (LISTOP*)o));
2135             o->op_private |= OPpLVAL_INTRO;
2136         }
2137         else
2138             o = append_list(OP_LIST, (LISTOP*)o, (LISTOP*)rops);
2139     }
2140     PL_parser->in_my = FALSE;
2141     PL_parser->in_my_stash = NULL;
2142     return o;
2143 }
2144
2145 OP *
2146 Perl_sawparens(pTHX_ OP *o)
2147 {
2148     PERL_UNUSED_CONTEXT;
2149     if (o)
2150         o->op_flags |= OPf_PARENS;
2151     return o;
2152 }
2153
2154 OP *
2155 Perl_bind_match(pTHX_ I32 type, OP *left, OP *right)
2156 {
2157     OP *o;
2158     bool ismatchop = 0;
2159     const OPCODE ltype = left->op_type;
2160     const OPCODE rtype = right->op_type;
2161
2162     PERL_ARGS_ASSERT_BIND_MATCH;
2163
2164     if ( (ltype == OP_RV2AV || ltype == OP_RV2HV || ltype == OP_PADAV
2165           || ltype == OP_PADHV) && ckWARN(WARN_MISC))
2166     {
2167       const char * const desc
2168           = PL_op_desc[(rtype == OP_SUBST || rtype == OP_TRANS)
2169                        ? (int)rtype : OP_MATCH];
2170       const char * const sample = ((ltype == OP_RV2AV || ltype == OP_PADAV)
2171              ? "@array" : "%hash");
2172       Perl_warner(aTHX_ packWARN(WARN_MISC),
2173              "Applying %s to %s will act on scalar(%s)",
2174              desc, sample, sample);
2175     }
2176
2177     if (rtype == OP_CONST &&
2178         cSVOPx(right)->op_private & OPpCONST_BARE &&
2179         cSVOPx(right)->op_private & OPpCONST_STRICT)
2180     {
2181         no_bareword_allowed(right);
2182     }
2183
2184     ismatchop = rtype == OP_MATCH ||
2185                 rtype == OP_SUBST ||
2186                 rtype == OP_TRANS;
2187     if (ismatchop && right->op_private & OPpTARGET_MY) {
2188         right->op_targ = 0;
2189         right->op_private &= ~OPpTARGET_MY;
2190     }
2191     if (!(right->op_flags & OPf_STACKED) && ismatchop) {
2192         OP *newleft;
2193
2194         right->op_flags |= OPf_STACKED;
2195         if (rtype != OP_MATCH &&
2196             ! (rtype == OP_TRANS &&
2197                right->op_private & OPpTRANS_IDENTICAL))
2198             newleft = mod(left, rtype);
2199         else
2200             newleft = left;
2201         if (right->op_type == OP_TRANS)
2202             o = newBINOP(OP_NULL, OPf_STACKED, scalar(newleft), right);
2203         else
2204             o = prepend_elem(rtype, scalar(newleft), right);
2205         if (type == OP_NOT)
2206             return newUNOP(OP_NOT, 0, scalar(o));
2207         return o;
2208     }
2209     else
2210         return bind_match(type, left,
2211                 pmruntime(newPMOP(OP_MATCH, 0), right, 0));
2212 }
2213
2214 OP *
2215 Perl_invert(pTHX_ OP *o)
2216 {
2217     if (!o)
2218         return NULL;
2219     return newUNOP(OP_NOT, OPf_SPECIAL, scalar(o));
2220 }
2221
2222 OP *
2223 Perl_scope(pTHX_ OP *o)
2224 {
2225     dVAR;
2226     if (o) {
2227         if (o->op_flags & OPf_PARENS || PERLDB_NOOPT || PL_tainting) {
2228             o = prepend_elem(OP_LINESEQ, newOP(OP_ENTER, 0), o);
2229             o->op_type = OP_LEAVE;
2230             o->op_ppaddr = PL_ppaddr[OP_LEAVE];
2231         }
2232         else if (o->op_type == OP_LINESEQ) {
2233             OP *kid;
2234             o->op_type = OP_SCOPE;
2235             o->op_ppaddr = PL_ppaddr[OP_SCOPE];
2236             kid = ((LISTOP*)o)->op_first;
2237             if (kid->op_type == OP_NEXTSTATE || kid->op_type == OP_DBSTATE) {
2238                 op_null(kid);
2239
2240                 /* The following deals with things like 'do {1 for 1}' */
2241                 kid = kid->op_sibling;
2242                 if (kid &&
2243                     (kid->op_type == OP_NEXTSTATE || kid->op_type == OP_DBSTATE))
2244                     op_null(kid);
2245             }
2246         }
2247         else
2248             o = newLISTOP(OP_SCOPE, 0, o, NULL);
2249     }
2250     return o;
2251 }
2252         
2253 int
2254 Perl_block_start(pTHX_ int full)
2255 {
2256     dVAR;
2257     const int retval = PL_savestack_ix;
2258     pad_block_start(full);
2259     SAVEHINTS();
2260     PL_hints &= ~HINT_BLOCK_SCOPE;
2261     SAVECOMPILEWARNINGS();
2262     PL_compiling.cop_warnings = DUP_WARNINGS(PL_compiling.cop_warnings);
2263     return retval;
2264 }
2265
2266 OP*
2267 Perl_block_end(pTHX_ I32 floor, OP *seq)
2268 {
2269     dVAR;
2270     const int needblockscope = PL_hints & HINT_BLOCK_SCOPE;
2271     OP* const retval = scalarseq(seq);
2272     LEAVE_SCOPE(floor);
2273     CopHINTS_set(&PL_compiling, PL_hints);
2274     if (needblockscope)
2275         PL_hints |= HINT_BLOCK_SCOPE; /* propagate out */
2276     pad_leavemy();
2277     return retval;
2278 }
2279
2280 STATIC OP *
2281 S_newDEFSVOP(pTHX)
2282 {
2283     dVAR;
2284     const PADOFFSET offset = pad_findmy("$_");
2285     if (offset == NOT_IN_PAD || PAD_COMPNAME_FLAGS_isOUR(offset)) {
2286         return newSVREF(newGVOP(OP_GV, 0, PL_defgv));
2287     }
2288     else {
2289         OP * const o = newOP(OP_PADSV, 0);
2290         o->op_targ = offset;
2291         return o;
2292     }
2293 }
2294
2295 void
2296 Perl_newPROG(pTHX_ OP *o)
2297 {
2298     dVAR;
2299
2300     PERL_ARGS_ASSERT_NEWPROG;
2301
2302     if (PL_in_eval) {
2303         if (PL_eval_root)
2304                 return;
2305         PL_eval_root = newUNOP(OP_LEAVEEVAL,
2306                                ((PL_in_eval & EVAL_KEEPERR)
2307                                 ? OPf_SPECIAL : 0), o);
2308         PL_eval_start = linklist(PL_eval_root);
2309         PL_eval_root->op_private |= OPpREFCOUNTED;
2310         OpREFCNT_set(PL_eval_root, 1);
2311         PL_eval_root->op_next = 0;
2312         CALL_PEEP(PL_eval_start);
2313     }
2314     else {
2315         if (o->op_type == OP_STUB) {
2316             PL_comppad_name = 0;
2317             PL_compcv = 0;
2318             S_op_destroy(aTHX_ o);
2319             return;
2320         }
2321         PL_main_root = scope(sawparens(scalarvoid(o)));
2322         PL_curcop = &PL_compiling;
2323         PL_main_start = LINKLIST(PL_main_root);
2324         PL_main_root->op_private |= OPpREFCOUNTED;
2325         OpREFCNT_set(PL_main_root, 1);
2326         PL_main_root->op_next = 0;
2327         CALL_PEEP(PL_main_start);
2328         PL_compcv = 0;
2329
2330         /* Register with debugger */
2331         if (PERLDB_INTER) {
2332             CV * const cv = get_cvs("DB::postponed", 0);
2333             if (cv) {
2334                 dSP;
2335                 PUSHMARK(SP);
2336                 XPUSHs(MUTABLE_SV(CopFILEGV(&PL_compiling)));
2337                 PUTBACK;
2338                 call_sv(MUTABLE_SV(cv), G_DISCARD);
2339             }
2340         }
2341     }
2342 }
2343
2344 OP *
2345 Perl_localize(pTHX_ OP *o, I32 lex)
2346 {
2347     dVAR;
2348
2349     PERL_ARGS_ASSERT_LOCALIZE;
2350
2351     if (o->op_flags & OPf_PARENS)
2352 /* [perl #17376]: this appears to be premature, and results in code such as
2353    C< our(%x); > executing in list mode rather than void mode */
2354 #if 0
2355         list(o);
2356 #else
2357         NOOP;
2358 #endif
2359     else {
2360         if ( PL_parser->bufptr > PL_parser->oldbufptr
2361             && PL_parser->bufptr[-1] == ','
2362             && ckWARN(WARN_PARENTHESIS))
2363         {
2364             char *s = PL_parser->bufptr;
2365             bool sigil = FALSE;
2366
2367             /* some heuristics to detect a potential error */
2368             while (*s && (strchr(", \t\n", *s)))
2369                 s++;
2370
2371             while (1) {
2372                 if (*s && strchr("@$%*", *s) && *++s
2373                        && (isALNUM(*s) || UTF8_IS_CONTINUED(*s))) {
2374                     s++;
2375                     sigil = TRUE;
2376                     while (*s && (isALNUM(*s) || UTF8_IS_CONTINUED(*s)))
2377                         s++;
2378                     while (*s && (strchr(", \t\n", *s)))
2379                         s++;
2380                 }
2381                 else
2382                     break;
2383             }
2384             if (sigil && (*s == ';' || *s == '=')) {
2385                 Perl_warner(aTHX_ packWARN(WARN_PARENTHESIS),
2386                                 "Parentheses missing around \"%s\" list",
2387                                 lex
2388                                     ? (PL_parser->in_my == KEY_our
2389                                         ? "our"
2390                                         : PL_parser->in_my == KEY_state
2391                                             ? "state"
2392                                             : "my")
2393                                     : "local");
2394             }
2395         }
2396     }
2397     if (lex)
2398         o = my(o);
2399     else
2400         o = mod(o, OP_NULL);            /* a bit kludgey */
2401     PL_parser->in_my = FALSE;
2402     PL_parser->in_my_stash = NULL;
2403     return o;
2404 }
2405
2406 OP *
2407 Perl_jmaybe(pTHX_ OP *o)
2408 {
2409     PERL_ARGS_ASSERT_JMAYBE;
2410
2411     if (o->op_type == OP_LIST) {
2412         OP * const o2
2413             = newSVREF(newGVOP(OP_GV, 0, gv_fetchpvs(";", GV_ADD|GV_NOTQUAL, SVt_PV)));
2414         o = convert(OP_JOIN, 0, prepend_elem(OP_LIST, o2, o));
2415     }
2416     return o;
2417 }
2418
2419 static OP *
2420 S_fold_constants(pTHX_ register OP *o)
2421 {
2422     dVAR;
2423     register OP * VOL curop;
2424     OP *newop;
2425     VOL I32 type = o->op_type;
2426     SV * VOL sv = NULL;
2427     int ret = 0;
2428     I32 oldscope;
2429     OP *old_next;
2430     SV * const oldwarnhook = PL_warnhook;
2431     SV * const olddiehook  = PL_diehook;
2432     COP not_compiling;
2433     dJMPENV;
2434
2435     PERL_ARGS_ASSERT_FOLD_CONSTANTS;
2436
2437     if (PL_opargs[type] & OA_RETSCALAR)
2438         scalar(o);
2439     if (PL_opargs[type] & OA_TARGET && !o->op_targ)
2440         o->op_targ = pad_alloc(type, SVs_PADTMP);
2441
2442     /* integerize op, unless it happens to be C<-foo>.
2443      * XXX should pp_i_negate() do magic string negation instead? */
2444     if ((PL_opargs[type] & OA_OTHERINT) && (PL_hints & HINT_INTEGER)
2445         && !(type == OP_NEGATE && cUNOPo->op_first->op_type == OP_CONST
2446              && (cUNOPo->op_first->op_private & OPpCONST_BARE)))
2447     {
2448         o->op_ppaddr = PL_ppaddr[type = ++(o->op_type)];
2449     }
2450
2451     if (!(PL_opargs[type] & OA_FOLDCONST))
2452         goto nope;
2453
2454     switch (type) {
2455     case OP_NEGATE:
2456         /* XXX might want a ck_negate() for this */
2457         cUNOPo->op_first->op_private &= ~OPpCONST_STRICT;
2458         break;
2459     case OP_UCFIRST:
2460     case OP_LCFIRST:
2461     case OP_UC:
2462     case OP_LC:
2463     case OP_SLT:
2464     case OP_SGT:
2465     case OP_SLE:
2466     case OP_SGE:
2467     case OP_SCMP:
2468         /* XXX what about the numeric ops? */
2469         if (PL_hints & HINT_LOCALE)
2470             goto nope;
2471         break;
2472     }
2473
2474     if (PL_parser && PL_parser->error_count)
2475         goto nope;              /* Don't try to run w/ errors */
2476
2477     for (curop = LINKLIST(o); curop != o; curop = LINKLIST(curop)) {
2478         const OPCODE type = curop->op_type;
2479         if ((type != OP_CONST || (curop->op_private & OPpCONST_BARE)) &&
2480             type != OP_LIST &&
2481             type != OP_SCALAR &&
2482             type != OP_NULL &&
2483             type != OP_PUSHMARK)
2484         {
2485             goto nope;
2486         }
2487     }
2488
2489     curop = LINKLIST(o);
2490     old_next = o->op_next;
2491     o->op_next = 0;
2492     PL_op = curop;
2493
2494     oldscope = PL_scopestack_ix;
2495     create_eval_scope(G_FAKINGEVAL);
2496
2497     /* Verify that we don't need to save it:  */
2498     assert(PL_curcop == &PL_compiling);
2499     StructCopy(&PL_compiling, &not_compiling, COP);
2500     PL_curcop = &not_compiling;
2501     /* The above ensures that we run with all the correct hints of the
2502        currently compiling COP, but that IN_PERL_RUNTIME is not true. */
2503     assert(IN_PERL_RUNTIME);
2504     PL_warnhook = PERL_WARNHOOK_FATAL;
2505     PL_diehook  = NULL;
2506     JMPENV_PUSH(ret);
2507
2508     switch (ret) {
2509     case 0:
2510         CALLRUNOPS(aTHX);
2511         sv = *(PL_stack_sp--);
2512         if (o->op_targ && sv == PAD_SV(o->op_targ))     /* grab pad temp? */
2513             pad_swipe(o->op_targ,  FALSE);
2514         else if (SvTEMP(sv)) {                  /* grab mortal temp? */
2515             SvREFCNT_inc_simple_void(sv);
2516             SvTEMP_off(sv);
2517         }
2518         break;
2519     case 3:
2520         /* Something tried to die.  Abandon constant folding.  */
2521         /* Pretend the error never happened.  */
2522         CLEAR_ERRSV();
2523         o->op_next = old_next;
2524         break;
2525     default:
2526         JMPENV_POP;
2527         /* Don't expect 1 (setjmp failed) or 2 (something called my_exit)  */
2528         PL_warnhook = oldwarnhook;
2529         PL_diehook  = olddiehook;
2530         /* XXX note that this croak may fail as we've already blown away
2531          * the stack - eg any nested evals */
2532         Perl_croak(aTHX_ "panic: fold_constants JMPENV_PUSH returned %d", ret);
2533     }
2534     JMPENV_POP;
2535     PL_warnhook = oldwarnhook;
2536     PL_diehook  = olddiehook;
2537     PL_curcop = &PL_compiling;
2538
2539     if (PL_scopestack_ix > oldscope)
2540         delete_eval_scope();
2541
2542     if (ret)
2543         goto nope;
2544
2545 #ifndef PERL_MAD
2546     op_free(o);
2547 #endif
2548     assert(sv);
2549     if (type == OP_RV2GV)
2550         newop = newGVOP(OP_GV, 0, MUTABLE_GV(sv));
2551     else
2552         newop = newSVOP(OP_CONST, 0, MUTABLE_SV(sv));
2553     op_getmad(o,newop,'f');
2554     return newop;
2555
2556  nope:
2557     return o;
2558 }
2559
2560 static OP *
2561 S_gen_constant_list(pTHX_ register OP *o)
2562 {
2563     dVAR;
2564     register OP *curop;
2565     const I32 oldtmps_floor = PL_tmps_floor;
2566
2567     list(o);
2568     if (PL_parser && PL_parser->error_count)
2569         return o;               /* Don't attempt to run with errors */
2570
2571     PL_op = curop = LINKLIST(o);
2572     o->op_next = 0;
2573     CALL_PEEP(curop);
2574     pp_pushmark();
2575     CALLRUNOPS(aTHX);
2576     PL_op = curop;
2577     assert (!(curop->op_flags & OPf_SPECIAL));
2578     assert(curop->op_type == OP_RANGE);
2579     pp_anonlist();
2580     PL_tmps_floor = oldtmps_floor;
2581
2582     o->op_type = OP_RV2AV;
2583     o->op_ppaddr = PL_ppaddr[OP_RV2AV];
2584     o->op_flags &= ~OPf_REF;    /* treat \(1..2) like an ordinary list */
2585     o->op_flags |= OPf_PARENS;  /* and flatten \(1..2,3) */
2586     o->op_opt = 0;              /* needs to be revisited in peep() */
2587     curop = ((UNOP*)o)->op_first;
2588     ((UNOP*)o)->op_first = newSVOP(OP_CONST, 0, SvREFCNT_inc_NN(*PL_stack_sp--));
2589 #ifdef PERL_MAD
2590     op_getmad(curop,o,'O');
2591 #else
2592     op_free(curop);
2593 #endif
2594     linklist(o);
2595     return list(o);
2596 }
2597
2598 OP *
2599 Perl_convert(pTHX_ I32 type, I32 flags, OP *o)
2600 {
2601     dVAR;
2602     if (!o || o->op_type != OP_LIST)
2603         o = newLISTOP(OP_LIST, 0, o, NULL);
2604     else
2605         o->op_flags &= ~OPf_WANT;
2606
2607     if (!(PL_opargs[type] & OA_MARK))
2608         op_null(cLISTOPo->op_first);
2609
2610     o->op_type = (OPCODE)type;
2611     o->op_ppaddr = PL_ppaddr[type];
2612     o->op_flags |= flags;
2613
2614     o = CHECKOP(type, o);
2615     if (o->op_type != (unsigned)type)
2616         return o;
2617
2618     return fold_constants(o);
2619 }
2620
2621 /* List constructors */
2622
2623 OP *
2624 Perl_append_elem(pTHX_ I32 type, OP *first, OP *last)
2625 {
2626     if (!first)
2627         return last;
2628
2629     if (!last)
2630         return first;
2631
2632     if (first->op_type != (unsigned)type
2633         || (type == OP_LIST && (first->op_flags & OPf_PARENS)))
2634     {
2635         return newLISTOP(type, 0, first, last);
2636     }
2637
2638     if (first->op_flags & OPf_KIDS)
2639         ((LISTOP*)first)->op_last->op_sibling = last;
2640     else {
2641         first->op_flags |= OPf_KIDS;
2642         ((LISTOP*)first)->op_first = last;
2643     }
2644     ((LISTOP*)first)->op_last = last;
2645     return first;
2646 }
2647
2648 OP *
2649 Perl_append_list(pTHX_ I32 type, LISTOP *first, LISTOP *last)
2650 {
2651     if (!first)
2652         return (OP*)last;
2653
2654     if (!last)
2655         return (OP*)first;
2656
2657     if (first->op_type != (unsigned)type)
2658         return prepend_elem(type, (OP*)first, (OP*)last);
2659
2660     if (last->op_type != (unsigned)type)
2661         return append_elem(type, (OP*)first, (OP*)last);
2662
2663     first->op_last->op_sibling = last->op_first;
2664     first->op_last = last->op_last;
2665     first->op_flags |= (last->op_flags & OPf_KIDS);
2666
2667 #ifdef PERL_MAD
2668     if (last->op_first && first->op_madprop) {
2669         MADPROP *mp = last->op_first->op_madprop;
2670         if (mp) {
2671             while (mp->mad_next)
2672                 mp = mp->mad_next;
2673             mp->mad_next = first->op_madprop;
2674         }
2675         else {
2676             last->op_first->op_madprop = first->op_madprop;
2677         }
2678     }
2679     first->op_madprop = last->op_madprop;
2680     last->op_madprop = 0;
2681 #endif
2682
2683     S_op_destroy(aTHX_ (OP*)last);
2684
2685     return (OP*)first;
2686 }
2687
2688 OP *
2689 Perl_prepend_elem(pTHX_ I32 type, OP *first, OP *last)
2690 {
2691     if (!first)
2692         return last;
2693
2694     if (!last)
2695         return first;
2696
2697     if (last->op_type == (unsigned)type) {
2698         if (type == OP_LIST) {  /* already a PUSHMARK there */
2699             first->op_sibling = ((LISTOP*)last)->op_first->op_sibling;
2700             ((LISTOP*)last)->op_first->op_sibling = first;
2701             if (!(first->op_flags & OPf_PARENS))
2702                 last->op_flags &= ~OPf_PARENS;
2703         }
2704         else {
2705             if (!(last->op_flags & OPf_KIDS)) {
2706                 ((LISTOP*)last)->op_last = first;
2707                 last->op_flags |= OPf_KIDS;
2708             }
2709             first->op_sibling = ((LISTOP*)last)->op_first;
2710             ((LISTOP*)last)->op_first = first;
2711         }
2712         last->op_flags |= OPf_KIDS;
2713         return last;
2714     }
2715
2716     return newLISTOP(type, 0, first, last);
2717 }
2718
2719 /* Constructors */
2720
2721 #ifdef PERL_MAD
2722  
2723 TOKEN *
2724 Perl_newTOKEN(pTHX_ I32 optype, YYSTYPE lval, MADPROP* madprop)
2725 {
2726     TOKEN *tk;
2727     Newxz(tk, 1, TOKEN);
2728     tk->tk_type = (OPCODE)optype;
2729     tk->tk_type = 12345;
2730     tk->tk_lval = lval;
2731     tk->tk_mad = madprop;
2732     return tk;
2733 }
2734
2735 void
2736 Perl_token_free(pTHX_ TOKEN* tk)
2737 {
2738     PERL_ARGS_ASSERT_TOKEN_FREE;
2739
2740     if (tk->tk_type != 12345)
2741         return;
2742     mad_free(tk->tk_mad);
2743     Safefree(tk);
2744 }
2745
2746 void
2747 Perl_token_getmad(pTHX_ TOKEN* tk, OP* o, char slot)
2748 {
2749     MADPROP* mp;
2750     MADPROP* tm;
2751
2752     PERL_ARGS_ASSERT_TOKEN_GETMAD;
2753
2754     if (tk->tk_type != 12345) {
2755         Perl_warner(aTHX_ packWARN(WARN_MISC),
2756              "Invalid TOKEN object ignored");
2757         return;
2758     }
2759     tm = tk->tk_mad;
2760     if (!tm)
2761         return;
2762
2763     /* faked up qw list? */
2764     if (slot == '(' &&
2765         tm->mad_type == MAD_SV &&
2766         SvPVX((SV *)tm->mad_val)[0] == 'q')
2767             slot = 'x';
2768
2769     if (o) {
2770         mp = o->op_madprop;
2771         if (mp) {
2772             for (;;) {
2773                 /* pretend constant fold didn't happen? */
2774                 if (mp->mad_key == 'f' &&
2775                     (o->op_type == OP_CONST ||
2776                      o->op_type == OP_GV) )
2777                 {
2778                     token_getmad(tk,(OP*)mp->mad_val,slot);
2779                     return;
2780                 }
2781                 if (!mp->mad_next)
2782                     break;
2783                 mp = mp->mad_next;
2784             }
2785             mp->mad_next = tm;
2786             mp = mp->mad_next;
2787         }
2788         else {
2789             o->op_madprop = tm;
2790             mp = o->op_madprop;
2791         }
2792         if (mp->mad_key == 'X')
2793             mp->mad_key = slot; /* just change the first one */
2794
2795         tk->tk_mad = 0;
2796     }
2797     else
2798         mad_free(tm);
2799     Safefree(tk);
2800 }
2801
2802 void
2803 Perl_op_getmad_weak(pTHX_ OP* from, OP* o, char slot)
2804 {
2805     MADPROP* mp;
2806     if (!from)
2807         return;
2808     if (o) {
2809         mp = o->op_madprop;
2810         if (mp) {
2811             for (;;) {
2812                 /* pretend constant fold didn't happen? */
2813                 if (mp->mad_key == 'f' &&
2814                     (o->op_type == OP_CONST ||
2815                      o->op_type == OP_GV) )
2816                 {
2817                     op_getmad(from,(OP*)mp->mad_val,slot);
2818                     return;
2819                 }
2820                 if (!mp->mad_next)
2821                     break;
2822                 mp = mp->mad_next;
2823             }
2824             mp->mad_next = newMADPROP(slot,MAD_OP,from,0);
2825         }
2826         else {
2827             o->op_madprop = newMADPROP(slot,MAD_OP,from,0);
2828         }
2829     }
2830 }
2831
2832 void
2833 Perl_op_getmad(pTHX_ OP* from, OP* o, char slot)
2834 {
2835     MADPROP* mp;
2836     if (!from)
2837         return;
2838     if (o) {
2839         mp = o->op_madprop;
2840         if (mp) {
2841             for (;;) {
2842                 /* pretend constant fold didn't happen? */
2843                 if (mp->mad_key == 'f' &&
2844                     (o->op_type == OP_CONST ||
2845                      o->op_type == OP_GV) )
2846                 {
2847                     op_getmad(from,(OP*)mp->mad_val,slot);
2848                     return;
2849                 }
2850                 if (!mp->mad_next)
2851                     break;
2852                 mp = mp->mad_next;
2853             }
2854             mp->mad_next = newMADPROP(slot,MAD_OP,from,1);
2855         }
2856         else {
2857             o->op_madprop = newMADPROP(slot,MAD_OP,from,1);
2858         }
2859     }
2860     else {
2861         PerlIO_printf(PerlIO_stderr(),
2862                       "DESTROYING op = %0"UVxf"\n", PTR2UV(from));
2863         op_free(from);
2864     }
2865 }
2866
2867 void
2868 Perl_prepend_madprops(pTHX_ MADPROP* mp, OP* o, char slot)
2869 {
2870     MADPROP* tm;
2871     if (!mp || !o)
2872         return;
2873     if (slot)
2874         mp->mad_key = slot;
2875     tm = o->op_madprop;
2876     o->op_madprop = mp;
2877     for (;;) {
2878         if (!mp->mad_next)
2879             break;
2880         mp = mp->mad_next;
2881     }
2882     mp->mad_next = tm;
2883 }
2884
2885 void
2886 Perl_append_madprops(pTHX_ MADPROP* tm, OP* o, char slot)
2887 {
2888     if (!o)
2889         return;
2890     addmad(tm, &(o->op_madprop), slot);
2891 }
2892
2893 void
2894 Perl_addmad(pTHX_ MADPROP* tm, MADPROP** root, char slot)
2895 {
2896     MADPROP* mp;
2897     if (!tm || !root)
2898         return;
2899     if (slot)
2900         tm->mad_key = slot;
2901     mp = *root;
2902     if (!mp) {
2903         *root = tm;
2904         return;
2905     }
2906     for (;;) {
2907         if (!mp->mad_next)
2908             break;
2909         mp = mp->mad_next;
2910     }
2911     mp->mad_next = tm;
2912 }
2913
2914 MADPROP *
2915 Perl_newMADsv(pTHX_ char key, SV* sv)
2916 {
2917     PERL_ARGS_ASSERT_NEWMADSV;
2918
2919     return newMADPROP(key, MAD_SV, sv, 0);
2920 }
2921
2922 MADPROP *
2923 Perl_newMADPROP(pTHX_ char key, char type, void* val, I32 vlen)
2924 {
2925     MADPROP *mp;
2926     Newxz(mp, 1, MADPROP);
2927     mp->mad_next = 0;
2928     mp->mad_key = key;
2929     mp->mad_vlen = vlen;
2930     mp->mad_type = type;
2931     mp->mad_val = val;
2932 /*    PerlIO_printf(PerlIO_stderr(), "NEW  mp = %0x\n", mp);  */
2933     return mp;
2934 }
2935
2936 void
2937 Perl_mad_free(pTHX_ MADPROP* mp)
2938 {
2939 /*    PerlIO_printf(PerlIO_stderr(), "FREE mp = %0x\n", mp); */
2940     if (!mp)
2941         return;
2942     if (mp->mad_next)
2943         mad_free(mp->mad_next);
2944 /*    if (PL_parser && PL_parser->lex_state != LEX_NOTPARSING && mp->mad_vlen)
2945         PerlIO_printf(PerlIO_stderr(), "DESTROYING '%c'=<%s>\n", mp->mad_key & 255, mp->mad_val); */
2946     switch (mp->mad_type) {
2947     case MAD_NULL:
2948         break;
2949     case MAD_PV:
2950         Safefree((char*)mp->mad_val);
2951         break;
2952     case MAD_OP:
2953         if (mp->mad_vlen)       /* vlen holds "strong/weak" boolean */
2954             op_free((OP*)mp->mad_val);
2955         break;
2956     case MAD_SV:
2957         sv_free(MUTABLE_SV(mp->mad_val));
2958         break;
2959     default:
2960         PerlIO_printf(PerlIO_stderr(), "Unrecognized mad\n");
2961         break;
2962     }
2963     Safefree(mp);
2964 }
2965
2966 #endif
2967
2968 OP *
2969 Perl_newNULLLIST(pTHX)
2970 {
2971     return newOP(OP_STUB, 0);
2972 }
2973
2974 static OP *
2975 S_force_list(pTHX_ OP *o)
2976 {
2977     if (!o || o->op_type != OP_LIST)
2978         o = newLISTOP(OP_LIST, 0, o, NULL);
2979     op_null(o);
2980     return o;
2981 }
2982
2983 OP *
2984 Perl_newLISTOP(pTHX_ I32 type, I32 flags, OP *first, OP *last)
2985 {
2986     dVAR;
2987     LISTOP *listop;
2988
2989     NewOp(1101, listop, 1, LISTOP);
2990
2991     listop->op_type = (OPCODE)type;
2992     listop->op_ppaddr = PL_ppaddr[type];
2993     if (first || last)
2994         flags |= OPf_KIDS;
2995     listop->op_flags = (U8)flags;
2996
2997     if (!last && first)
2998         last = first;
2999     else if (!first && last)
3000         first = last;
3001     else if (first)
3002         first->op_sibling = last;
3003     listop->op_first = first;
3004     listop->op_last = last;
3005     if (type == OP_LIST) {
3006         OP* const pushop = newOP(OP_PUSHMARK, 0);
3007         pushop->op_sibling = first;
3008         listop->op_first = pushop;
3009         listop->op_flags |= OPf_KIDS;
3010         if (!last)
3011             listop->op_last = pushop;
3012     }
3013
3014     return CHECKOP(type, listop);
3015 }
3016
3017 OP *
3018 Perl_newOP(pTHX_ I32 type, I32 flags)
3019 {
3020     dVAR;
3021     OP *o;
3022     NewOp(1101, o, 1, OP);
3023     o->op_type = (OPCODE)type;
3024     o->op_ppaddr = PL_ppaddr[type];
3025     o->op_flags = (U8)flags;
3026     o->op_latefree = 0;
3027     o->op_latefreed = 0;
3028     o->op_attached = 0;
3029
3030     o->op_next = o;
3031     o->op_private = (U8)(0 | (flags >> 8));
3032     if (PL_opargs[type] & OA_RETSCALAR)
3033         scalar(o);
3034     if (PL_opargs[type] & OA_TARGET)
3035         o->op_targ = pad_alloc(type, SVs_PADTMP);
3036     return CHECKOP(type, o);
3037 }
3038
3039 OP *
3040 Perl_newUNOP(pTHX_ I32 type, I32 flags, OP *first)
3041 {
3042     dVAR;
3043     UNOP *unop;
3044
3045     if (!first)
3046         first = newOP(OP_STUB, 0);
3047     if (PL_opargs[type] & OA_MARK)
3048         first = force_list(first);
3049
3050     NewOp(1101, unop, 1, UNOP);
3051     unop->op_type = (OPCODE)type;
3052     unop->op_ppaddr = PL_ppaddr[type];
3053     unop->op_first = first;
3054     unop->op_flags = (U8)(flags | OPf_KIDS);
3055     unop->op_private = (U8)(1 | (flags >> 8));
3056     unop = (UNOP*) CHECKOP(type, unop);
3057     if (unop->op_next)
3058         return (OP*)unop;
3059
3060     return fold_constants((OP *) unop);
3061 }
3062
3063 OP *
3064 Perl_newBINOP(pTHX_ I32 type, I32 flags, OP *first, OP *last)
3065 {
3066     dVAR;
3067     BINOP *binop;
3068     NewOp(1101, binop, 1, BINOP);
3069
3070     if (!first)
3071         first = newOP(OP_NULL, 0);
3072
3073     binop->op_type = (OPCODE)type;
3074     binop->op_ppaddr = PL_ppaddr[type];
3075     binop->op_first = first;
3076     binop->op_flags = (U8)(flags | OPf_KIDS);
3077     if (!last) {
3078         last = first;
3079         binop->op_private = (U8)(1 | (flags >> 8));
3080     }
3081     else {
3082         binop->op_private = (U8)(2 | (flags >> 8));
3083         first->op_sibling = last;
3084     }
3085
3086     binop = (BINOP*)CHECKOP(type, binop);
3087     if (binop->op_next || binop->op_type != (OPCODE)type)
3088         return (OP*)binop;
3089
3090     binop->op_last = binop->op_first->op_sibling;
3091
3092     return fold_constants((OP *)binop);
3093 }
3094
3095 static int uvcompare(const void *a, const void *b)
3096     __attribute__nonnull__(1)
3097     __attribute__nonnull__(2)
3098     __attribute__pure__;
3099 static int uvcompare(const void *a, const void *b)
3100 {
3101     if (*((const UV *)a) < (*(const UV *)b))
3102         return -1;
3103     if (*((const UV *)a) > (*(const UV *)b))
3104         return 1;
3105     if (*((const UV *)a+1) < (*(const UV *)b+1))
3106         return -1;
3107     if (*((const UV *)a+1) > (*(const UV *)b+1))
3108         return 1;
3109     return 0;
3110 }
3111
3112 static OP *
3113 S_pmtrans(pTHX_ OP *o, OP *expr, OP *repl)
3114 {
3115     dVAR;
3116     SV * const tstr = ((SVOP*)expr)->op_sv;
3117     SV * const rstr =
3118 #ifdef PERL_MAD
3119                         (repl->op_type == OP_NULL)
3120                             ? ((SVOP*)((LISTOP*)repl)->op_first)->op_sv :
3121 #endif
3122                               ((SVOP*)repl)->op_sv;
3123     STRLEN tlen;
3124     STRLEN rlen;
3125     const U8 *t = (U8*)SvPV_const(tstr, tlen);
3126     const U8 *r = (U8*)SvPV_const(rstr, rlen);
3127     register I32 i;
3128     register I32 j;
3129     I32 grows = 0;
3130     register short *tbl;
3131
3132     const I32 complement = o->op_private & OPpTRANS_COMPLEMENT;
3133     const I32 squash     = o->op_private & OPpTRANS_SQUASH;
3134     I32 del              = o->op_private & OPpTRANS_DELETE;
3135     SV* swash;
3136
3137     PERL_ARGS_ASSERT_PMTRANS;
3138
3139     PL_hints |= HINT_BLOCK_SCOPE;
3140
3141     if (SvUTF8(tstr))
3142         o->op_private |= OPpTRANS_FROM_UTF;
3143
3144     if (SvUTF8(rstr))
3145         o->op_private |= OPpTRANS_TO_UTF;
3146
3147     if (o->op_private & (OPpTRANS_FROM_UTF|OPpTRANS_TO_UTF)) {
3148         SV* const listsv = newSVpvs("# comment\n");
3149         SV* transv = NULL;
3150         const U8* tend = t + tlen;
3151         const U8* rend = r + rlen;
3152         STRLEN ulen;
3153         UV tfirst = 1;
3154         UV tlast = 0;
3155         IV tdiff;
3156         UV rfirst = 1;
3157         UV rlast = 0;
3158         IV rdiff;
3159         IV diff;
3160         I32 none = 0;
3161         U32 max = 0;
3162         I32 bits;
3163         I32 havefinal = 0;
3164         U32 final = 0;
3165         const I32 from_utf  = o->op_private & OPpTRANS_FROM_UTF;
3166         const I32 to_utf    = o->op_private & OPpTRANS_TO_UTF;
3167         U8* tsave = NULL;
3168         U8* rsave = NULL;
3169         const U32 flags = UTF8_ALLOW_DEFAULT;
3170
3171         if (!from_utf) {
3172             STRLEN len = tlen;
3173             t = tsave = bytes_to_utf8(t, &len);
3174             tend = t + len;
3175         }
3176         if (!to_utf && rlen) {
3177             STRLEN len = rlen;
3178             r = rsave = bytes_to_utf8(r, &len);
3179             rend = r + len;
3180         }
3181
3182 /* There are several snags with this code on EBCDIC:
3183    1. 0xFF is a legal UTF-EBCDIC byte (there are no illegal bytes).
3184    2. scan_const() in toke.c has encoded chars in native encoding which makes
3185       ranges at least in EBCDIC 0..255 range the bottom odd.
3186 */
3187
3188         if (complement) {
3189             U8 tmpbuf[UTF8_MAXBYTES+1];
3190             UV *cp;
3191             UV nextmin = 0;
3192             Newx(cp, 2*tlen, UV);
3193             i = 0;
3194             transv = newSVpvs("");
3195             while (t < tend) {
3196                 cp[2*i] = utf8n_to_uvuni(t, tend-t, &ulen, flags);
3197                 t += ulen;
3198                 if (t < tend && NATIVE_TO_UTF(*t) == 0xff) {
3199                     t++;
3200                     cp[2*i+1] = utf8n_to_uvuni(t, tend-t, &ulen, flags);
3201                     t += ulen;
3202                 }
3203                 else {
3204                  cp[2*i+1] = cp[2*i];
3205                 }
3206                 i++;
3207             }
3208             qsort(cp, i, 2*sizeof(UV), uvcompare);
3209             for (j = 0; j < i; j++) {
3210                 UV  val = cp[2*j];
3211                 diff = val - nextmin;
3212                 if (diff > 0) {
3213                     t = uvuni_to_utf8(tmpbuf,nextmin);
3214                     sv_catpvn(transv, (char*)tmpbuf, t - tmpbuf);
3215                     if (diff > 1) {
3216                         U8  range_mark = UTF_TO_NATIVE(0xff);
3217                         t = uvuni_to_utf8(tmpbuf, val - 1);
3218                         sv_catpvn(transv, (char *)&range_mark, 1);
3219                         sv_catpvn(transv, (char*)tmpbuf, t - tmpbuf);
3220                     }
3221                 }
3222                 val = cp[2*j+1];
3223                 if (val >= nextmin)
3224                     nextmin = val + 1;
3225             }
3226             t = uvuni_to_utf8(tmpbuf,nextmin);
3227             sv_catpvn(transv, (char*)tmpbuf, t - tmpbuf);
3228             {
3229                 U8 range_mark = UTF_TO_NATIVE(0xff);
3230                 sv_catpvn(transv, (char *)&range_mark, 1);
3231             }
3232             t = uvuni_to_utf8_flags(tmpbuf, 0x7fffffff,
3233                                     UNICODE_ALLOW_SUPER);
3234             sv_catpvn(transv, (char*)tmpbuf, t - tmpbuf);
3235             t = (const U8*)SvPVX_const(transv);
3236             tlen = SvCUR(transv);
3237             tend = t + tlen;
3238             Safefree(cp);
3239         }
3240         else if (!rlen && !del) {
3241             r = t; rlen = tlen; rend = tend;
3242         }
3243         if (!squash) {
3244                 if ((!rlen && !del) || t == r ||
3245                     (tlen == rlen && memEQ((char *)t, (char *)r, tlen)))
3246                 {
3247                     o->op_private |= OPpTRANS_IDENTICAL;
3248                 }
3249         }
3250
3251         while (t < tend || tfirst <= tlast) {
3252             /* see if we need more "t" chars */
3253             if (tfirst > tlast) {
3254                 tfirst = (I32)utf8n_to_uvuni(t, tend - t, &ulen, flags);
3255                 t += ulen;
3256                 if (t < tend && NATIVE_TO_UTF(*t) == 0xff) {    /* illegal utf8 val indicates range */
3257                     t++;
3258                     tlast = (I32)utf8n_to_uvuni(t, tend - t, &ulen, flags);
3259                     t += ulen;
3260                 }
3261                 else
3262                     tlast = tfirst;
3263             }
3264
3265             /* now see if we need more "r" chars */
3266             if (rfirst > rlast) {
3267                 if (r < rend) {
3268                     rfirst = (I32)utf8n_to_uvuni(r, rend - r, &ulen, flags);
3269                     r += ulen;
3270                     if (r < rend && NATIVE_TO_UTF(*r) == 0xff) {        /* illegal utf8 val indicates range */
3271                         r++;
3272                         rlast = (I32)utf8n_to_uvuni(r, rend - r, &ulen, flags);
3273                         r += ulen;
3274                     }
3275                     else
3276                         rlast = rfirst;
3277                 }
3278                 else {
3279                     if (!havefinal++)
3280                         final = rlast;
3281                     rfirst = rlast = 0xffffffff;
3282                 }
3283             }
3284
3285             /* now see which range will peter our first, if either. */
3286             tdiff = tlast - tfirst;
3287             rdiff = rlast - rfirst;
3288
3289             if (tdiff <= rdiff)
3290                 diff = tdiff;
3291             else
3292                 diff = rdiff;
3293
3294             if (rfirst == 0xffffffff) {
3295                 diff = tdiff;   /* oops, pretend rdiff is infinite */
3296                 if (diff > 0)
3297                     Perl_sv_catpvf(aTHX_ listsv, "%04lx\t%04lx\tXXXX\n",
3298                                    (long)tfirst, (long)tlast);
3299                 else
3300                     Perl_sv_catpvf(aTHX_ listsv, "%04lx\t\tXXXX\n", (long)tfirst);
3301             }
3302             else {
3303                 if (diff > 0)
3304                     Perl_sv_catpvf(aTHX_ listsv, "%04lx\t%04lx\t%04lx\n",
3305                                    (long)tfirst, (long)(tfirst + diff),
3306                                    (long)rfirst);
3307                 else
3308                     Perl_sv_catpvf(aTHX_ listsv, "%04lx\t\t%04lx\n",
3309                                    (long)tfirst, (long)rfirst);
3310
3311                 if (rfirst + diff > max)
3312                     max = rfirst + diff;
3313                 if (!grows)
3314                     grows = (tfirst < rfirst &&
3315                              UNISKIP(tfirst) < UNISKIP(rfirst + diff));
3316                 rfirst += diff + 1;
3317             }
3318             tfirst += diff + 1;
3319         }
3320
3321         none = ++max;
3322         if (del)
3323             del = ++max;
3324
3325         if (max > 0xffff)
3326             bits = 32;
3327         else if (max > 0xff)
3328             bits = 16;
3329         else
3330             bits = 8;
3331
3332         PerlMemShared_free(cPVOPo->op_pv);
3333         cPVOPo->op_pv = NULL;
3334
3335         swash = MUTABLE_SV(swash_init("utf8", "", listsv, bits, none));
3336 #ifdef USE_ITHREADS
3337         cPADOPo->op_padix = pad_alloc(OP_TRANS, SVs_PADTMP);
3338         SvREFCNT_dec(PAD_SVl(cPADOPo->op_padix));
3339         PAD_SETSV(cPADOPo->op_padix, swash);
3340         SvPADTMP_on(swash);
3341         SvREADONLY_on(swash);
3342 #else
3343         cSVOPo->op_sv = swash;
3344 #endif
3345         SvREFCNT_dec(listsv);
3346         SvREFCNT_dec(transv);
3347
3348         if (!del && havefinal && rlen)
3349             (void)hv_store(MUTABLE_HV(SvRV(swash)), "FINAL", 5,
3350                            newSVuv((UV)final), 0);
3351
3352         if (grows)
3353             o->op_private |= OPpTRANS_GROWS;
3354
3355         Safefree(tsave);
3356         Safefree(rsave);
3357
3358 #ifdef PERL_MAD
3359         op_getmad(expr,o,'e');
3360         op_getmad(repl,o,'r');
3361 #else
3362         op_free(expr);
3363         op_free(repl);
3364 #endif
3365         return o;
3366     }
3367
3368     tbl = (short*)cPVOPo->op_pv;
3369     if (complement) {
3370         Zero(tbl, 256, short);
3371         for (i = 0; i < (I32)tlen; i++)
3372             tbl[t[i]] = -1;
3373         for (i = 0, j = 0; i < 256; i++) {
3374             if (!tbl[i]) {
3375                 if (j >= (I32)rlen) {
3376                     if (del)
3377                         tbl[i] = -2;
3378                     else if (rlen)
3379                         tbl[i] = r[j-1];
3380                     else
3381                         tbl[i] = (short)i;
3382                 }
3383                 else {
3384                     if (i < 128 && r[j] >= 128)
3385                         grows = 1;
3386                     tbl[i] = r[j++];
3387                 }
3388             }
3389         }
3390         if (!del) {
3391             if (!rlen) {
3392                 j = rlen;
3393                 if (!squash)
3394                     o->op_private |= OPpTRANS_IDENTICAL;
3395             }
3396             else if (j >= (I32)rlen)
3397                 j = rlen - 1;
3398             else {
3399                 tbl = 
3400                     (short *)
3401                     PerlMemShared_realloc(tbl,
3402                                           (0x101+rlen-j) * sizeof(short));
3403                 cPVOPo->op_pv = (char*)tbl;
3404             }
3405             tbl[0x100] = (short)(rlen - j);
3406             for (i=0; i < (I32)rlen - j; i++)
3407                 tbl[0x101+i] = r[j+i];
3408         }
3409     }
3410     else {
3411         if (!rlen && !del) {
3412             r = t; rlen = tlen;
3413             if (!squash)
3414                 o->op_private |= OPpTRANS_IDENTICAL;
3415         }
3416         else if (!squash && rlen == tlen && memEQ((char*)t, (char*)r, tlen)) {
3417             o->op_private |= OPpTRANS_IDENTICAL;
3418         }
3419         for (i = 0; i < 256; i++)
3420             tbl[i] = -1;
3421         for (i = 0, j = 0; i < (I32)tlen; i++,j++) {
3422             if (j >= (I32)rlen) {
3423                 if (del) {
3424                     if (tbl[t[i]] == -1)
3425                         tbl[t[i]] = -2;
3426                     continue;
3427                 }
3428                 --j;
3429             }
3430             if (tbl[t[i]] == -1) {
3431                 if (t[i] < 128 && r[j] >= 128)
3432                     grows = 1;
3433                 tbl[t[i]] = r[j];
3434             }
3435         }
3436     }
3437
3438     if(del && rlen == tlen) {
3439         Perl_ck_warner(aTHX_ packWARN(WARN_MISC), "Useless use of /d modifier in transliteration operator"); 
3440     } else if(rlen > tlen) {
3441         Perl_ck_warner(aTHX_ packWARN(WARN_MISC), "Replacement list is longer than search list");
3442     }
3443
3444     if (grows)
3445         o->op_private |= OPpTRANS_GROWS;
3446 #ifdef PERL_MAD
3447     op_getmad(expr,o,'e');
3448     op_getmad(repl,o,'r');
3449 #else
3450     op_free(expr);
3451     op_free(repl);
3452 #endif
3453
3454     return o;
3455 }
3456
3457 OP *
3458 Perl_newPMOP(pTHX_ I32 type, I32 flags)
3459 {
3460     dVAR;
3461     PMOP *pmop;
3462
3463     NewOp(1101, pmop, 1, PMOP);
3464     pmop->op_type = (OPCODE)type;
3465     pmop->op_ppaddr = PL_ppaddr[type];
3466     pmop->op_flags = (U8)flags;
3467     pmop->op_private = (U8)(0 | (flags >> 8));
3468
3469     if (PL_hints & HINT_RE_TAINT)
3470         pmop->op_pmflags |= PMf_RETAINT;
3471     if (PL_hints & HINT_LOCALE)
3472         pmop->op_pmflags |= PMf_LOCALE;
3473
3474
3475 #ifdef USE_ITHREADS
3476     assert(SvPOK(PL_regex_pad[0]));
3477     if (SvCUR(PL_regex_pad[0])) {
3478         /* Pop off the "packed" IV from the end.  */
3479         SV *const repointer_list = PL_regex_pad[0];
3480         const char *p = SvEND(repointer_list) - sizeof(IV);
3481         const IV offset = *((IV*)p);
3482
3483         assert(SvCUR(repointer_list) % sizeof(IV) == 0);
3484
3485         SvEND_set(repointer_list, p);
3486
3487         pmop->op_pmoffset = offset;
3488         /* This slot should be free, so assert this:  */
3489         assert(PL_regex_pad[offset] == &PL_sv_undef);
3490     } else {
3491         SV * const repointer = &PL_sv_undef;
3492         av_push(PL_regex_padav, repointer);
3493         pmop->op_pmoffset = av_len(PL_regex_padav);
3494         PL_regex_pad = AvARRAY(PL_regex_padav);
3495     }
3496 #endif
3497
3498     return CHECKOP(type, pmop);
3499 }
3500
3501 /* Given some sort of match op o, and an expression expr containing a
3502  * pattern, either compile expr into a regex and attach it to o (if it's
3503  * constant), or convert expr into a runtime regcomp op sequence (if it's
3504  * not)
3505  *
3506  * isreg indicates that the pattern is part of a regex construct, eg
3507  * $x =~ /pattern/ or split /pattern/, as opposed to $x =~ $pattern or
3508  * split "pattern", which aren't. In the former case, expr will be a list
3509  * if the pattern contains more than one term (eg /a$b/) or if it contains
3510  * a replacement, ie s/// or tr///.
3511  */
3512
3513 OP *
3514 Perl_pmruntime(pTHX_ OP *o, OP *expr, bool isreg)
3515 {
3516     dVAR;
3517     PMOP *pm;
3518     LOGOP *rcop;
3519     I32 repl_has_vars = 0;
3520     OP* repl = NULL;
3521     bool reglist;
3522
3523     PERL_ARGS_ASSERT_PMRUNTIME;
3524
3525     if (o->op_type == OP_SUBST || o->op_type == OP_TRANS) {
3526         /* last element in list is the replacement; pop it */
3527         OP* kid;
3528         repl = cLISTOPx(expr)->op_last;
3529         kid = cLISTOPx(expr)->op_first;
3530         while (kid->op_sibling != repl)
3531             kid = kid->op_sibling;
3532         kid->op_sibling = NULL;
3533         cLISTOPx(expr)->op_last = kid;
3534     }
3535
3536     if (isreg && expr->op_type == OP_LIST &&
3537         cLISTOPx(expr)->op_first->op_sibling == cLISTOPx(expr)->op_last)
3538     {
3539         /* convert single element list to element */
3540         OP* const oe = expr;
3541         expr = cLISTOPx(oe)->op_first->op_sibling;
3542         cLISTOPx(oe)->op_first->op_sibling = NULL;
3543         cLISTOPx(oe)->op_last = NULL;
3544         op_free(oe);
3545     }
3546
3547     if (o->op_type == OP_TRANS) {
3548         return pmtrans(o, expr, repl);
3549     }
3550
3551     reglist = isreg && expr->op_type == OP_LIST;
3552     if (reglist)
3553         op_null(expr);
3554
3555     PL_hints |= HINT_BLOCK_SCOPE;
3556     pm = (PMOP*)o;
3557
3558     if (expr->op_type == OP_CONST) {
3559         SV *pat = ((SVOP*)expr)->op_sv;
3560         U32 pm_flags = pm->op_pmflags & PMf_COMPILETIME;
3561
3562         if (o->op_flags & OPf_SPECIAL)
3563             pm_flags |= RXf_SPLIT;
3564
3565         if (DO_UTF8(pat)) {
3566             assert (SvUTF8(pat));
3567         } else if (SvUTF8(pat)) {
3568             /* Not doing UTF-8, despite what the SV says. Is this only if we're
3569                trapped in use 'bytes'?  */
3570             /* Make a copy of the octet sequence, but without the flag on, as
3571                the compiler now honours the SvUTF8 flag on pat.  */
3572             STRLEN len;
3573             const char *const p = SvPV(pat, len);
3574             pat = newSVpvn_flags(p, len, SVs_TEMP);
3575         }
3576
3577         PM_SETRE(pm, CALLREGCOMP(pat, pm_flags));
3578
3579 #ifdef PERL_MAD
3580         op_getmad(expr,(OP*)pm,'e');
3581 #else
3582         op_free(expr);
3583 #endif
3584     }
3585     else {
3586         if (pm->op_pmflags & PMf_KEEP || !(PL_hints & HINT_RE_EVAL))
3587             expr = newUNOP((!(PL_hints & HINT_RE_EVAL)
3588                             ? OP_REGCRESET
3589                             : OP_REGCMAYBE),0,expr);
3590
3591         NewOp(1101, rcop, 1, LOGOP);
3592         rcop->op_type = OP_REGCOMP;
3593         rcop->op_ppaddr = PL_ppaddr[OP_REGCOMP];
3594         rcop->op_first = scalar(expr);
3595         rcop->op_flags |= OPf_KIDS
3596                             | ((PL_hints & HINT_RE_EVAL) ? OPf_SPECIAL : 0)
3597                             | (reglist ? OPf_STACKED : 0);
3598         rcop->op_private = 1;
3599         rcop->op_other = o;
3600         if (reglist)
3601             rcop->op_targ = pad_alloc(rcop->op_type, SVs_PADTMP);
3602
3603         /* /$x/ may cause an eval, since $x might be qr/(?{..})/  */
3604         PL_cv_has_eval = 1;
3605
3606         /* establish postfix order */
3607         if (pm->op_pmflags & PMf_KEEP || !(PL_hints & HINT_RE_EVAL)) {
3608             LINKLIST(expr);
3609             rcop->op_next = expr;
3610             ((UNOP*)expr)->op_first->op_next = (OP*)rcop;
3611         }
3612         else {
3613             rcop->op_next = LINKLIST(expr);
3614             expr->op_next = (OP*)rcop;
3615         }
3616
3617         prepend_elem(o->op_type, scalar((OP*)rcop), o);
3618     }
3619
3620     if (repl) {
3621         OP *curop;
3622         if (pm->op_pmflags & PMf_EVAL) {
3623             curop = NULL;
3624             if (CopLINE(PL_curcop) < (line_t)PL_parser->multi_end)
3625                 CopLINE_set(PL_curcop, (line_t)PL_parser->multi_end);
3626         }
3627         else if (repl->op_type == OP_CONST)
3628             curop = repl;
3629         else {
3630             OP *lastop = NULL;
3631             for (curop = LINKLIST(repl); curop!=repl; curop = LINKLIST(curop)) {
3632                 if (curop->op_type == OP_SCOPE
3633                         || curop->op_type == OP_LEAVE
3634                         || (PL_opargs[curop->op_type] & OA_DANGEROUS)) {
3635                     if (curop->op_type == OP_GV) {
3636                         GV * const gv = cGVOPx_gv(curop);
3637                         repl_has_vars = 1;
3638                         if (strchr("&`'123456789+-\016\022", *GvENAME(gv)))
3639                             break;
3640                     }
3641                     else if (curop->op_type == OP_RV2CV)
3642                         break;
3643                     else if (curop->op_type == OP_RV2SV ||
3644                              curop->op_type == OP_RV2AV ||
3645                              curop->op_type == OP_RV2HV ||
3646                              curop->op_type == OP_RV2GV) {
3647                         if (lastop && lastop->op_type != OP_GV) /*funny deref?*/
3648                             break;
3649                     }
3650                     else if (curop->op_type == OP_PADSV ||
3651                              curop->op_type == OP_PADAV ||
3652                              curop->op_type == OP_PADHV ||
3653                              curop->op_type == OP_PADANY)
3654                     {
3655                         repl_has_vars = 1;
3656                     }
3657                     else if (curop->op_type == OP_PUSHRE)
3658                         NOOP; /* Okay here, dangerous in newASSIGNOP */
3659                     else
3660                         break;
3661                 }
3662                 lastop = curop;
3663             }
3664         }
3665         if (curop == repl
3666             && !(repl_has_vars
3667                  && (!PM_GETRE(pm)
3668                      || RX_EXTFLAGS(PM_GETRE(pm)) & RXf_EVAL_SEEN)))
3669         {
3670             pm->op_pmflags |= PMf_CONST;        /* const for long enough */
3671             prepend_elem(o->op_type, scalar(repl), o);
3672         }
3673         else {
3674             if (curop == repl && !PM_GETRE(pm)) { /* Has variables. */
3675                 pm->op_pmflags |= PMf_MAYBE_CONST;
3676             }
3677             NewOp(1101, rcop, 1, LOGOP);
3678             rcop->op_type = OP_SUBSTCONT;
3679             rcop->op_ppaddr = PL_ppaddr[OP_SUBSTCONT];
3680             rcop->op_first = scalar(repl);
3681             rcop->op_flags |= OPf_KIDS;
3682             rcop->op_private = 1;
3683             rcop->op_other = o;
3684
3685             /* establish postfix order */
3686             rcop->op_next = LINKLIST(repl);
3687             repl->op_next = (OP*)rcop;
3688
3689             pm->op_pmreplrootu.op_pmreplroot = scalar((OP*)rcop);
3690             assert(!(pm->op_pmflags & PMf_ONCE));
3691             pm->op_pmstashstartu.op_pmreplstart = LINKLIST(rcop);
3692             rcop->op_next = 0;
3693         }
3694     }
3695
3696     return (OP*)pm;
3697 }
3698
3699 OP *
3700 Perl_newSVOP(pTHX_ I32 type, I32 flags, SV *sv)
3701 {
3702     dVAR;
3703     SVOP *svop;
3704
3705     PERL_ARGS_ASSERT_NEWSVOP;
3706
3707     NewOp(1101, svop, 1, SVOP);
3708     svop->op_type = (OPCODE)type;
3709     svop->op_ppaddr = PL_ppaddr[type];
3710     svop->op_sv = sv;
3711     svop->op_next = (OP*)svop;
3712     svop->op_flags = (U8)flags;
3713     if (PL_opargs[type] & OA_RETSCALAR)
3714         scalar((OP*)svop);
3715     if (PL_opargs[type] & OA_TARGET)
3716         svop->op_targ = pad_alloc(type, SVs_PADTMP);
3717     return CHECKOP(type, svop);
3718 }
3719
3720 #ifdef USE_ITHREADS
3721 OP *
3722 Perl_newPADOP(pTHX_ I32 type, I32 flags, SV *sv)
3723 {
3724     dVAR;
3725     PADOP *padop;
3726
3727     PERL_ARGS_ASSERT_NEWPADOP;
3728
3729     NewOp(1101, padop, 1, PADOP);
3730     padop->op_type = (OPCODE)type;
3731     padop->op_ppaddr = PL_ppaddr[type];
3732     padop->op_padix = pad_alloc(type, SVs_PADTMP);
3733     SvREFCNT_dec(PAD_SVl(padop->op_padix));
3734     PAD_SETSV(padop->op_padix, sv);
3735     assert(sv);
3736     SvPADTMP_on(sv);
3737     padop->op_next = (OP*)padop;
3738     padop->op_flags = (U8)flags;
3739     if (PL_opargs[type] & OA_RETSCALAR)
3740         scalar((OP*)padop);
3741     if (PL_opargs[type] & OA_TARGET)
3742         padop->op_targ = pad_alloc(type, SVs_PADTMP);
3743     return CHECKOP(type, padop);
3744 }
3745 #endif
3746
3747 OP *
3748 Perl_newGVOP(pTHX_ I32 type, I32 flags, GV *gv)
3749 {
3750     dVAR;
3751
3752     PERL_ARGS_ASSERT_NEWGVOP;
3753
3754 #ifdef USE_ITHREADS
3755     GvIN_PAD_on(gv);
3756     return newPADOP(type, flags, SvREFCNT_inc_simple_NN(gv));
3757 #else
3758     return newSVOP(type, flags, SvREFCNT_inc_simple_NN(gv));
3759 #endif
3760 }
3761
3762 OP *
3763 Perl_newPVOP(pTHX_ I32 type, I32 flags, char *pv)
3764 {
3765     dVAR;
3766     PVOP *pvop;
3767     NewOp(1101, pvop, 1, PVOP);
3768     pvop->op_type = (OPCODE)type;
3769     pvop->op_ppaddr = PL_ppaddr[type];
3770     pvop->op_pv = pv;
3771     pvop->op_next = (OP*)pvop;
3772     pvop->op_flags = (U8)flags;
3773     if (PL_opargs[type] & OA_RETSCALAR)
3774         scalar((OP*)pvop);
3775     if (PL_opargs[type] & OA_TARGET)
3776         pvop->op_targ = pad_alloc(type, SVs_PADTMP);
3777     return CHECKOP(type, pvop);
3778 }
3779
3780 #ifdef PERL_MAD
3781 OP*
3782 #else
3783 void
3784 #endif
3785 Perl_package(pTHX_ OP *o)
3786 {
3787     dVAR;
3788     SV *const sv = cSVOPo->op_sv;
3789 #ifdef PERL_MAD
3790     OP *pegop;
3791 #endif
3792
3793     PERL_ARGS_ASSERT_PACKAGE;
3794
3795     save_hptr(&PL_curstash);
3796     save_item(PL_curstname);
3797
3798     PL_curstash = gv_stashsv(sv, GV_ADD);
3799
3800     sv_setsv(PL_curstname, sv);
3801
3802     PL_hints |= HINT_BLOCK_SCOPE;
3803     PL_parser->copline = NOLINE;
3804     PL_parser->expect = XSTATE;
3805
3806 #ifndef PERL_MAD
3807     op_free(o);
3808 #else
3809     if (!PL_madskills) {
3810         op_free(o);
3811         return NULL;
3812     }
3813
3814     pegop = newOP(OP_NULL,0);
3815     op_getmad(o,pegop,'P');
3816     return pegop;
3817 #endif
3818 }
3819
3820 void
3821 Perl_package_version( pTHX_ OP *v )
3822 {
3823     dVAR;
3824     U32 savehints = PL_hints;
3825     PERL_ARGS_ASSERT_PACKAGE_VERSION;
3826     PL_hints &= ~HINT_STRICT_VARS;
3827     sv_setsv( GvSV(gv_fetchpvs("VERSION", GV_ADDMULTI, SVt_PV)), cSVOPx(v)->op_sv );
3828     PL_hints = savehints;
3829     op_free(v);
3830 }
3831
3832 #ifdef PERL_MAD
3833 OP*
3834 #else
3835 void
3836 #endif
3837 Perl_utilize(pTHX_ int aver, I32 floor, OP *version, OP *idop, OP *arg)
3838 {
3839     dVAR;
3840     OP *pack;
3841     OP *imop;
3842     OP *veop;
3843 #ifdef PERL_MAD
3844     OP *pegop = newOP(OP_NULL,0);
3845 #endif
3846
3847     PERL_ARGS_ASSERT_UTILIZE;
3848
3849     if (idop->op_type != OP_CONST)
3850         Perl_croak(aTHX_ "Module name must be constant");
3851
3852     if (PL_madskills)
3853         op_getmad(idop,pegop,'U');
3854
3855     veop = NULL;
3856
3857     if (version) {
3858         SV * const vesv = ((SVOP*)version)->op_sv;
3859
3860         if (PL_madskills)
3861             op_getmad(version,pegop,'V');
3862         if (!arg && !SvNIOKp(vesv)) {
3863             arg = version;
3864         }
3865         else {
3866             OP *pack;
3867             SV *meth;
3868
3869             if (version->op_type != OP_CONST || !SvNIOKp(vesv))
3870                 Perl_croak(aTHX_ "Version number must be a constant number");
3871
3872             /* Make copy of idop so we don't free it twice */
3873             pack = newSVOP(OP_CONST, 0, newSVsv(((SVOP*)idop)->op_sv));
3874
3875             /* Fake up a method call to VERSION */
3876             meth = newSVpvs_share("VERSION");
3877             veop = convert(OP_ENTERSUB, OPf_STACKED|OPf_SPECIAL,
3878                             append_elem(OP_LIST,
3879                                         prepend_elem(OP_LIST, pack, list(version)),
3880                                         newSVOP(OP_METHOD_NAMED, 0, meth)));
3881         }
3882     }
3883
3884     /* Fake up an import/unimport */
3885     if (arg && arg->op_type == OP_STUB) {
3886         if (PL_madskills)
3887             op_getmad(arg,pegop,'S');
3888         imop = arg;             /* no import on explicit () */
3889     }
3890     else if (SvNIOKp(((SVOP*)idop)->op_sv)) {
3891         imop = NULL;            /* use 5.0; */
3892         if (!aver)
3893             idop->op_private |= OPpCONST_NOVER;
3894     }
3895     else {
3896         SV *meth;
3897
3898         if (PL_madskills)
3899             op_getmad(arg,pegop,'A');
3900
3901         /* Make copy of idop so we don't free it twice */
3902         pack = newSVOP(OP_CONST, 0, newSVsv(((SVOP*)idop)->op_sv));
3903
3904         /* Fake up a method call to import/unimport */
3905         meth = aver
3906             ? newSVpvs_share("import") : newSVpvs_share("unimport");
3907         imop = convert(OP_ENTERSUB, OPf_STACKED|OPf_SPECIAL,
3908                        append_elem(OP_LIST,
3909                                    prepend_elem(OP_LIST, pack, list(arg)),
3910                                    newSVOP(OP_METHOD_NAMED, 0, meth)));
3911     }
3912
3913     /* Fake up the BEGIN {}, which does its thing immediately. */
3914     newATTRSUB(floor,
3915         newSVOP(OP_CONST, 0, newSVpvs_share("BEGIN")),
3916         NULL,
3917         NULL,
3918         append_elem(OP_LINESEQ,
3919             append_elem(OP_LINESEQ,
3920                 newSTATEOP(0, NULL, newUNOP(OP_REQUIRE, 0, idop)),
3921                 newSTATEOP(0, NULL, veop)),
3922             newSTATEOP(0, NULL, imop) ));
3923
3924     /* The "did you use incorrect case?" warning used to be here.
3925      * The problem is that on case-insensitive filesystems one
3926      * might get false positives for "use" (and "require"):
3927      * "use Strict" or "require CARP" will work.  This causes
3928      * portability problems for the script: in case-strict
3929      * filesystems the script will stop working.
3930      *
3931      * The "incorrect case" warning checked whether "use Foo"
3932      * imported "Foo" to your namespace, but that is wrong, too:
3933      * there is no requirement nor promise in the language that
3934      * a Foo.pm should or would contain anything in package "Foo".
3935      *
3936      * There is very little Configure-wise that can be done, either:
3937      * the case-sensitivity of the build filesystem of Perl does not
3938      * help in guessing the case-sensitivity of the runtime environment.
3939      */
3940
3941     PL_hints |= HINT_BLOCK_SCOPE;
3942     PL_parser->copline = NOLINE;
3943     PL_parser->expect = XSTATE;
3944     PL_cop_seqmax++; /* Purely for B::*'s benefit */
3945
3946 #ifdef PERL_MAD
3947     if (!PL_madskills) {
3948         /* FIXME - don't allocate pegop if !PL_madskills */
3949         op_free(pegop);
3950         return NULL;
3951     }
3952     return pegop;
3953 #endif
3954 }
3955
3956 /*
3957 =head1 Embedding Functions
3958
3959 =for apidoc load_module
3960
3961 Loads the module whose name is pointed to by the string part of name.
3962 Note that the actual module name, not its filename, should be given.
3963 Eg, "Foo::Bar" instead of "Foo/Bar.pm".  flags can be any of
3964 PERL_LOADMOD_DENY, PERL_LOADMOD_NOIMPORT, or PERL_LOADMOD_IMPORT_OPS
3965 (or 0 for no flags). ver, if specified, provides version semantics
3966 similar to C<use Foo::Bar VERSION>.  The optional trailing SV*
3967 arguments can be used to specify arguments to the module's import()
3968 method, similar to C<use Foo::Bar VERSION LIST>.  They must be
3969 terminated with a final NULL pointer.  Note that this list can only
3970 be omitted when the PERL_LOADMOD_NOIMPORT flag has been used.
3971 Otherwise at least a single NULL pointer to designate the default
3972 import list is required.
3973
3974 =cut */
3975
3976 void
3977 Perl_load_module(pTHX_ U32 flags, SV *name, SV *ver, ...)
3978 {
3979     va_list args;
3980
3981     PERL_ARGS_ASSERT_LOAD_MODULE;
3982
3983     va_start(args, ver);
3984     vload_module(flags, name, ver, &args);
3985     va_end(args);
3986 }
3987
3988 #ifdef PERL_IMPLICIT_CONTEXT
3989 void
3990 Perl_load_module_nocontext(U32 flags, SV *name, SV *ver, ...)
3991 {
3992     dTHX;
3993     va_list args;
3994     PERL_ARGS_ASSERT_LOAD_MODULE_NOCONTEXT;
3995     va_start(args, ver);
3996     vload_module(flags, name, ver, &args);
3997     va_end(args);
3998 }
3999 #endif
4000
4001 void
4002 Perl_vload_module(pTHX_ U32 flags, SV *name, SV *ver, va_list *args)
4003 {
4004     dVAR;
4005     OP *veop, *imop;
4006     OP * const modname = newSVOP(OP_CONST, 0, name);
4007
4008     PERL_ARGS_ASSERT_VLOAD_MODULE;
4009
4010     modname->op_private |= OPpCONST_BARE;
4011     if (ver) {
4012         veop = newSVOP(OP_CONST, 0, ver);
4013     }
4014     else
4015         veop = NULL;
4016     if (flags & PERL_LOADMOD_NOIMPORT) {
4017         imop = sawparens(newNULLLIST());
4018     }
4019     else if (flags & PERL_LOADMOD_IMPORT_OPS) {
4020         imop = va_arg(*args, OP*);
4021     }
4022     else {
4023         SV *sv;
4024         imop = NULL;
4025         sv = va_arg(*args, SV*);
4026         while (sv) {
4027             imop = append_elem(OP_LIST, imop, newSVOP(OP_CONST, 0, sv));
4028             sv = va_arg(*args, SV*);
4029         }
4030     }
4031
4032     /* utilize() fakes up a BEGIN { require ..; import ... }, so make sure
4033      * that it has a PL_parser to play with while doing that, and also
4034      * that it doesn't mess with any existing parser, by creating a tmp
4035      * new parser with lex_start(). This won't actually be used for much,
4036      * since pp_require() will create another parser for the real work. */
4037
4038     ENTER;
4039     SAVEVPTR(PL_curcop);
4040     lex_start(NULL, NULL, FALSE);
4041     utilize(!(flags & PERL_LOADMOD_DENY), start_subparse(FALSE, 0),
4042             veop, modname, imop);
4043     LEAVE;
4044 }
4045
4046 OP *
4047 Perl_dofile(pTHX_ OP *term, I32 force_builtin)
4048 {
4049     dVAR;
4050     OP *doop;
4051     GV *gv = NULL;
4052
4053     PERL_ARGS_ASSERT_DOFILE;
4054
4055     if (!force_builtin) {
4056         gv = gv_fetchpvs("do", GV_NOTQUAL, SVt_PVCV);
4057         if (!(gv && GvCVu(gv) && GvIMPORTED_CV(gv))) {
4058             GV * const * const gvp = (GV**)hv_fetchs(PL_globalstash, "do", FALSE);
4059             gv = gvp ? *gvp : NULL;
4060         }
4061     }
4062
4063     if (gv && GvCVu(gv) && GvIMPORTED_CV(gv)) {
4064         doop = ck_subr(newUNOP(OP_ENTERSUB, OPf_STACKED,
4065                                append_elem(OP_LIST, term,
4066                                            scalar(newUNOP(OP_RV2CV, 0,
4067                                                           newGVOP(OP_GV, 0, gv))))));
4068     }
4069     else {
4070         doop = newUNOP(OP_DOFILE, 0, scalar(term));
4071     }
4072     return doop;
4073 }
4074
4075 OP *
4076 Perl_newSLICEOP(pTHX_ I32 flags, OP *subscript, OP *listval)
4077 {
4078     return newBINOP(OP_LSLICE, flags,
4079             list(force_list(subscript)),
4080             list(force_list(listval)) );
4081 }
4082
4083 STATIC I32
4084 S_is_list_assignment(pTHX_ register const OP *o)
4085 {
4086     unsigned type;
4087     U8 flags;
4088
4089     if (!o)
4090         return TRUE;
4091
4092     if ((o->op_type == OP_NULL) && (o->op_flags & OPf_KIDS))
4093         o = cUNOPo->op_first;
4094
4095     flags = o->op_flags;
4096     type = o->op_type;
4097     if (type == OP_COND_EXPR) {
4098         const I32 t = is_list_assignment(cLOGOPo->op_first->op_sibling);
4099         const I32 f = is_list_assignment(cLOGOPo->op_first->op_sibling->op_sibling);
4100
4101         if (t && f)
4102             return TRUE;
4103         if (t || f)
4104             yyerror("Assignment to both a list and a scalar");
4105         return FALSE;
4106     }
4107
4108     if (type == OP_LIST &&
4109         (flags & OPf_WANT) == OPf_WANT_SCALAR &&
4110         o->op_private & OPpLVAL_INTRO)
4111         return FALSE;
4112
4113     if (type == OP_LIST || flags & OPf_PARENS ||
4114         type == OP_RV2AV || type == OP_RV2HV ||
4115         type == OP_ASLICE || type == OP_HSLICE)
4116         return TRUE;
4117
4118     if (type == OP_PADAV || type == OP_PADHV)
4119         return TRUE;
4120
4121     if (type == OP_RV2SV)
4122         return FALSE;
4123
4124     return FALSE;
4125 }
4126
4127 OP *
4128 Perl_newASSIGNOP(pTHX_ I32 flags, OP *left, I32 optype, OP *right)
4129 {
4130     dVAR;
4131     OP *o;
4132
4133     if (optype) {
4134         if (optype == OP_ANDASSIGN || optype == OP_ORASSIGN || optype == OP_DORASSIGN) {
4135             return newLOGOP(optype, 0,
4136                 mod(scalar(left), optype),
4137                 newUNOP(OP_SASSIGN, 0, scalar(right)));
4138         }
4139         else {
4140             return newBINOP(optype, OPf_STACKED,
4141                 mod(scalar(left), optype), scalar(right));
4142         }
4143     }
4144
4145     if (is_list_assignment(left)) {
4146         static const char no_list_state[] = "Initialization of state variables"
4147             " in list context currently forbidden";
4148         OP *curop;
4149         bool maybe_common_vars = TRUE;
4150
4151         PL_modcount = 0;
4152         /* Grandfathering $[ assignment here.  Bletch.*/
4153         /* Only simple assignments like C<< ($[) = 1 >> are allowed */
4154         PL_eval_start = (left->op_type == OP_CONST) ? right : NULL;
4155         left = mod(left, OP_AASSIGN);
4156         if (PL_eval_start)
4157             PL_eval_start = 0;
4158         else if (left->op_type == OP_CONST) {
4159             /* FIXME for MAD */
4160             /* Result of assignment is always 1 (or we'd be dead already) */
4161             return newSVOP(OP_CONST, 0, newSViv(1));
4162         }
4163         curop = list(force_list(left));
4164         o = newBINOP(OP_AASSIGN, flags, list(force_list(right)), curop);
4165         o->op_private = (U8)(0 | (flags >> 8));
4166
4167         if ((left->op_type == OP_LIST
4168              || (left->op_type == OP_NULL && left->op_targ == OP_LIST)))
4169         {
4170             OP* lop = ((LISTOP*)left)->op_first;
4171             maybe_common_vars = FALSE;
4172             while (lop) {
4173                 if (lop->op_type == OP_PADSV ||
4174                     lop->op_type == OP_PADAV ||
4175                     lop->op_type == OP_PADHV ||
4176                     lop->op_type == OP_PADANY) {
4177                     if (!(lop->op_private & OPpLVAL_INTRO))
4178                         maybe_common_vars = TRUE;
4179
4180                     if (lop->op_private & OPpPAD_STATE) {
4181                         if (left->op_private & OPpLVAL_INTRO) {
4182                             /* Each variable in state($a, $b, $c) = ... */
4183                         }
4184                         else {
4185                             /* Each state variable in
4186                                (state $a, my $b, our $c, $d, undef) = ... */
4187                         }
4188                         yyerror(no_list_state);
4189                     } else {
4190                         /* Each my variable in
4191                            (state $a, my $b, our $c, $d, undef) = ... */
4192                     }
4193                 } else if (lop->op_type == OP_UNDEF ||
4194                            lop->op_type == OP_PUSHMARK) {
4195                     /* undef may be interesting in
4196                        (state $a, undef, state $c) */
4197                 } else {
4198                     /* Other ops in the list. */
4199                     maybe_common_vars = TRUE;
4200                 }
4201                 lop = lop->op_sibling;
4202             }
4203         }
4204         else if ((left->op_private & OPpLVAL_INTRO)
4205                 && (   left->op_type == OP_PADSV
4206                     || left->op_type == OP_PADAV
4207                     || left->op_type == OP_PADHV
4208                     || left->op_type == OP_PADANY))
4209         {
4210             maybe_common_vars = FALSE;
4211             if (left->op_private & OPpPAD_STATE) {
4212                 /* All single variable list context state assignments, hence
4213                    state ($a) = ...
4214                    (state $a) = ...
4215                    state @a = ...
4216                    state (@a) = ...
4217                    (state @a) = ...
4218                    state %a = ...
4219                    state (%a) = ...
4220                    (state %a) = ...
4221                 */
4222                 yyerror(no_list_state);
4223             }
4224         }
4225
4226         /* PL_generation sorcery:
4227          * an assignment like ($a,$b) = ($c,$d) is easier than
4228          * ($a,$b) = ($c,$a), since there is no need for temporary vars.
4229          * To detect whether there are common vars, the global var
4230          * PL_generation is incremented for each assign op we compile.
4231          * Then, while compiling the assign op, we run through all the
4232          * variables on both sides of the assignment, setting a spare slot
4233          * in each of them to PL_generation. If any of them already have
4234          * that value, we know we've got commonality.  We could use a
4235          * single bit marker, but then we'd have to make 2 passes, first
4236          * to clear the flag, then to test and set it.  To find somewhere
4237          * to store these values, evil chicanery is done with SvUVX().
4238          */
4239
4240         if (maybe_common_vars) {
4241             OP *lastop = o;
4242             PL_generation++;
4243             for (curop = LINKLIST(o); curop != o; curop = LINKLIST(curop)) {
4244                 if (PL_opargs[curop->op_type] & OA_DANGEROUS) {
4245                     if (curop->op_type == OP_GV) {
4246                         GV *gv = cGVOPx_gv(curop);
4247                         if (gv == PL_defgv
4248                             || (int)GvASSIGN_GENERATION(gv) == PL_generation)
4249                             break;
4250                         GvASSIGN_GENERATION_set(gv, PL_generation);
4251                     }
4252                     else if (curop->op_type == OP_PADSV ||
4253                              curop->op_type == OP_PADAV ||
4254                              curop->op_type == OP_PADHV ||
4255                              curop->op_type == OP_PADANY)
4256                     {
4257                         if (PAD_COMPNAME_GEN(curop->op_targ)
4258                                                     == (STRLEN)PL_generation)
4259                             break;
4260                         PAD_COMPNAME_GEN_set(curop->op_targ, PL_generation);
4261
4262                     }
4263                     else if (curop->op_type == OP_RV2CV)
4264                         break;
4265                     else if (curop->op_type == OP_RV2SV ||
4266                              curop->op_type == OP_RV2AV ||
4267                              curop->op_type == OP_RV2HV ||
4268                              curop->op_type == OP_RV2GV) {
4269                         if (lastop->op_type != OP_GV)   /* funny deref? */
4270                             break;
4271                     }
4272                     else if (curop->op_type == OP_PUSHRE) {
4273 #ifdef USE_ITHREADS
4274                         if (((PMOP*)curop)->op_pmreplrootu.op_pmtargetoff) {
4275                             GV *const gv = MUTABLE_GV(PAD_SVl(((PMOP*)curop)->op_pmreplrootu.op_pmtargetoff));
4276                             if (gv == PL_defgv
4277                                 || (int)GvASSIGN_GENERATION(gv) == PL_generation)
4278                                 break;
4279                             GvASSIGN_GENERATION_set(gv, PL_generation);
4280                         }
4281 #else
4282                         GV *const gv
4283                             = ((PMOP*)curop)->op_pmreplrootu.op_pmtargetgv;
4284                         if (gv) {
4285                             if (gv == PL_defgv
4286                                 || (int)GvASSIGN_GENERATION(gv) == PL_generation)
4287                                 break;
4288                             GvASSIGN_GENERATION_set(gv, PL_generation);
4289                         }
4290 #endif
4291                     }
4292                     else
4293                         break;
4294                 }
4295                 lastop = curop;
4296             }
4297             if (curop != o)
4298                 o->op_private |= OPpASSIGN_COMMON;
4299         }
4300
4301         if (right && right->op_type == OP_SPLIT && !PL_madskills) {
4302             OP* tmpop = ((LISTOP*)right)->op_first;
4303             if (tmpop && (tmpop->op_type == OP_PUSHRE)) {
4304                 PMOP * const pm = (PMOP*)tmpop;
4305                 if (left->op_type == OP_RV2AV &&
4306                     !(left->op_private & OPpLVAL_INTRO) &&
4307                     !(o->op_private & OPpASSIGN_COMMON) )
4308                 {
4309                     tmpop = ((UNOP*)left)->op_first;
4310                     if (tmpop->op_type == OP_GV
4311 #ifdef USE_ITHREADS
4312                         && !pm->op_pmreplrootu.op_pmtargetoff
4313 #else
4314                         && !pm->op_pmreplrootu.op_pmtargetgv
4315 #endif
4316                         ) {
4317 #ifdef USE_ITHREADS
4318                         pm->op_pmreplrootu.op_pmtargetoff
4319                             = cPADOPx(tmpop)->op_padix;
4320                         cPADOPx(tmpop)->op_padix = 0;   /* steal it */
4321 #else
4322                         pm->op_pmreplrootu.op_pmtargetgv
4323                             = MUTABLE_GV(cSVOPx(tmpop)->op_sv);
4324                         cSVOPx(tmpop)->op_sv = NULL;    /* steal it */
4325 #endif
4326                         pm->op_pmflags |= PMf_ONCE;
4327                         tmpop = cUNOPo->op_first;       /* to list (nulled) */
4328                         tmpop = ((UNOP*)tmpop)->op_first; /* to pushmark */
4329                         tmpop->op_sibling = NULL;       /* don't free split */
4330                         right->op_next = tmpop->op_next;  /* fix starting loc */
4331                         op_free(o);                     /* blow off assign */
4332                         right->op_flags &= ~OPf_WANT;
4333                                 /* "I don't know and I don't care." */
4334                         return right;
4335                     }
4336                 }
4337                 else {
4338                    if (PL_modcount < RETURN_UNLIMITED_NUMBER &&
4339                       ((LISTOP*)right)->op_last->op_type == OP_CONST)
4340                     {
4341                         SV *sv = ((SVOP*)((LISTOP*)right)->op_last)->op_sv;
4342                         if (SvIOK(sv) && SvIVX(sv) == 0)
4343                             sv_setiv(sv, PL_modcount+1);
4344                     }
4345                 }
4346             }
4347         }
4348         return o;
4349     }
4350     if (!right)
4351         right = newOP(OP_UNDEF, 0);
4352     if (right->op_type == OP_READLINE) {
4353         right->op_flags |= OPf_STACKED;
4354         return newBINOP(OP_NULL, flags, mod(scalar(left), OP_SASSIGN), scalar(right));
4355     }
4356     else {
4357         PL_eval_start = right;  /* Grandfathering $[ assignment here.  Bletch.*/
4358         o = newBINOP(OP_SASSIGN, flags,
4359             scalar(right), mod(scalar(left), OP_SASSIGN) );
4360         if (PL_eval_start)
4361             PL_eval_start = 0;
4362         else {
4363             if (!PL_madskills) { /* assignment to $[ is ignored when making a mad dump */
4364                 deprecate("assignment to $[");
4365                 op_free(o);
4366                 o = newSVOP(OP_CONST, 0, newSViv(CopARYBASE_get(&PL_compiling)));
4367                 o->op_private |= OPpCONST_ARYBASE;
4368             }
4369         }
4370     }
4371     return o;
4372 }
4373
4374 OP *
4375 Perl_newSTATEOP(pTHX_ I32 flags, char *label, OP *o)
4376 {
4377     dVAR;
4378     const U32 seq = intro_my();
4379     register COP *cop;
4380
4381     NewOp(1101, cop, 1, COP);
4382     if (PERLDB_LINE && CopLINE(PL_curcop) && PL_curstash != PL_debstash) {
4383         cop->op_type = OP_DBSTATE;
4384         cop->op_ppaddr = PL_ppaddr[ OP_DBSTATE ];
4385     }
4386     else {
4387         cop->op_type = OP_NEXTSTATE;
4388         cop->op_ppaddr = PL_ppaddr[ OP_NEXTSTATE ];
4389     }
4390     cop->op_flags = (U8)flags;
4391     CopHINTS_set(cop, PL_hints);
4392 #ifdef NATIVE_HINTS
4393     cop->op_private |= NATIVE_HINTS;
4394 #endif
4395     CopHINTS_set(&PL_compiling, CopHINTS_get(cop));
4396     cop->op_next = (OP*)cop;
4397
4398     cop->cop_seq = seq;
4399     /* CopARYBASE is now "virtual", in that it's stored as a flag bit in
4400        CopHINTS and a possible value in cop_hints_hash, so no need to copy it.
4401     */
4402     cop->cop_warnings = DUP_WARNINGS(PL_curcop->cop_warnings);
4403     cop->cop_hints_hash = PL_curcop->cop_hints_hash;
4404     if (cop->cop_hints_hash) {
4405         HINTS_REFCNT_LOCK;
4406         cop->cop_hints_hash->refcounted_he_refcnt++;
4407         HINTS_REFCNT_UNLOCK;
4408     }
4409     if (label) {
4410         cop->cop_hints_hash
4411             = Perl_store_cop_label(aTHX_ cop->cop_hints_hash, label);
4412                                                      
4413         PL_hints |= HINT_BLOCK_SCOPE;
4414         /* It seems that we need to defer freeing this pointer, as other parts
4415            of the grammar end up wanting to copy it after this op has been
4416            created. */
4417         SAVEFREEPV(label);
4418     }
4419
4420     if (PL_parser && PL_parser->copline == NOLINE)
4421         CopLINE_set(cop, CopLINE(PL_curcop));
4422     else {
4423         CopLINE_set(cop, PL_parser->copline);
4424         if (PL_parser)
4425             PL_parser->copline = NOLINE;
4426     }
4427 #ifdef USE_ITHREADS
4428     CopFILE_set(cop, CopFILE(PL_curcop));       /* XXX share in a pvtable? */
4429 #else
4430     CopFILEGV_set(cop, CopFILEGV(PL_curcop));
4431 #endif
4432     CopSTASH_set(cop, PL_curstash);
4433
4434     if ((PERLDB_LINE || PERLDB_SAVESRC) && PL_curstash != PL_debstash) {
4435         /* this line can have a breakpoint - store the cop in IV */
4436         AV *av = CopFILEAVx(PL_curcop);
4437         if (av) {
4438             SV * const * const svp = av_fetch(av, (I32)CopLINE(cop), FALSE);
4439             if (svp && *svp != &PL_sv_undef ) {
4440                 (void)SvIOK_on(*svp);
4441                 SvIV_set(*svp, PTR2IV(cop));
4442             }
4443         }
4444     }
4445
4446     if (flags & OPf_SPECIAL)
4447         op_null((OP*)cop);
4448     return prepend_elem(OP_LINESEQ, (OP*)cop, o);
4449 }
4450
4451
4452 OP *
4453 Perl_newLOGOP(pTHX_ I32 type, I32 flags, OP *first, OP *other)
4454 {
4455     dVAR;
4456
4457     PERL_ARGS_ASSERT_NEWLOGOP;
4458
4459     return new_logop(type, flags, &first, &other);
4460 }
4461
4462 STATIC OP *
4463 S_search_const(pTHX_ OP *o)
4464 {
4465     PERL_ARGS_ASSERT_SEARCH_CONST;
4466
4467     switch (o->op_type) {
4468         case OP_CONST:
4469             return o;
4470         case OP_NULL:
4471             if (o->op_flags & OPf_KIDS)
4472                 return search_const(cUNOPo->op_first);
4473             break;
4474         case OP_LEAVE:
4475         case OP_SCOPE:
4476         case OP_LINESEQ:
4477         {
4478             OP *kid;
4479             if (!(o->op_flags & OPf_KIDS))
4480                 return NULL;
4481             kid = cLISTOPo->op_first;
4482             do {
4483                 switch (kid->op_type) {
4484                     case OP_ENTER:
4485                     case OP_NULL:
4486                     case OP_NEXTSTATE:
4487                         kid = kid->op_sibling;
4488                         break;
4489                     default:
4490                         if (kid != cLISTOPo->op_last)
4491                             return NULL;
4492                         goto last;
4493                 }
4494             } while (kid);
4495             if (!kid)
4496                 kid = cLISTOPo->op_last;
4497 last:
4498             return search_const(kid);
4499         }
4500     }
4501
4502     return NULL;
4503 }
4504
4505 STATIC OP *
4506 S_new_logop(pTHX_ I32 type, I32 flags, OP** firstp, OP** otherp)
4507 {
4508     dVAR;
4509     LOGOP *logop;
4510     OP *o;
4511     OP *first;
4512     OP *other;
4513     OP *cstop = NULL;
4514     int prepend_not = 0;
4515
4516     PERL_ARGS_ASSERT_NEW_LOGOP;
4517
4518     first = *firstp;
4519     other = *otherp;
4520
4521     if (type == OP_XOR)         /* Not short circuit, but here by precedence. */
4522         return newBINOP(type, flags, scalar(first), scalar(other));
4523
4524     scalarboolean(first);
4525     /* optimize AND and OR ops that have NOTs as children */
4526     if (first->op_type == OP_NOT
4527         && (first->op_flags & OPf_KIDS)
4528         && ((first->op_flags & OPf_SPECIAL) /* unless ($x) { } */
4529             || (other->op_type == OP_NOT))  /* if (!$x && !$y) { } */
4530         && !PL_madskills) {
4531         if (type == OP_AND || type == OP_OR) {
4532             if (type == OP_AND)
4533                 type = OP_OR;
4534             else
4535                 type = OP_AND;
4536             op_null(first);
4537             if (other->op_type == OP_NOT) { /* !a AND|OR !b => !(a OR|AND b) */
4538                 op_null(other);
4539                 prepend_not = 1; /* prepend a NOT op later */
4540             }
4541         }
4542     }
4543     /* search for a constant op that could let us fold the test */
4544     if ((cstop = search_const(first))) {
4545         if (cstop->op_private & OPpCONST_STRICT)
4546             no_bareword_allowed(cstop);
4547         else if ((cstop->op_private & OPpCONST_BARE))
4548                 Perl_ck_warner(aTHX_ packWARN(WARN_BAREWORD), "Bareword found in conditional");
4549         if ((type == OP_AND &&  SvTRUE(((SVOP*)cstop)->op_sv)) ||
4550             (type == OP_OR  && !SvTRUE(((SVOP*)cstop)->op_sv)) ||
4551             (type == OP_DOR && !SvOK(((SVOP*)cstop)->op_sv))) {
4552             *firstp = NULL;
4553             if (other->op_type == OP_CONST)
4554                 other->op_private |= OPpCONST_SHORTCIRCUIT;
4555             if (PL_madskills) {
4556                 OP *newop = newUNOP(OP_NULL, 0, other);
4557                 op_getmad(first, newop, '1');
4558                 newop->op_targ = type;  /* set "was" field */
4559                 return newop;
4560             }
4561             op_free(first);
4562             if (other->op_type == OP_LEAVE)
4563                 other = newUNOP(OP_NULL, OPf_SPECIAL, other);
4564             return other;
4565         }
4566         else {
4567             /* check for C<my $x if 0>, or C<my($x,$y) if 0> */
4568             const OP *o2 = other;
4569             if ( ! (o2->op_type == OP_LIST
4570                     && (( o2 = cUNOPx(o2)->op_first))
4571                     && o2->op_type == OP_PUSHMARK
4572                     && (( o2 = o2->op_sibling)) )
4573             )
4574                 o2 = other;
4575             if ((o2->op_type == OP_PADSV || o2->op_type == OP_PADAV
4576                         || o2->op_type == OP_PADHV)
4577                 && o2->op_private & OPpLVAL_INTRO
4578                 && !(o2->op_private & OPpPAD_STATE))
4579             {
4580                 Perl_ck_warner_d(aTHX_ packWARN(WARN_DEPRECATED),
4581                                  "Deprecated use of my() in false conditional");
4582             }
4583
4584             *otherp = NULL;
4585             if (first->op_type == OP_CONST)
4586                 first->op_private |= OPpCONST_SHORTCIRCUIT;
4587             if (PL_madskills) {
4588                 first = newUNOP(OP_NULL, 0, first);
4589                 op_getmad(other, first, '2');
4590                 first->op_targ = type;  /* set "was" field */
4591             }
4592             else
4593                 op_free(other);
4594             return first;
4595         }
4596     }
4597     else if ((first->op_flags & OPf_KIDS) && type != OP_DOR
4598         && ckWARN(WARN_MISC)) /* [#24076] Don't warn for <FH> err FOO. */
4599     {
4600         const OP * const k1 = ((UNOP*)first)->op_first;
4601         const OP * const k2 = k1->op_sibling;
4602         OPCODE warnop = 0;
4603         switch (first->op_type)
4604         {
4605         case OP_NULL:
4606             if (k2 && k2->op_type == OP_READLINE
4607                   && (k2->op_flags & OPf_STACKED)
4608                   && ((k1->op_flags & OPf_WANT) == OPf_WANT_SCALAR))
4609             {
4610                 warnop = k2->op_type;
4611             }
4612             break;
4613
4614         case OP_SASSIGN:
4615             if (k1->op_type == OP_READDIR
4616                   || k1->op_type == OP_GLOB
4617                   || (k1->op_type == OP_NULL && k1->op_targ == OP_GLOB)
4618                   || k1->op_type == OP_EACH)
4619             {
4620                 warnop = ((k1->op_type == OP_NULL)
4621                           ? (OPCODE)k1->op_targ : k1->op_type);
4622             }
4623             break;
4624         }
4625         if (warnop) {
4626             const line_t oldline = CopLINE(PL_curcop);
4627             CopLINE_set(PL_curcop, PL_parser->copline);
4628             Perl_warner(aTHX_ packWARN(WARN_MISC),
4629                  "Value of %s%s can be \"0\"; test with defined()",
4630                  PL_op_desc[warnop],
4631                  ((warnop == OP_READLINE || warnop == OP_GLOB)
4632                   ? " construct" : "() operator"));
4633             CopLINE_set(PL_curcop, oldline);
4634         }
4635     }
4636
4637     if (!other)
4638         return first;
4639
4640     if (type == OP_ANDASSIGN || type == OP_ORASSIGN || type == OP_DORASSIGN)
4641         other->op_private |= OPpASSIGN_BACKWARDS;  /* other is an OP_SASSIGN */
4642
4643     NewOp(1101, logop, 1, LOGOP);
4644
4645     logop->op_type = (OPCODE)type;
4646     logop->op_ppaddr = PL_ppaddr[type];
4647     logop->op_first = first;
4648     logop->op_flags = (U8)(flags | OPf_KIDS);
4649     logop->op_other = LINKLIST(other);
4650     logop->op_private = (U8)(1 | (flags >> 8));
4651
4652     /* establish postfix order */
4653     logop->op_next = LINKLIST(first);
4654     first->op_next = (OP*)logop;
4655     first->op_sibling = other;
4656
4657     CHECKOP(type,logop);
4658
4659     o = newUNOP(prepend_not ? OP_NOT : OP_NULL, 0, (OP*)logop);
4660     other->op_next = o;
4661
4662     return o;
4663 }
4664
4665 OP *
4666 Perl_newCONDOP(pTHX_ I32 flags, OP *first, OP *trueop, OP *falseop)
4667 {
4668     dVAR;
4669     LOGOP *logop;
4670     OP *start;
4671     OP *o;
4672     OP *cstop;
4673
4674     PERL_ARGS_ASSERT_NEWCONDOP;
4675
4676     if (!falseop)
4677         return newLOGOP(OP_AND, 0, first, trueop);
4678     if (!trueop)
4679         return newLOGOP(OP_OR, 0, first, falseop);
4680
4681     scalarboolean(first);
4682     if ((cstop = search_const(first))) {
4683         /* Left or right arm of the conditional?  */
4684         const bool left = SvTRUE(((SVOP*)cstop)->op_sv);
4685         OP *live = left ? trueop : falseop;
4686         OP *const dead = left ? falseop : trueop;
4687         if (cstop->op_private & OPpCONST_BARE &&
4688             cstop->op_private & OPpCONST_STRICT) {
4689             no_bareword_allowed(cstop);
4690         }
4691         if (PL_madskills) {
4692             /* This is all dead code when PERL_MAD is not defined.  */
4693             live = newUNOP(OP_NULL, 0, live);
4694             op_getmad(first, live, 'C');
4695             op_getmad(dead, live, left ? 'e' : 't');
4696         } else {
4697             op_free(first);
4698             op_free(dead);
4699         }
4700         if (live->op_type == OP_LEAVE)
4701             live = newUNOP(OP_NULL, OPf_SPECIAL, live);
4702         return live;
4703     }
4704     NewOp(1101, logop, 1, LOGOP);
4705     logop->op_type = OP_COND_EXPR;
4706     logop->op_ppaddr = PL_ppaddr[OP_COND_EXPR];
4707     logop->op_first = first;
4708     logop->op_flags = (U8)(flags | OPf_KIDS);
4709     logop->op_private = (U8)(1 | (flags >> 8));
4710     logop->op_other = LINKLIST(trueop);
4711     logop->op_next = LINKLIST(falseop);
4712
4713     CHECKOP(OP_COND_EXPR, /* that's logop->op_type */
4714             logop);
4715
4716     /* establish postfix order */
4717     start = LINKLIST(first);
4718     first->op_next = (OP*)logop;
4719
4720     first->op_sibling = trueop;
4721     trueop->op_sibling = falseop;
4722     o = newUNOP(OP_NULL, 0, (OP*)logop);
4723
4724     trueop->op_next = falseop->op_next = o;
4725
4726     o->op_next = start;
4727     return o;
4728 }
4729
4730 OP *
4731 Perl_newRANGE(pTHX_ I32 flags, OP *left, OP *right)
4732 {
4733     dVAR;
4734     LOGOP *range;
4735     OP *flip;
4736     OP *flop;
4737     OP *leftstart;
4738     OP *o;
4739
4740     PERL_ARGS_ASSERT_NEWRANGE;
4741
4742     NewOp(1101, range, 1, LOGOP);
4743
4744     range->op_type = OP_RANGE;
4745     range->op_ppaddr = PL_ppaddr[OP_RANGE];
4746     range->op_first = left;
4747     range->op_flags = OPf_KIDS;
4748     leftstart = LINKLIST(left);
4749     range->op_other = LINKLIST(right);
4750     range->op_private = (U8)(1 | (flags >> 8));
4751
4752     left->op_sibling = right;
4753
4754     range->op_next = (OP*)range;
4755     flip = newUNOP(OP_FLIP, flags, (OP*)range);
4756     flop = newUNOP(OP_FLOP, 0, flip);
4757     o = newUNOP(OP_NULL, 0, flop);
4758     linklist(flop);
4759     range->op_next = leftstart;
4760
4761     left->op_next = flip;
4762     right->op_next = flop;
4763
4764     range->op_targ = pad_alloc(OP_RANGE, SVs_PADMY);
4765     sv_upgrade(PAD_SV(range->op_targ), SVt_PVNV);
4766     flip->op_targ = pad_alloc(OP_RANGE, SVs_PADMY);
4767     sv_upgrade(PAD_SV(flip->op_targ), SVt_PVNV);
4768
4769     flip->op_private =  left->op_type == OP_CONST ? OPpFLIP_LINENUM : 0;
4770     flop->op_private = right->op_type == OP_CONST ? OPpFLIP_LINENUM : 0;
4771
4772     flip->op_next = o;
4773     if (!flip->op_private || !flop->op_private)
4774         linklist(o);            /* blow off optimizer unless constant */
4775
4776     return o;
4777 }
4778
4779 OP *
4780 Perl_newLOOPOP(pTHX_ I32 flags, I32 debuggable, OP *expr, OP *block)
4781 {
4782     dVAR;
4783     OP* listop;
4784     OP* o;
4785     const bool once = block && block->op_flags & OPf_SPECIAL &&
4786       (block->op_type == OP_ENTERSUB || block->op_type == OP_NULL);
4787
4788     PERL_UNUSED_ARG(debuggable);
4789
4790     if (expr) {
4791         if (once && expr->op_type == OP_CONST && !SvTRUE(((SVOP*)expr)->op_sv))
4792             return block;       /* do {} while 0 does once */
4793         if (expr->op_type == OP_READLINE
4794             || expr->op_type == OP_READDIR
4795             || expr->op_type == OP_GLOB
4796             || (expr->op_type == OP_NULL && expr->op_targ == OP_GLOB)) {
4797             expr = newUNOP(OP_DEFINED, 0,
4798                 newASSIGNOP(0, newDEFSVOP(), 0, expr) );
4799         } else if (expr->op_flags & OPf_KIDS) {
4800             const OP * const k1 = ((UNOP*)expr)->op_first;
4801             const OP * const k2 = k1 ? k1->op_sibling : NULL;
4802             switch (expr->op_type) {
4803               case OP_NULL:
4804                 if (k2 && (k2->op_type == OP_READLINE || k2->op_type == OP_READDIR)
4805                       && (k2->op_flags & OPf_STACKED)
4806                       && ((k1->op_flags & OPf_WANT) == OPf_WANT_SCALAR))
4807                     expr = newUNOP(OP_DEFINED, 0, expr);
4808                 break;
4809
4810               case OP_SASSIGN:
4811                 if (k1 && (k1->op_type == OP_READDIR
4812                       || k1->op_type == OP_GLOB
4813                       || (k1->op_type == OP_NULL && k1->op_targ == OP_GLOB)
4814                       || k1->op_type == OP_EACH))
4815                     expr = newUNOP(OP_DEFINED, 0, expr);
4816                 break;
4817             }
4818         }
4819     }
4820
4821     /* if block is null, the next append_elem() would put UNSTACK, a scalar
4822      * op, in listop. This is wrong. [perl #27024] */
4823     if (!block)
4824         block = newOP(OP_NULL, 0);
4825     listop = append_elem(OP_LINESEQ, block, newOP(OP_UNSTACK, 0));
4826     o = new_logop(OP_AND, 0, &expr, &listop);
4827
4828     if (listop)
4829         ((LISTOP*)listop)->op_last->op_nex