op.c

   1 #line 2 "op.c"
   2 /*    op.c
   3  *
   4  *    Copyright (C) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
   5  *    2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 by Larry Wall and others
   6  *
   7  *    You may distribute under the terms of either the GNU General Public
   8  *    License or the Artistic License, as specified in the README file.
   9  *
  10  */
  11
  12 /*
  13  * 'You see: Mr. Drogo, he married poor Miss Primula Brandybuck.  She was
  14  *  our Mr. Bilbo's first cousin on the mother's side (her mother being the
  15  *  youngest of the Old Took's daughters); and Mr. Drogo was his second
  16  *  cousin.  So Mr. Frodo is his first *and* second cousin, once removed
  17  *  either way, as the saying is, if you follow me.'       --the Gaffer
  18  *
  19  *     [p.23 of _The Lord of the Rings_, I/i: "A Long-Expected Party"]
  20  */
  21
  22 /* This file contains the functions that create, manipulate and optimize
  23  * the OP structures that hold a compiled perl program.
  24  *
  25  * A Perl program is compiled into a tree of OPs. Each op contains
  26  * structural pointers (eg to its siblings and the next op in the
  27  * execution sequence), a pointer to the function that would execute the
  28  * op, plus any data specific to that op. For example, an OP_CONST op
  29  * points to the pp_const() function and to an SV containing the constant
  30  * value. When pp_const() is executed, its job is to push that SV onto the
  31  * stack.
  32  *
  33  * OPs are mainly created by the newFOO() functions, which are mainly
  34  * called from the parser (in perly.y) as the code is parsed. For example
  35  * the Perl code $a + $b * $c would cause the equivalent of the following
  36  * to be called (oversimplifying a bit):
  37  *
  38  *  newBINOP(OP_ADD, flags,
  39  *      newSVREF($a),
  40  *      newBINOP(OP_MULTIPLY, flags, newSVREF($b), newSVREF($c))
  41  *  )
  42  *
  43  * Note that during the build of miniperl, a temporary copy of this file
  44  * is made, called opmini.c.
  45  */
  46
  47 /*
  48 Perl's compiler is essentially a 3-pass compiler with interleaved phases:
  49
  50     A bottom-up pass
  51     A top-down pass
  52     An execution-order pass
  53
  54 The bottom-up pass is represented by all the "newOP" routines and
  55 the ck_ routines.  The bottom-upness is actually driven by yacc.
  56 So at the point that a ck_ routine fires, we have no idea what the
  57 context is, either upward in the syntax tree, or either forward or
  58 backward in the execution order.  (The bottom-up parser builds that
  59 part of the execution order it knows about, but if you follow the "next"
  60 links around, you'll find it's actually a closed loop through the
  61 top level node.)
  62
  63 Whenever the bottom-up parser gets to a node that supplies context to
  64 its components, it invokes that portion of the top-down pass that applies
  65 to that part of the subtree (and marks the top node as processed, so
  66 if a node further up supplies context, it doesn't have to take the
  67 plunge again).  As a particular subcase of this, as the new node is
  68 built, it takes all the closed execution loops of its subcomponents
  69 and links them into a new closed loop for the higher level node.  But
  70 it's still not the real execution order.
  71
  72 The actual execution order is not known till we get a grammar reduction
  73 to a top-level unit like a subroutine or file that will be called by
  74 "name" rather than via a "next" pointer.  At that point, we can call
  75 into peep() to do that code's portion of the 3rd pass.  It has to be
  76 recursive, but it's recursive on basic blocks, not on tree nodes.
  77 */
  78
  79 /* To implement user lexical pragmas, there needs to be a way at run time to
  80    get the compile time state of %^H for that block.  Storing %^H in every
  81    block (or even COP) would be very expensive, so a different approach is
  82    taken.  The (running) state of %^H is serialised into a tree of HE-like
  83    structs.  Stores into %^H are chained onto the current leaf as a struct
  84    refcounted_he * with the key and the value.  Deletes from %^H are saved
  85    with a value of PL_sv_placeholder.  The state of %^H at any point can be
  86    turned back into a regular HV by walking back up the tree from that point's
  87    leaf, ignoring any key you've already seen (placeholder or not), storing
  88    the rest into the HV structure, then removing the placeholders. Hence
  89    memory is only used to store the %^H deltas from the enclosing COP, rather
  90    than the entire %^H on each COP.
  91
  92    To cause actions on %^H to write out the serialisation records, it has
  93    magic type 'H'. This magic (itself) does nothing, but its presence causes
  94    the values to gain magic type 'h', which has entries for set and clear.
  95    C<Perl_magic_sethint> updates C<PL_compiling.cop_hints_hash> with a store
  96    record, with deletes written by C<Perl_magic_clearhint>. C<SAVEHINTS>
  97    saves the current C<PL_compiling.cop_hints_hash> on the save stack, so that
  98    it will be correctly restored when any inner compiling scope is exited.
  99 */
 100
 101 #include "EXTERN.h"
 102 #define PERL_IN_OP_C
 103 #include "perl.h"
 104 #include "keywords.h"
 105 #include "feature.h"
 106 #include "regcomp.h"
 107
 108 #define CALL_PEEP(o) PL_peepp(aTHX_ o)
 109 #define CALL_RPEEP(o) PL_rpeepp(aTHX_ o)
 110 #define CALL_OPFREEHOOK(o) if (PL_opfreehook) PL_opfreehook(aTHX_ o)
 111
 112 /* See the explanatory comments above struct opslab in op.h. */
 113
 114 #ifdef PERL_DEBUG_READONLY_OPS
 115 #  define PERL_SLAB_SIZE 128
 116 #  define PERL_MAX_SLAB_SIZE 4096
 117 #  include <sys/mman.h>
 118 #endif
 119
 120 #ifndef PERL_SLAB_SIZE
 121 #  define PERL_SLAB_SIZE 64
 122 #endif
 123 #ifndef PERL_MAX_SLAB_SIZE
 124 #  define PERL_MAX_SLAB_SIZE 2048
 125 #endif
 126
 127 /* rounds up to nearest pointer */
 128 #define SIZE_TO_PSIZE(x)        (((x) + sizeof(I32 *) - 1)/sizeof(I32 *))
 129 #define DIFF(o,p)               ((size_t)((I32 **)(p) - (I32**)(o)))
 130
 131 static OPSLAB *
 132 S_new_slab(pTHX_ size_t sz)
 133 {
 134 #ifdef PERL_DEBUG_READONLY_OPS
 135     OPSLAB *slab = (OPSLAB *) mmap(0, sz * sizeof(I32 *),
 136                                    PROT_READ|PROT_WRITE,
 137                                    MAP_ANON|MAP_PRIVATE, -1, 0);
 138     DEBUG_m(PerlIO_printf(Perl_debug_log, "mapped %lu at %p\n",
 139                           (unsigned long) sz, slab));
 140     if (slab == MAP_FAILED) {
 141         perror("mmap failed");
 142         abort();
 143     }
 144     slab->opslab_size = (U16)sz;
 145 #else
 146     OPSLAB *slab = (OPSLAB *)PerlMemShared_calloc(sz, sizeof(I32 *));
 147 #endif
 148     slab->opslab_first = (OPSLOT *)((I32 **)slab + sz - 1);
 149     return slab;
 150 }
 151
 152 /* requires double parens and aTHX_ */
 153 #define DEBUG_S_warn(args)                                             \
 154     DEBUG_S(                                                            \
 155         PerlIO_printf(Perl_debug_log, "%s", SvPVx_nolen(Perl_mess args)) \
 156     )
 157
 158 void *
 159 Perl_Slab_Alloc(pTHX_ size_t sz)
 160 {
 161     dVAR;
 162     OPSLAB *slab;
 163     OPSLAB *slab2;
 164     OPSLOT *slot;
 165     OP *o;
 166     size_t opsz, space;
 167
 168     if (!PL_compcv || CvROOT(PL_compcv)
 169      || (CvSTART(PL_compcv) && !CvSLABBED(PL_compcv)))
 170         return PerlMemShared_calloc(1, sz);
 171
 172     if (!CvSTART(PL_compcv)) { /* sneak it in here */
 173         CvSTART(PL_compcv) =
 174             (OP *)(slab = S_new_slab(aTHX_ PERL_SLAB_SIZE));
 175         CvSLABBED_on(PL_compcv);
 176         slab->opslab_refcnt = 2; /* one for the CV; one for the new OP */
 177     }
 178     else ++(slab = (OPSLAB *)CvSTART(PL_compcv))->opslab_refcnt;
 179
 180     opsz = SIZE_TO_PSIZE(sz);
 181     sz = opsz + OPSLOT_HEADER_P;
 182
 183     if (slab->opslab_freed) {
 184         OP **too = &slab->opslab_freed;
 185         o = *too;
 186         DEBUG_S_warn((aTHX_ "found free op at %p, slab %p", o, slab));
 187         while (o && DIFF(OpSLOT(o), OpSLOT(o)->opslot_next) < sz) {
 188             DEBUG_S_warn((aTHX_ "Alas! too small"));
 189             o = *(too = &o->op_next);
 190             if (o) { DEBUG_S_warn((aTHX_ "found another free op at %p", o)); }
 191         }
 192         if (o) {
 193             *too = o->op_next;
 194             Zero(o, opsz, I32 *);
 195             o->op_slabbed = 1;
 196             return (void *)o;
 197         }
 198     }
 199
 200 #define INIT_OPSLOT \
 201             slot->opslot_slab = slab;                   \
 202             slot->opslot_next = slab2->opslab_first;    \
 203             slab2->opslab_first = slot;                 \
 204             o = &slot->opslot_op;                       \
 205             o->op_slabbed = 1
 206
 207     /* The partially-filled slab is next in the chain. */
 208     slab2 = slab->opslab_next ? slab->opslab_next : slab;
 209     if ((space = DIFF(&slab2->opslab_slots, slab2->opslab_first)) < sz) {
 210         /* Remaining space is too small. */
 211
 212         /* If we can fit a BASEOP, add it to the free chain, so as not
 213            to waste it. */
 214         if (space >= SIZE_TO_PSIZE(sizeof(OP)) + OPSLOT_HEADER_P) {
 215             slot = &slab2->opslab_slots;
 216             INIT_OPSLOT;
 217             o->op_type = OP_FREED;
 218             o->op_next = slab->opslab_freed;
 219             slab->opslab_freed = o;
 220         }
 221
 222         /* Create a new slab.  Make this one twice as big. */
 223         slot = slab2->opslab_first;
 224         while (slot->opslot_next) slot = slot->opslot_next;
 225         slab2 = S_new_slab(aTHX_
 226                             (DIFF(slab2, slot)+1)*2 > PERL_MAX_SLAB_SIZE
 227                                         ? PERL_MAX_SLAB_SIZE
 228                                         : (DIFF(slab2, slot)+1)*2);
 229         slab2->opslab_next = slab->opslab_next;
 230         slab->opslab_next = slab2;
 231     }
 232     assert(DIFF(&slab2->opslab_slots, slab2->opslab_first) >= sz);
 233
 234     /* Create a new op slot */
 235     slot = (OPSLOT *)((I32 **)slab2->opslab_first - sz);
 236     assert(slot >= &slab2->opslab_slots);
 237     if (DIFF(&slab2->opslab_slots, slot)
 238          < SIZE_TO_PSIZE(sizeof(OP)) + OPSLOT_HEADER_P)
 239         slot = &slab2->opslab_slots;
 240     INIT_OPSLOT;
 241     DEBUG_S_warn((aTHX_ "allocating op at %p, slab %p", o, slab));
 242     return (void *)o;
 243 }
 244
 245 #undef INIT_OPSLOT
 246
 247 #ifdef PERL_DEBUG_READONLY_OPS
 248 void
 249 Perl_Slab_to_ro(pTHX_ OPSLAB *slab)
 250 {
 251     PERL_ARGS_ASSERT_SLAB_TO_RO;
 252
 253     if (slab->opslab_readonly) return;
 254     slab->opslab_readonly = 1;
 255     for (; slab; slab = slab->opslab_next) {
 256         /*DEBUG_U(PerlIO_printf(Perl_debug_log,"mprotect ->ro %lu at %p\n",
 257                               (unsigned long) slab->opslab_size, slab));*/
 258         if (mprotect(slab, slab->opslab_size * sizeof(I32 *), PROT_READ))
 259             Perl_warn(aTHX_ "mprotect for %p %lu failed with %d", slab,
 260                              (unsigned long)slab->opslab_size, errno);
 261     }
 262 }
 263
 264 void
 265 Perl_Slab_to_rw(pTHX_ OPSLAB *const slab)
 266 {
 267     OPSLAB *slab2;
 268
 269     PERL_ARGS_ASSERT_SLAB_TO_RW;
 270
 271     if (!slab->opslab_readonly) return;
 272     slab2 = slab;
 273     for (; slab2; slab2 = slab2->opslab_next) {
 274         /*DEBUG_U(PerlIO_printf(Perl_debug_log,"mprotect ->rw %lu at %p\n",
 275                               (unsigned long) size, slab2));*/
 276         if (mprotect((void *)slab2, slab2->opslab_size * sizeof(I32 *),
 277                      PROT_READ|PROT_WRITE)) {
 278             Perl_warn(aTHX_ "mprotect RW for %p %lu failed with %d", slab,
 279                              (unsigned long)slab2->opslab_size, errno);
 280         }
 281     }
 282     slab->opslab_readonly = 0;
 283 }
 284
 285 #else
 286 #  define Slab_to_rw(op)
 287 #endif
 288
 289 /* This cannot possibly be right, but it was copied from the old slab
 290    allocator, to which it was originally added, without explanation, in
 291    commit 083fcd5. */
 292 #ifdef NETWARE
 293 #    define PerlMemShared PerlMem
 294 #endif
 295
 296 void
 297 Perl_Slab_Free(pTHX_ void *op)
 298 {
 299     dVAR;
 300     OP * const o = (OP *)op;
 301     OPSLAB *slab;
 302
 303     PERL_ARGS_ASSERT_SLAB_FREE;
 304
 305     if (!o->op_slabbed) {
 306         if (!o->op_static)
 307             PerlMemShared_free(op);
 308         return;
 309     }
 310
 311     slab = OpSLAB(o);
 312     /* If this op is already freed, our refcount will get screwy. */
 313     assert(o->op_type != OP_FREED);
 314     o->op_type = OP_FREED;
 315     o->op_next = slab->opslab_freed;
 316     slab->opslab_freed = o;
 317     DEBUG_S_warn((aTHX_ "free op at %p, recorded in slab %p", o, slab));
 318     OpslabREFCNT_dec_padok(slab);
 319 }
 320
 321 void
 322 Perl_opslab_free_nopad(pTHX_ OPSLAB *slab)
 323 {
 324     dVAR;
 325     const bool havepad = !!PL_comppad;
 326     PERL_ARGS_ASSERT_OPSLAB_FREE_NOPAD;
 327     if (havepad) {
 328         ENTER;
 329         PAD_SAVE_SETNULLPAD();
 330     }
 331     opslab_free(slab);
 332     if (havepad) LEAVE;
 333 }
 334
 335 void
 336 Perl_opslab_free(pTHX_ OPSLAB *slab)
 337 {
 338     dVAR;
 339     OPSLAB *slab2;
 340     PERL_ARGS_ASSERT_OPSLAB_FREE;
 341     DEBUG_S_warn((aTHX_ "freeing slab %p", slab));
 342     assert(slab->opslab_refcnt == 1);
 343     for (; slab; slab = slab2) {
 344         slab2 = slab->opslab_next;
 345 #ifdef DEBUGGING
 346         slab->opslab_refcnt = ~(size_t)0;
 347 #endif
 348 #ifdef PERL_DEBUG_READONLY_OPS
 349         DEBUG_m(PerlIO_printf(Perl_debug_log, "Deallocate slab at %p\n",
 350                                                slab));
 351         if (munmap(slab, slab->opslab_size * sizeof(I32 *))) {
 352             perror("munmap failed");
 353             abort();
 354         }
 355 #else
 356         PerlMemShared_free(slab);
 357 #endif
 358     }
 359 }
 360
 361 void
 362 Perl_opslab_force_free(pTHX_ OPSLAB *slab)
 363 {
 364     OPSLAB *slab2;
 365     OPSLOT *slot;
 366 #ifdef DEBUGGING
 367     size_t savestack_count = 0;
 368 #endif
 369     PERL_ARGS_ASSERT_OPSLAB_FORCE_FREE;
 370     slab2 = slab;
 371     do {
 372         for (slot = slab2->opslab_first;
 373              slot->opslot_next;
 374              slot = slot->opslot_next) {
 375             if (slot->opslot_op.op_type != OP_FREED
 376              && !(slot->opslot_op.op_savefree
 377 #ifdef DEBUGGING
 378                   && ++savestack_count
 379 #endif
 380                  )
 381             ) {
 382                 assert(slot->opslot_op.op_slabbed);
 383                 op_free(&slot->opslot_op);
 384                 if (slab->opslab_refcnt == 1) goto free;
 385             }
 386         }
 387     } while ((slab2 = slab2->opslab_next));
 388     /* > 1 because the CV still holds a reference count. */
 389     if (slab->opslab_refcnt > 1) { /* still referenced by the savestack */
 390 #ifdef DEBUGGING
 391         assert(savestack_count == slab->opslab_refcnt-1);
 392 #endif
 393         /* Remove the CV’s reference count. */
 394         slab->opslab_refcnt--;
 395         return;
 396     }
 397    free:
 398     opslab_free(slab);
 399 }
 400
 401 #ifdef PERL_DEBUG_READONLY_OPS
 402 OP *
 403 Perl_op_refcnt_inc(pTHX_ OP *o)
 404 {
 405     if(o) {
 406         OPSLAB *const slab = o->op_slabbed ? OpSLAB(o) : NULL;
 407         if (slab && slab->opslab_readonly) {
 408             Slab_to_rw(slab);
 409             ++o->op_targ;
 410             Slab_to_ro(slab);
 411         } else {
 412             ++o->op_targ;
 413         }
 414     }
 415     return o;
 416
 417 }
 418
 419 PADOFFSET
 420 Perl_op_refcnt_dec(pTHX_ OP *o)
 421 {
 422     PADOFFSET result;
 423     OPSLAB *const slab = o->op_slabbed ? OpSLAB(o) : NULL;
 424
 425     PERL_ARGS_ASSERT_OP_REFCNT_DEC;
 426
 427     if (slab && slab->opslab_readonly) {
 428         Slab_to_rw(slab);
 429         result = --o->op_targ;
 430         Slab_to_ro(slab);
 431     } else {
 432         result = --o->op_targ;
 433     }
 434     return result;
 435 }
 436 #endif
 437 /*
 438  * In the following definition, the ", (OP*)0" is just to make the compiler
 439  * think the expression is of the right type: croak actually does a Siglongjmp.
 440  */
 441 #define CHECKOP(type,o) \
 442     ((PL_op_mask && PL_op_mask[type])                           \
 443      ? ( op_free((OP*)o),                                       \
 444          Perl_croak(aTHX_ "'%s' trapped by operation mask", PL_op_desc[type]),  \
 445          (OP*)0 )                                               \
 446      : PL_check[type](aTHX_ (OP*)o))
 447
 448 #define RETURN_UNLIMITED_NUMBER (PERL_INT_MAX / 2)
 449
 450 #define CHANGE_TYPE(o,type) \
 451     STMT_START {                                \
 452         o->op_type = (OPCODE)type;              \
 453         o->op_ppaddr = PL_ppaddr[type];         \
 454     } STMT_END
 455
 456 STATIC SV*
 457 S_gv_ename(pTHX_ GV *gv)
 458 {
 459     SV* const tmpsv = sv_newmortal();
 460
 461     PERL_ARGS_ASSERT_GV_ENAME;
 462
 463     gv_efullname3(tmpsv, gv, NULL);
 464     return tmpsv;
 465 }
 466
 467 STATIC OP *
 468 S_no_fh_allowed(pTHX_ OP *o)
 469 {
 470     PERL_ARGS_ASSERT_NO_FH_ALLOWED;
 471
 472     yyerror(Perl_form(aTHX_ "Missing comma after first argument to %s function",
 473                  OP_DESC(o)));
 474     return o;
 475 }
 476
 477 STATIC OP *
 478 S_too_few_arguments_sv(pTHX_ OP *o, SV *namesv, U32 flags)
 479 {
 480     PERL_ARGS_ASSERT_TOO_FEW_ARGUMENTS_SV;
 481     yyerror_pv(Perl_form(aTHX_ "Not enough arguments for %"SVf, namesv),
 482                                     SvUTF8(namesv) | flags);
 483     return o;
 484 }
 485
 486 STATIC OP *
 487 S_too_few_arguments_pv(pTHX_ OP *o, const char* name, U32 flags)
 488 {
 489     PERL_ARGS_ASSERT_TOO_FEW_ARGUMENTS_PV;
 490     yyerror_pv(Perl_form(aTHX_ "Not enough arguments for %s", name), flags);
 491     return o;
 492 }
 493
 494 STATIC OP *
 495 S_too_many_arguments_pv(pTHX_ OP *o, const char *name, U32 flags)
 496 {
 497     PERL_ARGS_ASSERT_TOO_MANY_ARGUMENTS_PV;
 498
 499     yyerror_pv(Perl_form(aTHX_ "Too many arguments for %s", name), flags);
 500     return o;
 501 }
 502
 503 STATIC OP *
 504 S_too_many_arguments_sv(pTHX_ OP *o, SV *namesv, U32 flags)
 505 {
 506     PERL_ARGS_ASSERT_TOO_MANY_ARGUMENTS_SV;
 507
 508     yyerror_pv(Perl_form(aTHX_ "Too many arguments for %"SVf, SVfARG(namesv)),
 509                 SvUTF8(namesv) | flags);
 510     return o;
 511 }
 512
 513 STATIC void
 514 S_bad_type_pv(pTHX_ I32 n, const char *t, const char *name, U32 flags, const OP *kid)
 515 {
 516     PERL_ARGS_ASSERT_BAD_TYPE_PV;
 517
 518     yyerror_pv(Perl_form(aTHX_ "Type of arg %d to %s must be %s (not %s)",
 519                  (int)n, name, t, OP_DESC(kid)), flags);
 520 }
 521
 522 STATIC void
 523 S_bad_type_sv(pTHX_ I32 n, const char *t, SV *namesv, U32 flags, const OP *kid)
 524 {
 525     PERL_ARGS_ASSERT_BAD_TYPE_SV;
 526
 527     yyerror_pv(Perl_form(aTHX_ "Type of arg %d to %"SVf" must be %s (not %s)",
 528                  (int)n, SVfARG(namesv), t, OP_DESC(kid)), SvUTF8(namesv) | flags);
 529 }
 530
 531 STATIC void
 532 S_no_bareword_allowed(pTHX_ OP *o)
 533 {
 534     PERL_ARGS_ASSERT_NO_BAREWORD_ALLOWED;
 535
 536     if (PL_madskills)
 537         return;         /* various ok barewords are hidden in extra OP_NULL */
 538     qerror(Perl_mess(aTHX_
 539                      "Bareword \"%"SVf"\" not allowed while \"strict subs\" in use",
 540                      SVfARG(cSVOPo_sv)));
 541     o->op_private &= ~OPpCONST_STRICT; /* prevent warning twice about the same OP */
 542 }
 543
 544 /* "register" allocation */
 545
 546 PADOFFSET
 547 Perl_allocmy(pTHX_ const char *const name, const STRLEN len, const U32 flags)
 548 {
 549     dVAR;
 550     PADOFFSET off;
 551     const bool is_our = (PL_parser->in_my == KEY_our);
 552
 553     PERL_ARGS_ASSERT_ALLOCMY;
 554
 555     if (flags & ~SVf_UTF8)
 556         Perl_croak(aTHX_ "panic: allocmy illegal flag bits 0x%" UVxf,
 557                    (UV)flags);
 558
 559     /* Until we're using the length for real, cross check that we're being
 560        told the truth.  */
 561     assert(strlen(name) == len);
 562
 563     /* complain about "my $<special_var>" etc etc */
 564     if (len &&
 565         !(is_our ||
 566           isALPHA(name[1]) ||
 567           ((flags & SVf_UTF8) && isIDFIRST_utf8((U8 *)name+1)) ||
 568           (name[1] == '_' && (*name == '$' || len > 2))))
 569     {
 570         /* name[2] is true if strlen(name) > 2  */
 571         if (!(flags & SVf_UTF8 && UTF8_IS_START(name[1]))
 572          && (!isPRINT(name[1]) || strchr("\t\n\r\f", name[1]))) {
 573             yyerror(Perl_form(aTHX_ "Can't use global %c^%c%.*s in \"%s\"",
 574                               name[0], toCTRL(name[1]), (int)(len - 2), name + 2,
 575                               PL_parser->in_my == KEY_state ? "state" : "my"));
 576         } else {
 577             yyerror_pv(Perl_form(aTHX_ "Can't use global %.*s in \"%s\"", (int) len, name,
 578                               PL_parser->in_my == KEY_state ? "state" : "my"), flags & SVf_UTF8);
 579         }
 580     }
 581     else if (len == 2 && name[1] == '_' && !is_our)
 582         /* diag_listed_as: Use of my $_ is experimental */
 583         Perl_ck_warner_d(aTHX_ packWARN(WARN_EXPERIMENTAL__LEXICAL_TOPIC),
 584                               "Use of %s $_ is experimental",
 585                                PL_parser->in_my == KEY_state
 586                                  ? "state"
 587                                  : "my");
 588
 589     /* allocate a spare slot and store the name in that slot */
 590
 591     off = pad_add_name_pvn(name, len,
 592                        (is_our ? padadd_OUR :
 593                         PL_parser->in_my == KEY_state ? padadd_STATE : 0)
 594                             | ( flags & SVf_UTF8 ? SVf_UTF8 : 0 ),
 595                     PL_parser->in_my_stash,
 596                     (is_our
 597                         /* $_ is always in main::, even with our */
 598                         ? (PL_curstash && !strEQ(name,"$_") ? PL_curstash : PL_defstash)
 599                         : NULL
 600                     )
 601     );
 602     /* anon sub prototypes contains state vars should always be cloned,
 603      * otherwise the state var would be shared between anon subs */
 604
 605     if (PL_parser->in_my == KEY_state && CvANON(PL_compcv))
 606         CvCLONE_on(PL_compcv);
 607
 608     return off;
 609 }
 610
 611 /*
 612 =for apidoc alloccopstash
 613
 614 Available only under threaded builds, this function allocates an entry in
 615 C<PL_stashpad> for the stash passed to it.
 616
 617 =cut
 618 */
 619
 620 #ifdef USE_ITHREADS
 621 PADOFFSET
 622 Perl_alloccopstash(pTHX_ HV *hv)
 623 {
 624     PADOFFSET off = 0, o = 1;
 625     bool found_slot = FALSE;
 626
 627     PERL_ARGS_ASSERT_ALLOCCOPSTASH;
 628
 629     if (PL_stashpad[PL_stashpadix] == hv) return PL_stashpadix;
 630
 631     for (; o < PL_stashpadmax; ++o) {
 632         if (PL_stashpad[o] == hv) return PL_stashpadix = o;
 633         if (!PL_stashpad[o] || SvTYPE(PL_stashpad[o]) != SVt_PVHV)
 634             found_slot = TRUE, off = o;
 635     }
 636     if (!found_slot) {
 637         Renew(PL_stashpad, PL_stashpadmax + 10, HV *);
 638         Zero(PL_stashpad + PL_stashpadmax, 10, HV *);
 639         off = PL_stashpadmax;
 640         PL_stashpadmax += 10;
 641     }
 642
 643     PL_stashpad[PL_stashpadix = off] = hv;
 644     return off;
 645 }
 646 #endif
 647
 648 /* free the body of an op without examining its contents.
 649  * Always use this rather than FreeOp directly */
 650
 651 static void
 652 S_op_destroy(pTHX_ OP *o)
 653 {
 654     FreeOp(o);
 655 }
 656
 657 /* Destructor */
 658
 659 void
 660 Perl_op_free(pTHX_ OP *o)
 661 {
 662     dVAR;
 663     OPCODE type;
 664
 665     /* Though ops may be freed twice, freeing the op after its slab is a
 666        big no-no. */
 667     assert(!o || !o->op_slabbed || OpSLAB(o)->opslab_refcnt != ~(size_t)0);
 668     /* During the forced freeing of ops after compilation failure, kidops
 669        may be freed before their parents. */
 670     if (!o || o->op_type == OP_FREED)
 671         return;
 672
 673     type = o->op_type;
 674     if (o->op_private & OPpREFCOUNTED) {
 675         switch (type) {
 676         case OP_LEAVESUB:
 677         case OP_LEAVESUBLV:
 678         case OP_LEAVEEVAL:
 679         case OP_LEAVE:
 680         case OP_SCOPE:
 681         case OP_LEAVEWRITE:
 682             {
 683             PADOFFSET refcnt;
 684             OP_REFCNT_LOCK;
 685             refcnt = OpREFCNT_dec(o);
 686             OP_REFCNT_UNLOCK;
 687             if (refcnt) {
 688                 /* Need to find and remove any pattern match ops from the list
 689                    we maintain for reset().  */
 690                 find_and_forget_pmops(o);
 691                 return;
 692             }
 693             }
 694             break;
 695         default:
 696             break;
 697         }
 698     }
 699
 700     /* Call the op_free hook if it has been set. Do it now so that it's called
 701      * at the right time for refcounted ops, but still before all of the kids
 702      * are freed. */
 703     CALL_OPFREEHOOK(o);
 704
 705     if (o->op_flags & OPf_KIDS) {
 706         OP *kid, *nextkid;
 707         for (kid = cUNOPo->op_first; kid; kid = nextkid) {
 708             nextkid = kid->op_sibling; /* Get before next freeing kid */
 709             op_free(kid);
 710         }
 711     }
 712     if (type == OP_NULL)
 713         type = (OPCODE)o->op_targ;
 714
 715     if (o->op_slabbed) {
 716         Slab_to_rw(OpSLAB(o));
 717     }
 718
 719     /* COP* is not cleared by op_clear() so that we may track line
 720      * numbers etc even after null() */
 721     if (type == OP_NEXTSTATE || type == OP_DBSTATE) {
 722         cop_free((COP*)o);
 723     }
 724
 725     op_clear(o);
 726     FreeOp(o);
 727 #ifdef DEBUG_LEAKING_SCALARS
 728     if (PL_op == o)
 729         PL_op = NULL;
 730 #endif
 731 }
 732
 733 void
 734 Perl_op_clear(pTHX_ OP *o)
 735 {
 736
 737     dVAR;
 738
 739     PERL_ARGS_ASSERT_OP_CLEAR;
 740
 741 #ifdef PERL_MAD
 742     mad_free(o->op_madprop);
 743     o->op_madprop = 0;
 744 #endif
 745
 746  retry:
 747     switch (o->op_type) {
 748     case OP_NULL:       /* Was holding old type, if any. */
 749         if (PL_madskills && o->op_targ != OP_NULL) {
 750             o->op_type = (Optype)o->op_targ;
 751             o->op_targ = 0;
 752             goto retry;
 753         }
 754     case OP_ENTERTRY:
 755     case OP_ENTEREVAL:  /* Was holding hints. */
 756         o->op_targ = 0;
 757         break;
 758     default:
 759         if (!(o->op_flags & OPf_REF)
 760             || (PL_check[o->op_type] != Perl_ck_ftst))
 761             break;
 762         /* FALL THROUGH */
 763     case OP_GVSV:
 764     case OP_GV:
 765     case OP_AELEMFAST:
 766         {
 767             GV *gv = (o->op_type == OP_GV || o->op_type == OP_GVSV)
 768 #ifdef USE_ITHREADS
 769                         && PL_curpad
 770 #endif
 771                         ? cGVOPo_gv : NULL;
 772             /* It's possible during global destruction that the GV is freed
 773                before the optree. Whilst the SvREFCNT_inc is happy to bump from
 774                0 to 1 on a freed SV, the corresponding SvREFCNT_dec from 1 to 0
 775                will trigger an assertion failure, because the entry to sv_clear
 776                checks that the scalar is not already freed.  A check of for
 777                !SvIS_FREED(gv) turns out to be invalid, because during global
 778                destruction the reference count can be forced down to zero
 779                (with SVf_BREAK set).  In which case raising to 1 and then
 780                dropping to 0 triggers cleanup before it should happen.  I
 781                *think* that this might actually be a general, systematic,
 782                weakness of the whole idea of SVf_BREAK, in that code *is*
 783                allowed to raise and lower references during global destruction,
 784                so any *valid* code that happens to do this during global
 785                destruction might well trigger premature cleanup.  */
 786             bool still_valid = gv && SvREFCNT(gv);
 787
 788             if (still_valid)
 789                 SvREFCNT_inc_simple_void(gv);
 790 #ifdef USE_ITHREADS
 791             if (cPADOPo->op_padix > 0) {
 792                 /* No GvIN_PAD_off(cGVOPo_gv) here, because other references
 793                  * may still exist on the pad */
 794                 pad_swipe(cPADOPo->op_padix, TRUE);
 795                 cPADOPo->op_padix = 0;
 796             }
 797 #else
 798             SvREFCNT_dec(cSVOPo->op_sv);
 799             cSVOPo->op_sv = NULL;
 800 #endif
 801             if (still_valid) {
 802                 int try_downgrade = SvREFCNT(gv) == 2;
 803                 SvREFCNT_dec_NN(gv);
 804                 if (try_downgrade)
 805                     gv_try_downgrade(gv);
 806             }
 807         }
 808         break;
 809     case OP_METHOD_NAMED:
 810     case OP_CONST:
 811     case OP_HINTSEVAL:
 812         SvREFCNT_dec(cSVOPo->op_sv);
 813         cSVOPo->op_sv = NULL;
 814 #ifdef USE_ITHREADS
 815         /** Bug #15654
 816           Even if op_clear does a pad_free for the target of the op,
 817           pad_free doesn't actually remove the sv that exists in the pad;
 818           instead it lives on. This results in that it could be reused as
 819           a target later on when the pad was reallocated.
 820         **/
 821         if(o->op_targ) {
 822           pad_swipe(o->op_targ,1);
 823           o->op_targ = 0;
 824         }
 825 #endif
 826         break;
 827     case OP_DUMP:
 828     case OP_GOTO:
 829     case OP_NEXT:
 830     case OP_LAST:
 831     case OP_REDO:
 832         if (o->op_flags & (OPf_SPECIAL|OPf_STACKED|OPf_KIDS))
 833             break;
 834         /* FALL THROUGH */
 835     case OP_TRANS:
 836     case OP_TRANSR:
 837         if (o->op_private & (OPpTRANS_FROM_UTF|OPpTRANS_TO_UTF)) {
 838             assert(o->op_type == OP_TRANS || o->op_type == OP_TRANSR);
 839 #ifdef USE_ITHREADS
 840             if (cPADOPo->op_padix > 0) {
 841                 pad_swipe(cPADOPo->op_padix, TRUE);
 842                 cPADOPo->op_padix = 0;
 843             }
 844 #else
 845             SvREFCNT_dec(cSVOPo->op_sv);
 846             cSVOPo->op_sv = NULL;
 847 #endif
 848         }
 849         else {
 850             PerlMemShared_free(cPVOPo->op_pv);
 851             cPVOPo->op_pv = NULL;
 852         }
 853         break;
 854     case OP_SUBST:
 855         op_free(cPMOPo->op_pmreplrootu.op_pmreplroot);
 856         goto clear_pmop;
 857     case OP_PUSHRE:
 858 #ifdef USE_ITHREADS
 859         if (cPMOPo->op_pmreplrootu.op_pmtargetoff) {
 860             /* No GvIN_PAD_off here, because other references may still
 861              * exist on the pad */
 862             pad_swipe(cPMOPo->op_pmreplrootu.op_pmtargetoff, TRUE);
 863         }
 864 #else
 865         SvREFCNT_dec(MUTABLE_SV(cPMOPo->op_pmreplrootu.op_pmtargetgv));
 866 #endif
 867         /* FALL THROUGH */
 868     case OP_MATCH:
 869     case OP_QR:
 870 clear_pmop:
 871         if (!(cPMOPo->op_pmflags & PMf_CODELIST_PRIVATE))
 872             op_free(cPMOPo->op_code_list);
 873         cPMOPo->op_code_list = NULL;
 874         forget_pmop(cPMOPo);
 875         cPMOPo->op_pmreplrootu.op_pmreplroot = NULL;
 876         /* we use the same protection as the "SAFE" version of the PM_ macros
 877          * here since sv_clean_all might release some PMOPs
 878          * after PL_regex_padav has been cleared
 879          * and the clearing of PL_regex_padav needs to
 880          * happen before sv_clean_all
 881          */
 882 #ifdef USE_ITHREADS
 883         if(PL_regex_pad) {        /* We could be in destruction */
 884             const IV offset = (cPMOPo)->op_pmoffset;
 885             ReREFCNT_dec(PM_GETRE(cPMOPo));
 886             PL_regex_pad[offset] = &PL_sv_undef;
 887             sv_catpvn_nomg(PL_regex_pad[0], (const char *)&offset,
 888                            sizeof(offset));
 889         }
 890 #else
 891         ReREFCNT_dec(PM_GETRE(cPMOPo));
 892         PM_SETRE(cPMOPo, NULL);
 893 #endif
 894
 895         break;
 896     }
 897
 898     if (o->op_targ > 0) {
 899         pad_free(o->op_targ);
 900         o->op_targ = 0;
 901     }
 902 }
 903
 904 STATIC void
 905 S_cop_free(pTHX_ COP* cop)
 906 {
 907     PERL_ARGS_ASSERT_COP_FREE;
 908
 909     CopFILE_free(cop);
 910     if (! specialWARN(cop->cop_warnings))
 911         PerlMemShared_free(cop->cop_warnings);
 912     cophh_free(CopHINTHASH_get(cop));
 913 }
 914
 915 STATIC void
 916 S_forget_pmop(pTHX_ PMOP *const o
 917               )
 918 {
 919     HV * const pmstash = PmopSTASH(o);
 920
 921     PERL_ARGS_ASSERT_FORGET_PMOP;
 922
 923     if (pmstash && !SvIS_FREED(pmstash) && SvMAGICAL(pmstash)) {
 924         MAGIC * const mg = mg_find((const SV *)pmstash, PERL_MAGIC_symtab);
 925         if (mg) {
 926             PMOP **const array = (PMOP**) mg->mg_ptr;
 927             U32 count = mg->mg_len / sizeof(PMOP**);
 928             U32 i = count;
 929
 930             while (i--) {
 931                 if (array[i] == o) {
 932                     /* Found it. Move the entry at the end to overwrite it.  */
 933                     array[i] = array[--count];
 934                     mg->mg_len = count * sizeof(PMOP**);
 935                     /* Could realloc smaller at this point always, but probably
 936                        not worth it. Probably worth free()ing if we're the
 937                        last.  */
 938                     if(!count) {
 939                         Safefree(mg->mg_ptr);
 940                         mg->mg_ptr = NULL;
 941                     }
 942                     break;
 943                 }
 944             }
 945         }
 946     }
 947     if (PL_curpm == o)
 948         PL_curpm = NULL;
 949 }
 950
 951 STATIC void
 952 S_find_and_forget_pmops(pTHX_ OP *o)
 953 {
 954     PERL_ARGS_ASSERT_FIND_AND_FORGET_PMOPS;
 955
 956     if (o->op_flags & OPf_KIDS) {
 957         OP *kid = cUNOPo->op_first;
 958         while (kid) {
 959             switch (kid->op_type) {
 960             case OP_SUBST:
 961             case OP_PUSHRE:
 962             case OP_MATCH:
 963             case OP_QR:
 964                 forget_pmop((PMOP*)kid);
 965             }
 966             find_and_forget_pmops(kid);
 967             kid = kid->op_sibling;
 968         }
 969     }
 970 }
 971
 972 void
 973 Perl_op_null(pTHX_ OP *o)
 974 {
 975     dVAR;
 976
 977     PERL_ARGS_ASSERT_OP_NULL;
 978
 979     if (o->op_type == OP_NULL)
 980         return;
 981     if (!PL_madskills)
 982         op_clear(o);
 983     o->op_targ = o->op_type;
 984     o->op_type = OP_NULL;
 985     o->op_ppaddr = PL_ppaddr[OP_NULL];
 986 }
 987
 988 void
 989 Perl_op_refcnt_lock(pTHX)
 990 {
 991     dVAR;
 992     PERL_UNUSED_CONTEXT;
 993     OP_REFCNT_LOCK;
 994 }
 995
 996 void
 997 Perl_op_refcnt_unlock(pTHX)
 998 {
 999     dVAR;
1000     PERL_UNUSED_CONTEXT;
1001     OP_REFCNT_UNLOCK;
1002 }
1003
1004 /* Contextualizers */
1005
1006 /*
1007 =for apidoc Am|OP *|op_contextualize|OP *o|I32 context
1008
1009 Applies a syntactic context to an op tree representing an expression.
1010 I<o> is the op tree, and I<context> must be C<G_SCALAR>, C<G_ARRAY>,
1011 or C<G_VOID> to specify the context to apply.  The modified op tree
1012 is returned.
1013
1014 =cut
1015 */
1016
1017 OP *
1018 Perl_op_contextualize(pTHX_ OP *o, I32 context)
1019 {
1020     PERL_ARGS_ASSERT_OP_CONTEXTUALIZE;
1021     switch (context) {
1022         case G_SCALAR: return scalar(o);
1023         case G_ARRAY:  return list(o);
1024         case G_VOID:   return scalarvoid(o);
1025         default:
1026             Perl_croak(aTHX_ "panic: op_contextualize bad context %ld",
1027                        (long) context);
1028             return o;
1029     }
1030 }
1031
1032 /*
1033 =head1 Optree Manipulation Functions
1034
1035 =for apidoc Am|OP*|op_linklist|OP *o
1036 This function is the implementation of the L</LINKLIST> macro. It should
1037 not be called directly.
1038
1039 =cut
1040 */
1041
1042 OP *
1043 Perl_op_linklist(pTHX_ OP *o)
1044 {
1045     OP *first;
1046
1047     PERL_ARGS_ASSERT_OP_LINKLIST;
1048
1049     if (o->op_next)
1050         return o->op_next;
1051
1052     /* establish postfix order */
1053     first = cUNOPo->op_first;
1054     if (first) {
1055         OP *kid;
1056         o->op_next = LINKLIST(first);
1057         kid = first;
1058         for (;;) {
1059             if (kid->op_sibling) {
1060                 kid->op_next = LINKLIST(kid->op_sibling);
1061                 kid = kid->op_sibling;
1062             } else {
1063                 kid->op_next = o;
1064                 break;
1065             }
1066         }
1067     }
1068     else
1069         o->op_next = o;
1070
1071     return o->op_next;
1072 }
1073
1074 static OP *
1075 S_scalarkids(pTHX_ OP *o)
1076 {
1077     if (o && o->op_flags & OPf_KIDS) {
1078         OP *kid;
1079         for (kid = cLISTOPo->op_first; kid; kid = kid->op_sibling)
1080             scalar(kid);
1081     }
1082     return o;
1083 }
1084
1085 STATIC OP *
1086 S_scalarboolean(pTHX_ OP *o)
1087 {
1088     dVAR;
1089
1090     PERL_ARGS_ASSERT_SCALARBOOLEAN;
1091
1092     if (o->op_type == OP_SASSIGN && cBINOPo->op_first->op_type == OP_CONST
1093      && !(cBINOPo->op_first->op_flags & OPf_SPECIAL)) {
1094         if (ckWARN(WARN_SYNTAX)) {
1095             const line_t oldline = CopLINE(PL_curcop);
1096
1097             if (PL_parser && PL_parser->copline != NOLINE) {
1098                 /* This ensures that warnings are reported at the first line
1099                    of the conditional, not the last.  */
1100                 CopLINE_set(PL_curcop, PL_parser->copline);
1101             }
1102             Perl_warner(aTHX_ packWARN(WARN_SYNTAX), "Found = in conditional, should be ==");
1103             CopLINE_set(PL_curcop, oldline);
1104         }
1105     }
1106     return scalar(o);
1107 }
1108
1109 OP *
1110 Perl_scalar(pTHX_ OP *o)
1111 {
1112     dVAR;
1113     OP *kid;
1114
1115     /* assumes no premature commitment */
1116     if (!o || (PL_parser && PL_parser->error_count)
1117          || (o->op_flags & OPf_WANT)
1118          || o->op_type == OP_RETURN)
1119     {
1120         return o;
1121     }
1122
1123     o->op_flags = (o->op_flags & ~OPf_WANT) | OPf_WANT_SCALAR;
1124
1125     switch (o->op_type) {
1126     case OP_REPEAT:
1127         scalar(cBINOPo->op_first);
1128         break;
1129     case OP_OR:
1130     case OP_AND:
1131     case OP_COND_EXPR:
1132         for (kid = cUNOPo->op_first->op_sibling; kid; kid = kid->op_sibling)
1133             scalar(kid);
1134         break;
1135         /* FALL THROUGH */
1136     case OP_SPLIT:
1137     case OP_MATCH:
1138     case OP_QR:
1139     case OP_SUBST:
1140     case OP_NULL:
1141     default:
1142         if (o->op_flags & OPf_KIDS) {
1143             for (kid = cUNOPo->op_first; kid; kid = kid->op_sibling)
1144                 scalar(kid);
1145         }
1146         break;
1147     case OP_LEAVE:
1148     case OP_LEAVETRY:
1149         kid = cLISTOPo->op_first;
1150         scalar(kid);
1151         kid = kid->op_sibling;
1152     do_kids:
1153         while (kid) {
1154             OP *sib = kid->op_sibling;
1155             if (sib && kid->op_type != OP_LEAVEWHEN)
1156                 scalarvoid(kid);
1157             else
1158                 scalar(kid);
1159             kid = sib;
1160         }
1161         PL_curcop = &PL_compiling;
1162         break;
1163     case OP_SCOPE:
1164     case OP_LINESEQ:
1165     case OP_LIST:
1166         kid = cLISTOPo->op_first;
1167         goto do_kids;
1168     case OP_SORT:
1169         Perl_ck_warner(aTHX_ packWARN(WARN_VOID), "Useless use of sort in scalar context");
1170         break;
1171     }
1172     return o;
1173 }
1174
1175 OP *
1176 Perl_scalarvoid(pTHX_ OP *o)
1177 {
1178     dVAR;
1179     OP *kid;
1180     SV *useless_sv = NULL;
1181     const char* useless = NULL;
1182     SV* sv;
1183     U8 want;
1184
1185     PERL_ARGS_ASSERT_SCALARVOID;
1186
1187     /* trailing mad null ops don't count as "there" for void processing */
1188     if (PL_madskills &&
1189         o->op_type != OP_NULL &&
1190         o->op_sibling &&
1191         o->op_sibling->op_type == OP_NULL)
1192     {
1193         OP *sib;
1194         for (sib = o->op_sibling;
1195                 sib && sib->op_type == OP_NULL;
1196                 sib = sib->op_sibling) ;
1197
1198         if (!sib)
1199             return o;
1200     }
1201
1202     if (o->op_type == OP_NEXTSTATE
1203         || o->op_type == OP_DBSTATE
1204         || (o->op_type == OP_NULL && (o->op_targ == OP_NEXTSTATE
1205                                       || o->op_targ == OP_DBSTATE)))
1206         PL_curcop = (COP*)o;            /* for warning below */
1207
1208     /* assumes no premature commitment */
1209     want = o->op_flags & OPf_WANT;
1210     if ((want && want != OPf_WANT_SCALAR)
1211          || (PL_parser && PL_parser->error_count)
1212          || o->op_type == OP_RETURN || o->op_type == OP_REQUIRE || o->op_type == OP_LEAVEWHEN)
1213     {
1214         return o;
1215     }
1216
1217     if ((o->op_private & OPpTARGET_MY)
1218         && (PL_opargs[o->op_type] & OA_TARGLEX))/* OPp share the meaning */
1219     {
1220         return scalar(o);                       /* As if inside SASSIGN */
1221     }
1222
1223     o->op_flags = (o->op_flags & ~OPf_WANT) | OPf_WANT_VOID;
1224
1225     switch (o->op_type) {
1226     default:
1227         if (!(PL_opargs[o->op_type] & OA_FOLDCONST))
1228             break;
1229         /* FALL THROUGH */
1230     case OP_REPEAT:
1231         if (o->op_flags & OPf_STACKED)
1232             break;
1233         goto func_ops;
1234     case OP_SUBSTR:
1235         if (o->op_private == 4)
1236             break;
1237         /* FALL THROUGH */
1238     case OP_GVSV:
1239     case OP_WANTARRAY:
1240     case OP_GV:
1241     case OP_SMARTMATCH:
1242     case OP_PADSV:
1243     case OP_PADAV:
1244     case OP_PADHV:
1245     case OP_PADANY:
1246     case OP_AV2ARYLEN:
1247     case OP_REF:
1248     case OP_REFGEN:
1249     case OP_SREFGEN:
1250     case OP_DEFINED:
1251     case OP_HEX:
1252     case OP_OCT:
1253     case OP_LENGTH:
1254     case OP_VEC:
1255     case OP_INDEX:
1256     case OP_RINDEX:
1257     case OP_SPRINTF:
1258     case OP_AELEM:
1259     case OP_AELEMFAST:
1260     case OP_AELEMFAST_LEX:
1261     case OP_ASLICE:
1262     case OP_HELEM:
1263     case OP_HSLICE:
1264     case OP_UNPACK:
1265     case OP_PACK:
1266     case OP_JOIN:
1267     case OP_LSLICE:
1268     case OP_ANONLIST:
1269     case OP_ANONHASH:
1270     case OP_SORT:
1271     case OP_REVERSE:
1272     case OP_RANGE:
1273     case OP_FLIP:
1274     case OP_FLOP:
1275     case OP_CALLER:
1276     case OP_FILENO:
1277     case OP_EOF:
1278     case OP_TELL:
1279     case OP_GETSOCKNAME:
1280     case OP_GETPEERNAME:
1281     case OP_READLINK:
1282     case OP_TELLDIR:
1283     case OP_GETPPID:
1284     case OP_GETPGRP:
1285     case OP_GETPRIORITY:
1286     case OP_TIME:
1287     case OP_TMS:
1288     case OP_LOCALTIME:
1289     case OP_GMTIME:
1290     case OP_GHBYNAME:
1291     case OP_GHBYADDR:
1292     case OP_GHOSTENT:
1293     case OP_GNBYNAME:
1294     case OP_GNBYADDR:
1295     case OP_GNETENT:
1296     case OP_GPBYNAME:
1297     case OP_GPBYNUMBER:
1298     case OP_GPROTOENT:
1299     case OP_GSBYNAME:
1300     case OP_GSBYPORT:
1301     case OP_GSERVENT:
1302     case OP_GPWNAM:
1303     case OP_GPWUID:
1304     case OP_GGRNAM:
1305     case OP_GGRGID:
1306     case OP_GETLOGIN:
1307     case OP_PROTOTYPE:
1308     case OP_RUNCV:
1309       func_ops:
1310         if (!(o->op_private & (OPpLVAL_INTRO|OPpOUR_INTRO)))
1311             /* Otherwise it's "Useless use of grep iterator" */
1312             useless = OP_DESC(o);
1313         break;
1314
1315     case OP_SPLIT:
1316         kid = cLISTOPo->op_first;
1317         if (kid && kid->op_type == OP_PUSHRE
1318 #ifdef USE_ITHREADS
1319                 && !((PMOP*)kid)->op_pmreplrootu.op_pmtargetoff)
1320 #else
1321                 && !((PMOP*)kid)->op_pmreplrootu.op_pmtargetgv)
1322 #endif
1323             useless = OP_DESC(o);
1324         break;
1325
1326     case OP_NOT:
1327        kid = cUNOPo->op_first;
1328        if (kid->op_type != OP_MATCH && kid->op_type != OP_SUBST &&
1329            kid->op_type != OP_TRANS && kid->op_type != OP_TRANSR) {
1330                 goto func_ops;
1331        }
1332        useless = "negative pattern binding (!~)";
1333        break;
1334
1335     case OP_SUBST:
1336         if (cPMOPo->op_pmflags & PMf_NONDESTRUCT)
1337             useless = "non-destructive substitution (s///r)";
1338         break;
1339
1340     case OP_TRANSR:
1341         useless = "non-destructive transliteration (tr///r)";
1342         break;
1343
1344     case OP_RV2GV:
1345     case OP_RV2SV:
1346     case OP_RV2AV:
1347     case OP_RV2HV:
1348         if (!(o->op_private & (OPpLVAL_INTRO|OPpOUR_INTRO)) &&
1349                 (!o->op_sibling || o->op_sibling->op_type != OP_READLINE))
1350             useless = "a variable";
1351         break;
1352
1353     case OP_CONST:
1354         sv = cSVOPo_sv;
1355         if (cSVOPo->op_private & OPpCONST_STRICT)
1356             no_bareword_allowed(o);
1357         else {
1358             if (ckWARN(WARN_VOID)) {
1359                 /* don't warn on optimised away booleans, eg
1360                  * use constant Foo, 5; Foo || print; */
1361                 if (cSVOPo->op_private & OPpCONST_SHORTCIRCUIT)
1362                     useless = NULL;
1363                 /* the constants 0 and 1 are permitted as they are
1364                    conventionally used as dummies in constructs like
1365                         1 while some_condition_with_side_effects;  */
1366                 else if (SvNIOK(sv) && (SvNV(sv) == 0.0 || SvNV(sv) == 1.0))
1367                     useless = NULL;
1368                 else if (SvPOK(sv)) {
1369                   /* perl4's way of mixing documentation and code
1370                      (before the invention of POD) was based on a
1371                      trick to mix nroff and perl code. The trick was
1372                      built upon these three nroff macros being used in
1373                      void context. The pink camel has the details in
1374                      the script wrapman near page 319. */
1375                     const char * const maybe_macro = SvPVX_const(sv);
1376                     if (strnEQ(maybe_macro, "di", 2) ||
1377                         strnEQ(maybe_macro, "ds", 2) ||
1378                         strnEQ(maybe_macro, "ig", 2))
1379                             useless = NULL;
1380                     else {
1381                         SV * const dsv = newSVpvs("");
1382                         useless_sv
1383                             = Perl_newSVpvf(aTHX_
1384                                             "a constant (%s)",
1385                                             pv_pretty(dsv, maybe_macro,
1386                                                       SvCUR(sv), 32, NULL, NULL,
1387                                                       PERL_PV_PRETTY_DUMP
1388                                                       | PERL_PV_ESCAPE_NOCLEAR
1389                                                       | PERL_PV_ESCAPE_UNI_DETECT));
1390                         SvREFCNT_dec_NN(dsv);
1391                     }
1392                 }
1393                 else if (SvOK(sv)) {
1394                     useless_sv = Perl_newSVpvf(aTHX_ "a constant (%"SVf")", sv);
1395                 }
1396                 else
1397                     useless = "a constant (undef)";
1398             }
1399         }
1400         op_null(o);             /* don't execute or even remember it */
1401         break;
1402
1403     case OP_POSTINC:
1404         o->op_type = OP_PREINC;         /* pre-increment is faster */
1405         o->op_ppaddr = PL_ppaddr[OP_PREINC];
1406         break;
1407
1408     case OP_POSTDEC:
1409         o->op_type = OP_PREDEC;         /* pre-decrement is faster */
1410         o->op_ppaddr = PL_ppaddr[OP_PREDEC];
1411         break;
1412
1413     case OP_I_POSTINC:
1414         o->op_type = OP_I_PREINC;       /* pre-increment is faster */
1415         o->op_ppaddr = PL_ppaddr[OP_I_PREINC];
1416         break;
1417
1418     case OP_I_POSTDEC:
1419         o->op_type = OP_I_PREDEC;       /* pre-decrement is faster */
1420         o->op_ppaddr = PL_ppaddr[OP_I_PREDEC];
1421         break;
1422
1423     case OP_SASSIGN: {
1424         OP *rv2gv;
1425         UNOP *refgen, *rv2cv;
1426         LISTOP *exlist;
1427
1428         if ((o->op_private & ~OPpASSIGN_BACKWARDS) != 2)
1429             break;
1430
1431         rv2gv = ((BINOP *)o)->op_last;
1432         if (!rv2gv || rv2gv->op_type != OP_RV2GV)
1433             break;
1434
1435         refgen = (UNOP *)((BINOP *)o)->op_first;
1436
1437         if (!refgen || refgen->op_type != OP_REFGEN)
1438             break;
1439
1440         exlist = (LISTOP *)refgen->op_first;
1441         if (!exlist || exlist->op_type != OP_NULL
1442             || exlist->op_targ != OP_LIST)
1443             break;
1444
1445         if (exlist->op_first->op_type != OP_PUSHMARK)
1446             break;
1447
1448         rv2cv = (UNOP*)exlist->op_last;
1449
1450         if (rv2cv->op_type != OP_RV2CV)
1451             break;
1452
1453         assert ((rv2gv->op_private & OPpDONT_INIT_GV) == 0);
1454         assert ((o->op_private & OPpASSIGN_CV_TO_GV) == 0);
1455         assert ((rv2cv->op_private & OPpMAY_RETURN_CONSTANT) == 0);
1456
1457         o->op_private |= OPpASSIGN_CV_TO_GV;
1458         rv2gv->op_private |= OPpDONT_INIT_GV;
1459         rv2cv->op_private |= OPpMAY_RETURN_CONSTANT;
1460
1461         break;
1462     }
1463
1464     case OP_AASSIGN: {
1465         inplace_aassign(o);
1466         break;
1467     }
1468
1469     case OP_OR:
1470     case OP_AND:
1471         kid = cLOGOPo->op_first;
1472         if (kid->op_type == OP_NOT
1473             && (kid->op_flags & OPf_KIDS)
1474             && !PL_madskills) {
1475             if (o->op_type == OP_AND) {
1476                 o->op_type = OP_OR;
1477                 o->op_ppaddr = PL_ppaddr[OP_OR];
1478             } else {
1479                 o->op_type = OP_AND;
1480                 o->op_ppaddr = PL_ppaddr[OP_AND];
1481             }
1482             op_null(kid);
1483         }
1484
1485     case OP_DOR:
1486     case OP_COND_EXPR:
1487     case OP_ENTERGIVEN:
1488     case OP_ENTERWHEN:
1489         for (kid = cUNOPo->op_first->op_sibling; kid; kid = kid->op_sibling)
1490             scalarvoid(kid);
1491         break;
1492
1493     case OP_NULL:
1494         if (o->op_flags & OPf_STACKED)
1495             break;
1496         /* FALL THROUGH */
1497     case OP_NEXTSTATE:
1498     case OP_DBSTATE:
1499     case OP_ENTERTRY:
1500     case OP_ENTER:
1501         if (!(o->op_flags & OPf_KIDS))
1502             break;
1503         /* FALL THROUGH */
1504     case OP_SCOPE:
1505     case OP_LEAVE:
1506     case OP_LEAVETRY:
1507     case OP_LEAVELOOP:
1508     case OP_LINESEQ:
1509     case OP_LIST:
1510     case OP_LEAVEGIVEN:
1511     case OP_LEAVEWHEN:
1512         for (kid = cLISTOPo->op_first; kid; kid = kid->op_sibling)
1513             scalarvoid(kid);
1514         break;
1515     case OP_ENTEREVAL:
1516         scalarkids(o);
1517         break;
1518     case OP_SCALAR:
1519         return scalar(o);
1520     }
1521
1522     if (useless_sv) {
1523         /* mortalise it, in case warnings are fatal.  */
1524         Perl_ck_warner(aTHX_ packWARN(WARN_VOID),
1525                        "Useless use of %"SVf" in void context",
1526                        sv_2mortal(useless_sv));
1527     }
1528     else if (useless) {
1529        Perl_ck_warner(aTHX_ packWARN(WARN_VOID),
1530                       "Useless use of %s in void context",
1531                       useless);
1532     }
1533     return o;
1534 }
1535
1536 static OP *
1537 S_listkids(pTHX_ OP *o)
1538 {
1539     if (o && o->op_flags & OPf_KIDS) {
1540         OP *kid;
1541         for (kid = cLISTOPo->op_first; kid; kid = kid->op_sibling)
1542             list(kid);
1543     }
1544     return o;
1545 }
1546
1547 OP *
1548 Perl_list(pTHX_ OP *o)
1549 {
1550     dVAR;
1551     OP *kid;
1552
1553     /* assumes no premature commitment */
1554     if (!o || (o->op_flags & OPf_WANT)
1555          || (PL_parser && PL_parser->error_count)
1556          || o->op_type == OP_RETURN)
1557     {
1558         return o;
1559     }
1560
1561     if ((o->op_private & OPpTARGET_MY)
1562         && (PL_opargs[o->op_type] & OA_TARGLEX))/* OPp share the meaning */
1563     {
1564         return o;                               /* As if inside SASSIGN */
1565     }
1566
1567     o->op_flags = (o->op_flags & ~OPf_WANT) | OPf_WANT_LIST;
1568
1569     switch (o->op_type) {
1570     case OP_FLOP:
1571     case OP_REPEAT:
1572         list(cBINOPo->op_first);
1573         break;
1574     case OP_OR:
1575     case OP_AND:
1576     case OP_COND_EXPR:
1577         for (kid = cUNOPo->op_first->op_sibling; kid; kid = kid->op_sibling)
1578             list(kid);
1579         break;
1580     default:
1581     case OP_MATCH:
1582     case OP_QR:
1583     case OP_SUBST:
1584     case OP_NULL:
1585         if (!(o->op_flags & OPf_KIDS))
1586             break;
1587         if (!o->op_next && cUNOPo->op_first->op_type == OP_FLOP) {
1588             list(cBINOPo->op_first);
1589             return gen_constant_list(o);
1590         }
1591     case OP_LIST:
1592         listkids(o);
1593         break;
1594     case OP_LEAVE:
1595     case OP_LEAVETRY:
1596         kid = cLISTOPo->op_first;
1597         list(kid);
1598         kid = kid->op_sibling;
1599     do_kids:
1600         while (kid) {
1601             OP *sib = kid->op_sibling;
1602             if (sib && kid->op_type != OP_LEAVEWHEN)
1603                 scalarvoid(kid);
1604             else
1605                 list(kid);
1606             kid = sib;
1607         }
1608         PL_curcop = &PL_compiling;
1609         break;
1610     case OP_SCOPE:
1611     case OP_LINESEQ:
1612         kid = cLISTOPo->op_first;
1613         goto do_kids;
1614     }
1615     return o;
1616 }
1617
1618 static OP *
1619 S_scalarseq(pTHX_ OP *o)
1620 {
1621     dVAR;
1622     if (o) {
1623         const OPCODE type = o->op_type;
1624
1625         if (type == OP_LINESEQ || type == OP_SCOPE ||
1626             type == OP_LEAVE || type == OP_LEAVETRY)
1627         {
1628             OP *kid;
1629             for (kid = cLISTOPo->op_first; kid; kid = kid->op_sibling) {
1630                 if (kid->op_sibling) {
1631                     scalarvoid(kid);
1632                 }
1633             }
1634             PL_curcop = &PL_compiling;
1635         }
1636         o->op_flags &= ~OPf_PARENS;
1637         if (PL_hints & HINT_BLOCK_SCOPE)
1638             o->op_flags |= OPf_PARENS;
1639     }
1640     else
1641         o = newOP(OP_STUB, 0);
1642     return o;
1643 }
1644
1645 STATIC OP *
1646 S_modkids(pTHX_ OP *o, I32 type)
1647 {
1648     if (o && o->op_flags & OPf_KIDS) {
1649         OP *kid;
1650         for (kid = cLISTOPo->op_first; kid; kid = kid->op_sibling)
1651             op_lvalue(kid, type);
1652     }
1653     return o;
1654 }
1655
1656 /*
1657 =for apidoc finalize_optree
1658
1659 This function finalizes the optree. Should be called directly after
1660 the complete optree is built. It does some additional
1661 checking which can't be done in the normal ck_xxx functions and makes
1662 the tree thread-safe.
1663
1664 =cut
1665 */
1666 void
1667 Perl_finalize_optree(pTHX_ OP* o)
1668 {
1669     PERL_ARGS_ASSERT_FINALIZE_OPTREE;
1670
1671     ENTER;
1672     SAVEVPTR(PL_curcop);
1673
1674     finalize_op(o);
1675
1676     LEAVE;
1677 }
1678
1679 STATIC void
1680 S_finalize_op(pTHX_ OP* o)
1681 {
1682     PERL_ARGS_ASSERT_FINALIZE_OP;
1683
1684 #if defined(PERL_MAD) && defined(USE_ITHREADS)
1685     {
1686         /* Make sure mad ops are also thread-safe */
1687         MADPROP *mp = o->op_madprop;
1688         while (mp) {
1689             if (mp->mad_type == MAD_OP && mp->mad_vlen) {
1690                 OP *prop_op = (OP *) mp->mad_val;
1691                 /* We only need "Relocate sv to the pad for thread safety.", but this
1692                    easiest way to make sure it traverses everything */
1693                 if (prop_op->op_type == OP_CONST)
1694                     cSVOPx(prop_op)->op_private &= ~OPpCONST_STRICT;
1695                 finalize_op(prop_op);
1696             }
1697             mp = mp->mad_next;
1698         }
1699     }
1700 #endif
1701
1702     switch (o->op_type) {
1703     case OP_NEXTSTATE:
1704     case OP_DBSTATE:
1705         PL_curcop = ((COP*)o);          /* for warnings */
1706         break;
1707     case OP_EXEC:
1708         if ( o->op_sibling
1709             && (o->op_sibling->op_type == OP_NEXTSTATE || o->op_sibling->op_type == OP_DBSTATE)
1710             && ckWARN(WARN_SYNTAX))
1711             {
1712                 if (o->op_sibling->op_sibling) {
1713                     const OPCODE type = o->op_sibling->op_sibling->op_type;
1714                     if (type != OP_EXIT && type != OP_WARN && type != OP_DIE) {
1715                         const line_t oldline = CopLINE(PL_curcop);
1716                         CopLINE_set(PL_curcop, CopLINE((COP*)o->op_sibling));
1717                         Perl_warner(aTHX_ packWARN(WARN_EXEC),
1718                             "Statement unlikely to be reached");
1719                         Perl_warner(aTHX_ packWARN(WARN_EXEC),
1720                             "\t(Maybe you meant system() when you said exec()?)\n");
1721                         CopLINE_set(PL_curcop, oldline);
1722                     }
1723                 }
1724             }
1725         break;
1726
1727     case OP_GV:
1728         if ((o->op_private & OPpEARLY_CV) && ckWARN(WARN_PROTOTYPE)) {
1729             GV * const gv = cGVOPo_gv;
1730             if (SvTYPE(gv) == SVt_PVGV && GvCV(gv) && SvPVX_const(GvCV(gv))) {
1731                 /* XXX could check prototype here instead of just carping */
1732                 SV * const sv = sv_newmortal();
1733                 gv_efullname3(sv, gv, NULL);
1734                 Perl_warner(aTHX_ packWARN(WARN_PROTOTYPE),
1735                     "%"SVf"() called too early to check prototype",
1736                     SVfARG(sv));
1737             }
1738         }
1739         break;
1740
1741     case OP_CONST:
1742         if (cSVOPo->op_private & OPpCONST_STRICT)
1743             no_bareword_allowed(o);
1744         /* FALLTHROUGH */
1745 #ifdef USE_ITHREADS
1746     case OP_HINTSEVAL:
1747     case OP_METHOD_NAMED:
1748         /* Relocate sv to the pad for thread safety.
1749          * Despite being a "constant", the SV is written to,
1750          * for reference counts, sv_upgrade() etc. */
1751         if (cSVOPo->op_sv) {
1752             const PADOFFSET ix = pad_alloc(OP_CONST, SVs_PADTMP);
1753             if (o->op_type != OP_METHOD_NAMED &&
1754                 (SvPADTMP(cSVOPo->op_sv) || SvPADMY(cSVOPo->op_sv)))
1755             {
1756                 /* If op_sv is already a PADTMP/MY then it is being used by
1757                  * some pad, so make a copy. */
1758                 sv_setsv(PAD_SVl(ix),cSVOPo->op_sv);
1759                 if (!SvIsCOW(PAD_SVl(ix))) SvREADONLY_on(PAD_SVl(ix));
1760                 SvREFCNT_dec(cSVOPo->op_sv);
1761             }
1762             else if (o->op_type != OP_METHOD_NAMED
1763                 && cSVOPo->op_sv == &PL_sv_undef) {
1764                 /* PL_sv_undef is hack - it's unsafe to store it in the
1765                    AV that is the pad, because av_fetch treats values of
1766                    PL_sv_undef as a "free" AV entry and will merrily
1767                    replace them with a new SV, causing pad_alloc to think
1768                    that this pad slot is free. (When, clearly, it is not)
1769                 */
1770                 SvOK_off(PAD_SVl(ix));
1771                 SvPADTMP_on(PAD_SVl(ix));
1772                 SvREADONLY_on(PAD_SVl(ix));
1773             }
1774             else {
1775                 SvREFCNT_dec(PAD_SVl(ix));
1776                 SvPADTMP_on(cSVOPo->op_sv);
1777                 PAD_SETSV(ix, cSVOPo->op_sv);
1778                 /* XXX I don't know how this isn't readonly already. */
1779                 if (!SvIsCOW(PAD_SVl(ix))) SvREADONLY_on(PAD_SVl(ix));
1780             }
1781             cSVOPo->op_sv = NULL;
1782             o->op_targ = ix;
1783         }
1784 #endif
1785         break;
1786
1787     case OP_HELEM: {
1788         UNOP *rop;
1789         SV *lexname;
1790         GV **fields;
1791         SV **svp, *sv;
1792         const char *key = NULL;
1793         STRLEN keylen;
1794
1795         if (((BINOP*)o)->op_last->op_type != OP_CONST)
1796             break;
1797
1798         /* Make the CONST have a shared SV */
1799         svp = cSVOPx_svp(((BINOP*)o)->op_last);
1800         if ((!SvIsCOW(sv = *svp))
1801             && SvTYPE(sv) < SVt_PVMG && !SvROK(sv)) {
1802             key = SvPV_const(sv, keylen);
1803             lexname = newSVpvn_share(key,
1804                 SvUTF8(sv) ? -(I32)keylen : (I32)keylen,
1805                 0);
1806             SvREFCNT_dec_NN(sv);
1807             *svp = lexname;
1808         }
1809
1810         if ((o->op_private & (OPpLVAL_INTRO)))
1811             break;
1812
1813         rop = (UNOP*)((BINOP*)o)->op_first;
1814         if (rop->op_type != OP_RV2HV || rop->op_first->op_type != OP_PADSV)
1815             break;
1816         lexname = *av_fetch(PL_comppad_name, rop->op_first->op_targ, TRUE);
1817         if (!SvPAD_TYPED(lexname))
1818             break;
1819         fields = (GV**)hv_fetchs(SvSTASH(lexname), "FIELDS", FALSE);
1820         if (!fields || !GvHV(*fields))
1821             break;
1822         key = SvPV_const(*svp, keylen);
1823         if (!hv_fetch(GvHV(*fields), key,
1824                 SvUTF8(*svp) ? -(I32)keylen : (I32)keylen, FALSE)) {
1825             Perl_croak(aTHX_ "No such class field \"%"SVf"\" "
1826                            "in variable %"SVf" of type %"HEKf,
1827                       SVfARG(*svp), SVfARG(lexname),
1828                       HEKfARG(HvNAME_HEK(SvSTASH(lexname))));
1829         }
1830         break;
1831     }
1832
1833     case OP_HSLICE: {
1834         UNOP *rop;
1835         SV *lexname;
1836         GV **fields;
1837         SV **svp;
1838         const char *key;
1839         STRLEN keylen;
1840         SVOP *first_key_op, *key_op;
1841
1842         if ((o->op_private & (OPpLVAL_INTRO))
1843             /* I bet there's always a pushmark... */
1844             || ((LISTOP*)o)->op_first->op_sibling->op_type != OP_LIST)
1845             /* hmmm, no optimization if list contains only one key. */
1846             break;
1847         rop = (UNOP*)((LISTOP*)o)->op_last;
1848         if (rop->op_type != OP_RV2HV)
1849             break;
1850         if (rop->op_first->op_type == OP_PADSV)
1851             /* @$hash{qw(keys here)} */
1852             rop = (UNOP*)rop->op_first;
1853         else {
1854             /* @{$hash}{qw(keys here)} */
1855             if (rop->op_first->op_type == OP_SCOPE
1856                 && cLISTOPx(rop->op_first)->op_last->op_type == OP_PADSV)
1857                 {
1858                     rop = (UNOP*)cLISTOPx(rop->op_first)->op_last;
1859                 }
1860             else
1861                 break;
1862         }
1863
1864         lexname = *av_fetch(PL_comppad_name, rop->op_targ, TRUE);
1865         if (!SvPAD_TYPED(lexname))
1866             break;
1867         fields = (GV**)hv_fetchs(SvSTASH(lexname), "FIELDS", FALSE);
1868         if (!fields || !GvHV(*fields))
1869             break;
1870         /* Again guessing that the pushmark can be jumped over.... */
1871         first_key_op = (SVOP*)((LISTOP*)((LISTOP*)o)->op_first->op_sibling)
1872             ->op_first->op_sibling;
1873         for (key_op = first_key_op; key_op;
1874              key_op = (SVOP*)key_op->op_sibling) {
1875             if (key_op->op_type != OP_CONST)
1876                 continue;
1877             svp = cSVOPx_svp(key_op);
1878             key = SvPV_const(*svp, keylen);
1879             if (!hv_fetch(GvHV(*fields), key,
1880                     SvUTF8(*svp) ? -(I32)keylen : (I32)keylen, FALSE)) {
1881                 Perl_croak(aTHX_ "No such class field \"%"SVf"\" "
1882                            "in variable %"SVf" of type %"HEKf,
1883                       SVfARG(*svp), SVfARG(lexname),
1884                       HEKfARG(HvNAME_HEK(SvSTASH(lexname))));
1885             }
1886         }
1887         break;
1888     }
1889
1890     case OP_SUBST: {
1891         if (cPMOPo->op_pmreplrootu.op_pmreplroot)
1892             finalize_op(cPMOPo->op_pmreplrootu.op_pmreplroot);
1893         break;
1894     }
1895     default:
1896         break;
1897     }
1898
1899     if (o->op_flags & OPf_KIDS) {
1900         OP *kid;
1901         for (kid = cUNOPo->op_first; kid; kid = kid->op_sibling)
1902             finalize_op(kid);
1903     }
1904 }
1905
1906 /*
1907 =for apidoc Amx|OP *|op_lvalue|OP *o|I32 type
1908
1909 Propagate lvalue ("modifiable") context to an op and its children.
1910 I<type> represents the context type, roughly based on the type of op that
1911 would do the modifying, although C<local()> is represented by OP_NULL,
1912 because it has no op type of its own (it is signalled by a flag on
1913 the lvalue op).
1914
1915 This function detects things that can't be modified, such as C<$x+1>, and
1916 generates errors for them. For example, C<$x+1 = 2> would cause it to be
1917 called with an op of type OP_ADD and a C<type> argument of OP_SASSIGN.
1918
1919 It also flags things that need to behave specially in an lvalue context,
1920 such as C<$$x = 5> which might have to vivify a reference in C<$x>.
1921
1922 =cut
1923 */
1924
1925 OP *
1926 Perl_op_lvalue_flags(pTHX_ OP *o, I32 type, U32 flags)
1927 {
1928     dVAR;
1929     OP *kid;
1930     /* -1 = error on localize, 0 = ignore localize, 1 = ok to localize */
1931     int localize = -1;
1932
1933     if (!o || (PL_parser && PL_parser->error_count))
1934         return o;
1935
1936     if ((o->op_private & OPpTARGET_MY)
1937         && (PL_opargs[o->op_type] & OA_TARGLEX))/* OPp share the meaning */
1938     {
1939         return o;
1940     }
1941
1942     assert( (o->op_flags & OPf_WANT) != OPf_WANT_VOID );
1943
1944     if (type == OP_PRTF || type == OP_SPRINTF) type = OP_ENTERSUB;
1945
1946     switch (o->op_type) {
1947     case OP_UNDEF:
1948         PL_modcount++;
1949         return o;
1950     case OP_STUB:
1951         if ((o->op_flags & OPf_PARENS) || PL_madskills)
1952             break;
1953         goto nomod;
1954     case OP_ENTERSUB:
1955         if ((type == OP_UNDEF || type == OP_REFGEN || type == OP_LOCK) &&
1956             !(o->op_flags & OPf_STACKED)) {
1957             o->op_type = OP_RV2CV;              /* entersub => rv2cv */
1958             /* Both ENTERSUB and RV2CV use this bit, but for different pur-
1959                poses, so we need it clear.  */
1960             o->op_private &= ~1;
1961             o->op_ppaddr = PL_ppaddr[OP_RV2CV];
1962             assert(cUNOPo->op_first->op_type == OP_NULL);
1963             op_null(((LISTOP*)cUNOPo->op_first)->op_first);/* disable pushmark */
1964             break;
1965         }
1966         else {                          /* lvalue subroutine call */
1967             o->op_private |= OPpLVAL_INTRO
1968                            |(OPpENTERSUB_INARGS * (type == OP_LEAVESUBLV));
1969             PL_modcount = RETURN_UNLIMITED_NUMBER;
1970             if (type == OP_GREPSTART || type == OP_ENTERSUB || type == OP_REFGEN) {
1971                 /* Potential lvalue context: */
1972                 o->op_private |= OPpENTERSUB_INARGS;
1973                 break;
1974             }
1975             else {                      /* Compile-time error message: */
1976                 OP *kid = cUNOPo->op_first;
1977                 CV *cv;
1978
1979                 if (kid->op_type != OP_PUSHMARK) {
1980                     if (kid->op_type != OP_NULL || kid->op_targ != OP_LIST)
1981                         Perl_croak(aTHX_
1982                                 "panic: unexpected lvalue entersub "
1983                                 "args: type/targ %ld:%"UVuf,
1984                                 (long)kid->op_type, (UV)kid->op_targ);
1985                     kid = kLISTOP->op_first;
1986                 }
1987                 while (kid->op_sibling)
1988                     kid = kid->op_sibling;
1989                 if (!(kid->op_type == OP_NULL && kid->op_targ == OP_RV2CV)) {
1990                     break;      /* Postpone until runtime */
1991                 }
1992
1993                 kid = kUNOP->op_first;
1994                 if (kid->op_type == OP_NULL && kid->op_targ == OP_RV2SV)
1995                     kid = kUNOP->op_first;
1996                 if (kid->op_type == OP_NULL)
1997                     Perl_croak(aTHX_
1998                                "Unexpected constant lvalue entersub "
1999                                "entry via type/targ %ld:%"UVuf,
2000                                (long)kid->op_type, (UV)kid->op_targ);
2001                 if (kid->op_type != OP_GV) {
2002                     break;
2003                 }
2004
2005                 cv = GvCV(kGVOP_gv);
2006                 if (!cv)
2007                     break;
2008                 if (CvLVALUE(cv))
2009                     break;
2010             }
2011         }
2012         /* FALL THROUGH */
2013     default:
2014       nomod:
2015         if (flags & OP_LVALUE_NO_CROAK) return NULL;
2016         /* grep, foreach, subcalls, refgen */
2017         if (type == OP_GREPSTART || type == OP_ENTERSUB
2018          || type == OP_REFGEN    || type == OP_LEAVESUBLV)
2019             break;
2020         yyerror(Perl_form(aTHX_ "Can't modify %s in %s",
2021                      (o->op_type == OP_NULL && (o->op_flags & OPf_SPECIAL)
2022                       ? "do block"
2023                       : (o->op_type == OP_ENTERSUB
2024                         ? "non-lvalue subroutine call"
2025                         : OP_DESC(o))),
2026                      type ? PL_op_desc[type] : "local"));
2027         return o;
2028
2029     case OP_PREINC:
2030     case OP_PREDEC:
2031     case OP_POW:
2032     case OP_MULTIPLY:
2033     case OP_DIVIDE:
2034     case OP_MODULO:
2035     case OP_REPEAT:
2036     case OP_ADD:
2037     case OP_SUBTRACT:
2038     case OP_CONCAT:
2039     case OP_LEFT_SHIFT:
2040     case OP_RIGHT_SHIFT:
2041     case OP_BIT_AND:
2042     case OP_BIT_XOR:
2043     case OP_BIT_OR:
2044     case OP_I_MULTIPLY:
2045     case OP_I_DIVIDE:
2046     case OP_I_MODULO:
2047     case OP_I_ADD:
2048     case OP_I_SUBTRACT:
2049         if (!(o->op_flags & OPf_STACKED))
2050             goto nomod;
2051         PL_modcount++;
2052         break;
2053
2054     case OP_COND_EXPR:
2055         localize = 1;
2056         for (kid = cUNOPo->op_first->op_sibling; kid; kid = kid->op_sibling)
2057             op_lvalue(kid, type);
2058         break;
2059
2060     case OP_RV2AV:
2061     case OP_RV2HV:
2062         if (type == OP_REFGEN && o->op_flags & OPf_PARENS) {
2063            PL_modcount = RETURN_UNLIMITED_NUMBER;
2064             return o;           /* Treat \(@foo) like ordinary list. */
2065         }
2066         /* FALL THROUGH */
2067     case OP_RV2GV:
2068         if (scalar_mod_type(o, type))
2069             goto nomod;
2070         ref(cUNOPo->op_first, o->op_type);
2071         /* FALL THROUGH */
2072     case OP_ASLICE:
2073     case OP_HSLICE:
2074         localize = 1;
2075         /* FALL THROUGH */
2076     case OP_AASSIGN:
2077         if (type == OP_LEAVESUBLV)
2078             o->op_private |= OPpMAYBE_LVSUB;
2079         /* FALL THROUGH */
2080     case OP_NEXTSTATE:
2081     case OP_DBSTATE:
2082        PL_modcount = RETURN_UNLIMITED_NUMBER;
2083         break;
2084     case OP_AV2ARYLEN:
2085         PL_hints |= HINT_BLOCK_SCOPE;
2086         if (type == OP_LEAVESUBLV)
2087             o->op_private |= OPpMAYBE_LVSUB;
2088         PL_modcount++;
2089         break;
2090     case OP_RV2SV:
2091         ref(cUNOPo->op_first, o->op_type);
2092         localize = 1;
2093         /* FALL THROUGH */
2094     case OP_GV:
2095         PL_hints |= HINT_BLOCK_SCOPE;
2096     case OP_SASSIGN:
2097     case OP_ANDASSIGN:
2098     case OP_ORASSIGN:
2099     case OP_DORASSIGN:
2100         PL_modcount++;
2101         break;
2102
2103     case OP_AELEMFAST:
2104     case OP_AELEMFAST_LEX:
2105         localize = -1;
2106         PL_modcount++;
2107         break;
2108
2109     case OP_PADAV:
2110     case OP_PADHV:
2111        PL_modcount = RETURN_UNLIMITED_NUMBER;
2112         if (type == OP_REFGEN && o->op_flags & OPf_PARENS)
2113             return o;           /* Treat \(@foo) like ordinary list. */
2114         if (scalar_mod_type(o, type))
2115             goto nomod;
2116         if (type == OP_LEAVESUBLV)
2117             o->op_private |= OPpMAYBE_LVSUB;
2118         /* FALL THROUGH */
2119     case OP_PADSV:
2120         PL_modcount++;
2121         if (!type) /* local() */
2122             Perl_croak(aTHX_ "Can't localize lexical variable %"SVf,
2123                  PAD_COMPNAME_SV(o->op_targ));
2124         break;
2125
2126     case OP_PUSHMARK:
2127         localize = 0;
2128         break;
2129
2130     case OP_KEYS:
2131     case OP_RKEYS:
2132         if (type != OP_SASSIGN && type != OP_LEAVESUBLV)
2133             goto nomod;
2134         goto lvalue_func;
2135     case OP_SUBSTR:
2136         if (o->op_private == 4) /* don't allow 4 arg substr as lvalue */
2137             goto nomod;
2138         /* FALL THROUGH */
2139     case OP_POS:
2140     case OP_VEC:
2141       lvalue_func:
2142         if (type == OP_LEAVESUBLV)
2143             o->op_private |= OPpMAYBE_LVSUB;
2144         pad_free(o->op_targ);
2145         o->op_targ = pad_alloc(o->op_type, SVs_PADMY);
2146         assert(SvTYPE(PAD_SV(o->op_targ)) == SVt_NULL);
2147         if (o->op_flags & OPf_KIDS)
2148             op_lvalue(cBINOPo->op_first->op_sibling, type);
2149         break;
2150
2151     case OP_AELEM:
2152     case OP_HELEM:
2153         ref(cBINOPo->op_first, o->op_type);
2154         if (type == OP_ENTERSUB &&
2155              !(o->op_private & (OPpLVAL_INTRO | OPpDEREF)))
2156             o->op_private |= OPpLVAL_DEFER;
2157         if (type == OP_LEAVESUBLV)
2158             o->op_private |= OPpMAYBE_LVSUB;
2159         localize = 1;
2160         PL_modcount++;
2161         break;
2162
2163     case OP_SCOPE:
2164     case OP_LEAVE:
2165     case OP_ENTER:
2166     case OP_LINESEQ:
2167         localize = 0;
2168         if (o->op_flags & OPf_KIDS)
2169             op_lvalue(cLISTOPo->op_last, type);
2170         break;
2171
2172     case OP_NULL:
2173         localize = 0;
2174         if (o->op_flags & OPf_SPECIAL)          /* do BLOCK */
2175             goto nomod;
2176         else if (!(o->op_flags & OPf_KIDS))
2177             break;
2178         if (o->op_targ != OP_LIST) {
2179             op_lvalue(cBINOPo->op_first, type);
2180             break;
2181         }
2182         /* FALL THROUGH */
2183     case OP_LIST:
2184         localize = 0;
2185         for (kid = cLISTOPo->op_first; kid; kid = kid->op_sibling)
2186             /* elements might be in void context because the list is
2187                in scalar context or because they are attribute sub calls */
2188             if ( (kid->op_flags & OPf_WANT) != OPf_WANT_VOID )
2189                 op_lvalue(kid, type);
2190         break;
2191
2192     case OP_RETURN:
2193         if (type != OP_LEAVESUBLV)
2194             goto nomod;
2195         break; /* op_lvalue()ing was handled by ck_return() */
2196
2197     case OP_COREARGS:
2198         return o;
2199     }
2200
2201     /* [20011101.069] File test operators interpret OPf_REF to mean that
2202        their argument is a filehandle; thus \stat(".") should not set
2203        it. AMS 20011102 */
2204     if (type == OP_REFGEN &&
2205         PL_check[o->op_type] == Perl_ck_ftst)
2206         return o;
2207
2208     if (type != OP_LEAVESUBLV)
2209         o->op_flags |= OPf_MOD;
2210
2211     if (type == OP_AASSIGN || type == OP_SASSIGN)
2212         o->op_flags |= OPf_SPECIAL|OPf_REF;
2213     else if (!type) { /* local() */
2214         switch (localize) {
2215         case 1:
2216             o->op_private |= OPpLVAL_INTRO;
2217             o->op_flags &= ~OPf_SPECIAL;
2218             PL_hints |= HINT_BLOCK_SCOPE;
2219             break;
2220         case 0:
2221             break;
2222         case -1:
2223             Perl_ck_warner(aTHX_ packWARN(WARN_SYNTAX),
2224                            "Useless localization of %s", OP_DESC(o));
2225         }
2226     }
2227     else if (type != OP_GREPSTART && type != OP_ENTERSUB
2228              && type != OP_LEAVESUBLV)
2229         o->op_flags |= OPf_REF;
2230     return o;
2231 }
2232
2233 STATIC bool
2234 S_scalar_mod_type(const OP *o, I32 type)
2235 {
2236     switch (type) {
2237     case OP_POS:
2238     case OP_SASSIGN:
2239         if (o && o->op_type == OP_RV2GV)
2240             return FALSE;
2241         /* FALL THROUGH */
2242     case OP_PREINC:
2243     case OP_PREDEC:
2244     case OP_POSTINC:
2245     case OP_POSTDEC:
2246     case OP_I_PREINC:
2247     case OP_I_PREDEC:
2248     case OP_I_POSTINC:
2249     case OP_I_POSTDEC:
2250     case OP_POW:
2251     case OP_MULTIPLY:
2252     case OP_DIVIDE:
2253     case OP_MODULO:
2254     case OP_REPEAT:
2255     case OP_ADD:
2256     case OP_SUBTRACT:
2257     case OP_I_MULTIPLY:
2258     case OP_I_DIVIDE:
2259     case OP_I_MODULO:
2260     case OP_I_ADD:
2261     case OP_I_SUBTRACT:
2262     case OP_LEFT_SHIFT:
2263     case OP_RIGHT_SHIFT:
2264     case OP_BIT_AND:
2265     case OP_BIT_XOR:
2266     case OP_BIT_OR:
2267     case OP_CONCAT:
2268     case OP_SUBST:
2269     case OP_TRANS:
2270     case OP_TRANSR:
2271     case OP_READ:
2272     case OP_SYSREAD:
2273     case OP_RECV:
2274     case OP_ANDASSIGN:
2275     case OP_ORASSIGN:
2276     case OP_DORASSIGN:
2277         return TRUE;
2278     default:
2279         return FALSE;
2280     }
2281 }
2282
2283 STATIC bool
2284 S_is_handle_constructor(const OP *o, I32 numargs)
2285 {
2286     PERL_ARGS_ASSERT_IS_HANDLE_CONSTRUCTOR;
2287
2288     switch (o->op_type) {
2289     case OP_PIPE_OP:
2290     case OP_SOCKPAIR:
2291         if (numargs == 2)
2292             return TRUE;
2293         /* FALL THROUGH */
2294     case OP_SYSOPEN:
2295     case OP_OPEN:
2296     case OP_SELECT:             /* XXX c.f. SelectSaver.pm */
2297     case OP_SOCKET:
2298     case OP_OPEN_DIR:
2299     case OP_ACCEPT:
2300         if (numargs == 1)
2301             return TRUE;
2302         /* FALLTHROUGH */
2303     default:
2304         return FALSE;
2305     }
2306 }
2307
2308 static OP *
2309 S_refkids(pTHX_ OP *o, I32 type)
2310 {
2311     if (o && o->op_flags & OPf_KIDS) {
2312         OP *kid;
2313         for (kid = cLISTOPo->op_first; kid; kid = kid->op_sibling)
2314             ref(kid, type);
2315     }
2316     return o;
2317 }
2318
2319 OP *
2320 Perl_doref(pTHX_ OP *o, I32 type, bool set_op_ref)
2321 {
2322     dVAR;
2323     OP *kid;
2324
2325     PERL_ARGS_ASSERT_DOREF;
2326
2327     if (!o || (PL_parser && PL_parser->error_count))
2328         return o;
2329
2330     switch (o->op_type) {
2331     case OP_ENTERSUB:
2332         if ((type == OP_EXISTS || type == OP_DEFINED) &&
2333             !(o->op_flags & OPf_STACKED)) {
2334             o->op_type = OP_RV2CV;             /* entersub => rv2cv */
2335             o->op_ppaddr = PL_ppaddr[OP_RV2CV];
2336             assert(cUNOPo->op_first->op_type == OP_NULL);
2337             op_null(((LISTOP*)cUNOPo->op_first)->op_first);     /* disable pushmark */
2338             o->op_flags |= OPf_SPECIAL;
2339             o->op_private &= ~1;
2340         }
2341         else if (type == OP_RV2SV || type == OP_RV2AV || type == OP_RV2HV){
2342             o->op_private |= (type == OP_RV2AV ? OPpDEREF_AV
2343                               : type == OP_RV2HV ? OPpDEREF_HV
2344                               : OPpDEREF_SV);
2345             o->op_flags |= OPf_MOD;
2346         }
2347
2348         break;
2349
2350     case OP_COND_EXPR:
2351         for (kid = cUNOPo->op_first->op_sibling; kid; kid = kid->op_sibling)
2352             doref(kid, type, set_op_ref);
2353         break;
2354     case OP_RV2SV:
2355         if (type == OP_DEFINED)
2356             o->op_flags |= OPf_SPECIAL;         /* don't create GV */
2357         doref(cUNOPo->op_first, o->op_type, set_op_ref);
2358         /* FALL THROUGH */
2359     case OP_PADSV:
2360         if (type == OP_RV2SV || type == OP_RV2AV || type == OP_RV2HV) {
2361             o->op_private |= (type == OP_RV2AV ? OPpDEREF_AV
2362                               : type == OP_RV2HV ? OPpDEREF_HV
2363                               : OPpDEREF_SV);
2364             o->op_flags |= OPf_MOD;
2365         }
2366         break;
2367
2368     case OP_RV2AV:
2369     case OP_RV2HV:
2370         if (set_op_ref)
2371             o->op_flags |= OPf_REF;
2372         /* FALL THROUGH */
2373     case OP_RV2GV:
2374         if (type == OP_DEFINED)
2375             o->op_flags |= OPf_SPECIAL;         /* don't create GV */
2376         doref(cUNOPo->op_first, o->op_type, set_op_ref);
2377         break;
2378
2379     case OP_PADAV:
2380     case OP_PADHV:
2381         if (set_op_ref)
2382             o->op_flags |= OPf_REF;
2383         break;
2384
2385     case OP_SCALAR:
2386     case OP_NULL:
2387         if (!(o->op_flags & OPf_KIDS) || type == OP_DEFINED)
2388             break;
2389         doref(cBINOPo->op_first, type, set_op_ref);
2390         break;
2391     case OP_AELEM:
2392     case OP_HELEM:
2393         doref(cBINOPo->op_first, o->op_type, set_op_ref);
2394         if (type == OP_RV2SV || type == OP_RV2AV || type == OP_RV2HV) {
2395             o->op_private |= (type == OP_RV2AV ? OPpDEREF_AV
2396                               : type == OP_RV2HV ? OPpDEREF_HV
2397                               : OPpDEREF_SV);
2398             o->op_flags |= OPf_MOD;
2399         }
2400         break;
2401
2402     case OP_SCOPE:
2403     case OP_LEAVE:
2404         set_op_ref = FALSE;
2405         /* FALL THROUGH */
2406     case OP_ENTER:
2407     case OP_LIST:
2408         if (!(o->op_flags & OPf_KIDS))
2409             break;
2410         doref(cLISTOPo->op_last, type, set_op_ref);
2411         break;
2412     default:
2413         break;
2414     }
2415     return scalar(o);
2416
2417 }
2418
2419 STATIC OP *
2420 S_dup_attrlist(pTHX_ OP *o)
2421 {
2422     dVAR;
2423     OP *rop;
2424
2425     PERL_ARGS_ASSERT_DUP_ATTRLIST;
2426
2427     /* An attrlist is either a simple OP_CONST or an OP_LIST with kids,
2428      * where the first kid is OP_PUSHMARK and the remaining ones
2429      * are OP_CONST.  We need to push the OP_CONST values.
2430      */
2431     if (o->op_type == OP_CONST)
2432         rop = newSVOP(OP_CONST, o->op_flags, SvREFCNT_inc_NN(cSVOPo->op_sv));
2433 #ifdef PERL_MAD
2434     else if (o->op_type == OP_NULL)
2435         rop = NULL;
2436 #endif
2437     else {
2438         assert((o->op_type == OP_LIST) && (o->op_flags & OPf_KIDS));
2439         rop = NULL;
2440         for (o = cLISTOPo->op_first; o; o=o->op_sibling) {
2441             if (o->op_type == OP_CONST)
2442                 rop = op_append_elem(OP_LIST, rop,
2443                                   newSVOP(OP_CONST, o->op_flags,
2444                                           SvREFCNT_inc_NN(cSVOPo->op_sv)));
2445         }
2446     }
2447     return rop;
2448 }
2449
2450 STATIC void
2451 S_apply_attrs(pTHX_ HV *stash, SV *target, OP *attrs)
2452 {
2453     dVAR;
2454     SV * const stashsv = stash ? newSVhek(HvNAME_HEK(stash)) : &PL_sv_no;
2455
2456     PERL_ARGS_ASSERT_APPLY_ATTRS;
2457
2458     /* fake up C<use attributes $pkg,$rv,@attrs> */
2459     ENTER;              /* need to protect against side-effects of 'use' */
2460
2461 #define ATTRSMODULE "attributes"
2462 #define ATTRSMODULE_PM "attributes.pm"
2463
2464     Perl_load_module(aTHX_ PERL_LOADMOD_IMPORT_OPS,
2465                          newSVpvs(ATTRSMODULE),
2466                          NULL,
2467                          op_prepend_elem(OP_LIST,
2468                                       newSVOP(OP_CONST, 0, stashsv),
2469                                       op_prepend_elem(OP_LIST,
2470                                                    newSVOP(OP_CONST, 0,
2471                                                            newRV(target)),
2472                                                    dup_attrlist(attrs))));
2473     LEAVE;
2474 }
2475
2476 STATIC void
2477 S_apply_attrs_my(pTHX_ HV *stash, OP *target, OP *attrs, OP **imopsp)
2478 {
2479     dVAR;
2480     OP *pack, *imop, *arg;
2481     SV *meth, *stashsv, **svp;
2482
2483     PERL_ARGS_ASSERT_APPLY_ATTRS_MY;
2484
2485     if (!attrs)
2486         return;
2487
2488     assert(target->op_type == OP_PADSV ||
2489            target->op_type == OP_PADHV ||
2490            target->op_type == OP_PADAV);
2491
2492     /* Ensure that attributes.pm is loaded. */
2493     ENTER;              /* need to protect against side-effects of 'use' */
2494     /* Don't force the C<use> if we don't need it. */
2495     svp = hv_fetchs(GvHVn(PL_incgv), ATTRSMODULE_PM, FALSE);
2496     if (svp && *svp != &PL_sv_undef)
2497         NOOP;   /* already in %INC */
2498     else
2499         Perl_load_module(aTHX_ PERL_LOADMOD_NOIMPORT,
2500                                newSVpvs(ATTRSMODULE), NULL);
2501     LEAVE;
2502
2503     /* Need package name for method call. */
2504     pack = newSVOP(OP_CONST, 0, newSVpvs(ATTRSMODULE));
2505
2506     /* Build up the real arg-list. */
2507     stashsv = stash ? newSVhek(HvNAME_HEK(stash)) : &PL_sv_no;
2508
2509     arg = newOP(OP_PADSV, 0);
2510     arg->op_targ = target->op_targ;
2511     arg = op_prepend_elem(OP_LIST,
2512                        newSVOP(OP_CONST, 0, stashsv),
2513                        op_prepend_elem(OP_LIST,
2514                                     newUNOP(OP_REFGEN, 0,
2515                                             op_lvalue(arg, OP_REFGEN)),
2516                                     dup_attrlist(attrs)));
2517
2518     /* Fake up a method call to import */
2519     meth = newSVpvs_share("import");
2520     imop = convert(OP_ENTERSUB, OPf_STACKED|OPf_SPECIAL|OPf_WANT_VOID,
2521                    op_append_elem(OP_LIST,
2522                                op_prepend_elem(OP_LIST, pack, list(arg)),
2523                                newSVOP(OP_METHOD_NAMED, 0, meth)));
2524
2525     /* Combine the ops. */
2526     *imopsp = op_append_elem(OP_LIST, *imopsp, imop);
2527 }
2528
2529 /*
2530 =notfor apidoc apply_attrs_string
2531
2532 Attempts to apply a list of attributes specified by the C<attrstr> and
2533 C<len> arguments to the subroutine identified by the C<cv> argument which
2534 is expected to be associated with the package identified by the C<stashpv>
2535 argument (see L<attributes>).  It gets this wrong, though, in that it
2536 does not correctly identify the boundaries of the individual attribute
2537 specifications within C<attrstr>.  This is not really intended for the
2538 public API, but has to be listed here for systems such as AIX which
2539 need an explicit export list for symbols.  (It's called from XS code
2540 in support of the C<ATTRS:> keyword from F<xsubpp>.)  Patches to fix it
2541 to respect attribute syntax properly would be welcome.
2542
2543 =cut
2544 */
2545
2546 void
2547 Perl_apply_attrs_string(pTHX_ const char *stashpv, CV *cv,
2548                         const char *attrstr, STRLEN len)
2549 {
2550     OP *attrs = NULL;
2551
2552     PERL_ARGS_ASSERT_APPLY_ATTRS_STRING;
2553
2554     if (!len) {
2555         len = strlen(attrstr);
2556     }
2557
2558     while (len) {
2559         for (; isSPACE(*attrstr) && len; --len, ++attrstr) ;
2560         if (len) {
2561             const char * const sstr = attrstr;
2562             for (; !isSPACE(*attrstr) && len; --len, ++attrstr) ;
2563             attrs = op_append_elem(OP_LIST, attrs,
2564                                 newSVOP(OP_CONST, 0,
2565                                         newSVpvn(sstr, attrstr-sstr)));
2566         }
2567     }
2568
2569     Perl_load_module(aTHX_ PERL_LOADMOD_IMPORT_OPS,
2570                      newSVpvs(ATTRSMODULE),
2571                      NULL, op_prepend_elem(OP_LIST,
2572                                   newSVOP(OP_CONST, 0, newSVpv(stashpv,0)),
2573                                   op_prepend_elem(OP_LIST,
2574                                                newSVOP(OP_CONST, 0,
2575                                                        newRV(MUTABLE_SV(cv))),
2576                                                attrs)));
2577 }
2578
2579 STATIC OP *
2580 S_my_kid(pTHX_ OP *o, OP *attrs, OP **imopsp)
2581 {
2582     dVAR;
2583     I32 type;
2584     const bool stately = PL_parser && PL_parser->in_my == KEY_state;
2585
2586     PERL_ARGS_ASSERT_MY_KID;
2587
2588     if (!o || (PL_parser && PL_parser->error_count))
2589         return o;
2590
2591     type = o->op_type;
2592     if (PL_madskills && type == OP_NULL && o->op_flags & OPf_KIDS) {
2593         (void)my_kid(cUNOPo->op_first, attrs, imopsp);
2594         return o;
2595     }
2596
2597     if (type == OP_LIST) {
2598         OP *kid;
2599         for (kid = cLISTOPo->op_first; kid; kid = kid->op_sibling)
2600             my_kid(kid, attrs, imopsp);
2601         return o;
2602     } else if (type == OP_UNDEF || type == OP_STUB) {
2603         return o;
2604     } else if (type == OP_RV2SV ||      /* "our" declaration */
2605                type == OP_RV2AV ||
2606                type == OP_RV2HV) { /* XXX does this let anything illegal in? */
2607         if (cUNOPo->op_first->op_type != OP_GV) { /* MJD 20011224 */
2608             yyerror(Perl_form(aTHX_ "Can't declare %s in \"%s\"",
2609                         OP_DESC(o),
2610                         PL_parser->in_my == KEY_our
2611                             ? "our"
2612                             : PL_parser->in_my == KEY_state ? "state" : "my"));
2613         } else if (attrs) {
2614             GV * const gv = cGVOPx_gv(cUNOPo->op_first);
2615             PL_parser->in_my = FALSE;
2616             PL_parser->in_my_stash = NULL;
2617             apply_attrs(GvSTASH(gv),
2618                         (type == OP_RV2SV ? GvSV(gv) :
2619                          type == OP_RV2AV ? MUTABLE_SV(GvAV(gv)) :
2620                          type == OP_RV2HV ? MUTABLE_SV(GvHV(gv)) : MUTABLE_SV(gv)),
2621                         attrs);
2622         }
2623         o->op_private |= OPpOUR_INTRO;
2624         return o;
2625     }
2626     else if (type != OP_PADSV &&
2627              type != OP_PADAV &&
2628              type != OP_PADHV &&
2629              type != OP_PUSHMARK)
2630     {
2631         yyerror(Perl_form(aTHX_ "Can't declare %s in \"%s\"",
2632                           OP_DESC(o),
2633                           PL_parser->in_my == KEY_our
2634                             ? "our"
2635                             : PL_parser->in_my == KEY_state ? "state" : "my"));
2636         return o;
2637     }
2638     else if (attrs && type != OP_PUSHMARK) {
2639         HV *stash;
2640
2641         PL_parser->in_my = FALSE;
2642         PL_parser->in_my_stash = NULL;
2643
2644         /* check for C<my Dog $spot> when deciding package */
2645         stash = PAD_COMPNAME_TYPE(o->op_targ);
2646         if (!stash)
2647             stash = PL_curstash;
2648         apply_attrs_my(stash, o, attrs, imopsp);
2649     }
2650     o->op_flags |= OPf_MOD;
2651     o->op_private |= OPpLVAL_INTRO;
2652     if (stately)
2653         o->op_private |= OPpPAD_STATE;
2654     return o;
2655 }
2656
2657 OP *
2658 Perl_my_attrs(pTHX_ OP *o, OP *attrs)
2659 {
2660     dVAR;
2661     OP *rops;
2662     int maybe_scalar = 0;
2663
2664     PERL_ARGS_ASSERT_MY_ATTRS;
2665
2666 /* [perl #17376]: this appears to be premature, and results in code such as
2667    C< our(%x); > executing in list mode rather than void mode */
2668 #if 0
2669     if (o->op_flags & OPf_PARENS)
2670         list(o);
2671     else
2672         maybe_scalar = 1;
2673 #else
2674     maybe_scalar = 1;
2675 #endif
2676     if (attrs)
2677         SAVEFREEOP(attrs);
2678     rops = NULL;
2679     o = my_kid(o, attrs, &rops);
2680     if (rops) {
2681         if (maybe_scalar && o->op_type == OP_PADSV) {
2682             o = scalar(op_append_list(OP_LIST, rops, o));
2683             o->op_private |= OPpLVAL_INTRO;
2684         }
2685         else {
2686             /* The listop in rops might have a pushmark at the beginning,
2687                which will mess up list assignment. */
2688             LISTOP * const lrops = (LISTOP *)rops; /* for brevity */
2689             if (rops->op_type == OP_LIST &&
2690                 lrops->op_first && lrops->op_first->op_type == OP_PUSHMARK)
2691             {
2692                 OP * const pushmark = lrops->op_first;
2693                 lrops->op_first = pushmark->op_sibling;
2694                 op_free(pushmark);
2695             }
2696             o = op_append_list(OP_LIST, o, rops);
2697         }
2698     }
2699     PL_parser->in_my = FALSE;
2700     PL_parser->in_my_stash = NULL;
2701     return o;
2702 }
2703
2704 OP *
2705 Perl_sawparens(pTHX_ OP *o)
2706 {
2707     PERL_UNUSED_CONTEXT;
2708     if (o)
2709         o->op_flags |= OPf_PARENS;
2710     return o;
2711 }
2712
2713 OP *
2714 Perl_bind_match(pTHX_ I32 type, OP *left, OP *right)
2715 {
2716     OP *o;
2717     bool ismatchop = 0;
2718     const OPCODE ltype = left->op_type;
2719     const OPCODE rtype = right->op_type;
2720
2721     PERL_ARGS_ASSERT_BIND_MATCH;
2722
2723     if ( (ltype == OP_RV2AV || ltype == OP_RV2HV || ltype == OP_PADAV
2724           || ltype == OP_PADHV) && ckWARN(WARN_MISC))
2725     {
2726       const char * const desc
2727           = PL_op_desc[(
2728                           rtype == OP_SUBST || rtype == OP_TRANS
2729                        || rtype == OP_TRANSR
2730                        )
2731                        ? (int)rtype : OP_MATCH];
2732       const bool isary = ltype == OP_RV2AV || ltype == OP_PADAV;
2733       GV *gv;
2734       SV * const name =
2735        (ltype == OP_RV2AV || ltype == OP_RV2HV)
2736         ?    cUNOPx(left)->op_first->op_type == OP_GV
2737           && (gv = cGVOPx_gv(cUNOPx(left)->op_first))
2738               ? varname(gv, isary ? '@' : '%', 0, NULL, 0, 1)
2739               : NULL
2740         : varname(
2741            (GV *)PL_compcv, isary ? '@' : '%', left->op_targ, NULL, 0, 1
2742           );
2743       if (name)
2744         Perl_warner(aTHX_ packWARN(WARN_MISC),
2745              "Applying %s to %"SVf" will act on scalar(%"SVf")",
2746              desc, name, name);
2747       else {
2748         const char * const sample = (isary
2749              ? "@array" : "%hash");
2750         Perl_warner(aTHX_ packWARN(WARN_MISC),
2751              "Applying %s to %s will act on scalar(%s)",
2752              desc, sample, sample);
2753       }
2754     }
2755
2756     if (rtype == OP_CONST &&
2757         cSVOPx(right)->op_private & OPpCONST_BARE &&
2758         cSVOPx(right)->op_private & OPpCONST_STRICT)
2759     {
2760         no_bareword_allowed(right);
2761     }
2762
2763     /* !~ doesn't make sense with /r, so error on it for now */
2764     if (rtype == OP_SUBST && (cPMOPx(right)->op_pmflags & PMf_NONDESTRUCT) &&
2765         type == OP_NOT)
2766         yyerror("Using !~ with s///r doesn't make sense");
2767     if (rtype == OP_TRANSR && type == OP_NOT)
2768         yyerror("Using !~ with tr///r doesn't make sense");
2769
2770     ismatchop = (rtype == OP_MATCH ||
2771                  rtype == OP_SUBST ||
2772                  rtype == OP_TRANS || rtype == OP_TRANSR)
2773              && !(right->op_flags & OPf_SPECIAL);
2774     if (ismatchop && right->op_private & OPpTARGET_MY) {
2775         right->op_targ = 0;
2776         right->op_private &= ~OPpTARGET_MY;
2777     }
2778     if (!(right->op_flags & OPf_STACKED) && ismatchop) {
2779         OP *newleft;
2780
2781         right->op_flags |= OPf_STACKED;
2782         if (rtype != OP_MATCH && rtype != OP_TRANSR &&
2783             ! (rtype == OP_TRANS &&
2784                right->op_private & OPpTRANS_IDENTICAL) &&
2785             ! (rtype == OP_SUBST &&
2786                (cPMOPx(right)->op_pmflags & PMf_NONDESTRUCT)))
2787             newleft = op_lvalue(left, rtype);
2788         else
2789             newleft = left;
2790         if (right->op_type == OP_TRANS || right->op_type == OP_TRANSR)
2791             o = newBINOP(OP_NULL, OPf_STACKED, scalar(newleft), right);
2792         else
2793             o = op_prepend_elem(rtype, scalar(newleft), right);
2794         if (type == OP_NOT)
2795             return newUNOP(OP_NOT, 0, scalar(o));
2796         return o;
2797     }
2798     else
2799         return bind_match(type, left,
2800                 pmruntime(newPMOP(OP_MATCH, 0), right, 0, 0));
2801 }
2802
2803 OP *
2804 Perl_invert(pTHX_ OP *o)
2805 {
2806     if (!o)
2807         return NULL;
2808     return newUNOP(OP_NOT, OPf_SPECIAL, scalar(o));
2809 }
2810
2811 /*
2812 =for apidoc Amx|OP *|op_scope|OP *o
2813
2814 Wraps up an op tree with some additional ops so that at runtime a dynamic
2815 scope will be created.  The original ops run in the new dynamic scope,
2816 and then, provided that they exit normally, the scope will be unwound.
2817 The additional ops used to create and unwind the dynamic scope will
2818 normally be an C<enter>/C<leave> pair, but a C<scope> op may be used
2819 instead if the ops are simple enough to not need the full dynamic scope
2820 structure.
2821
2822 =cut
2823 */
2824
2825 OP *
2826 Perl_op_scope(pTHX_ OP *o)
2827 {
2828     dVAR;
2829     if (o) {
2830         if (o->op_flags & OPf_PARENS || PERLDB_NOOPT || TAINTING_get) {
2831             o = op_prepend_elem(OP_LINESEQ, newOP(OP_ENTER, 0), o);
2832             o->op_type = OP_LEAVE;
2833             o->op_ppaddr = PL_ppaddr[OP_LEAVE];
2834         }
2835         else if (o->op_type == OP_LINESEQ) {
2836             OP *kid;
2837             o->op_type = OP_SCOPE;
2838             o->op_ppaddr = PL_ppaddr[OP_SCOPE];
2839             kid = ((LISTOP*)o)->op_first;
2840             if (kid->op_type == OP_NEXTSTATE || kid->op_type == OP_DBSTATE) {
2841                 op_null(kid);
2842
2843                 /* The following deals with things like 'do {1 for 1}' */
2844                 kid = kid->op_sibling;
2845                 if (kid &&
2846                     (kid->op_type == OP_NEXTSTATE || kid->op_type == OP_DBSTATE))
2847                     op_null(kid);
2848             }
2849         }
2850         else
2851             o = newLISTOP(OP_SCOPE, 0, o, NULL);
2852     }
2853     return o;
2854 }
2855
2856 OP *
2857 Perl_op_unscope(pTHX_ OP *o)
2858 {
2859     if (o && o->op_type == OP_LINESEQ) {
2860         OP *kid = cLISTOPo->op_first;
2861         for(; kid; kid = kid->op_sibling)
2862             if (kid->op_type == OP_NEXTSTATE || kid->op_type == OP_DBSTATE)
2863                 op_null(kid);
2864     }
2865     return o;
2866 }
2867
2868 int
2869 Perl_block_start(pTHX_ int full)
2870 {
2871     dVAR;
2872     const int retval = PL_savestack_ix;
2873
2874     pad_block_start(full);
2875     SAVEHINTS();
2876     PL_hints &= ~HINT_BLOCK_SCOPE;
2877     SAVECOMPILEWARNINGS();
2878     PL_compiling.cop_warnings = DUP_WARNINGS(PL_compiling.cop_warnings);
2879
2880     CALL_BLOCK_HOOKS(bhk_start, full);
2881
2882     return retval;
2883 }
2884
2885 OP*
2886 Perl_block_end(pTHX_ I32 floor, OP *seq)
2887 {
2888     dVAR;
2889     const int needblockscope = PL_hints & HINT_BLOCK_SCOPE;
2890     OP* retval = scalarseq(seq);
2891     OP *o;
2892
2893     CALL_BLOCK_HOOKS(bhk_pre_end, &retval);
2894
2895     LEAVE_SCOPE(floor);
2896     CopHINTS_set(&PL_compiling, PL_hints);
2897     if (needblockscope)
2898         PL_hints |= HINT_BLOCK_SCOPE; /* propagate out */
2899     o = pad_leavemy();
2900
2901     if (o) {
2902         /* pad_leavemy has created a sequence of introcv ops for all my
2903            subs declared in the block.  We have to replicate that list with
2904            clonecv ops, to deal with this situation:
2905
2906                sub {
2907                    my sub s1;
2908                    my sub s2;
2909                    sub s1 { state sub foo { \&s2 } }
2910                }->()
2911
2912            Originally, I was going to have introcv clone the CV and turn
2913            off the stale flag.  Since &s1 is declared before &s2, the
2914            introcv op for &s1 is executed (on sub entry) before the one for
2915            &s2.  But the &foo sub inside &s1 (which is cloned when &s1 is
2916            cloned, since it is a state sub) closes over &s2 and expects
2917            to see it in its outer CV’s pad.  If the introcv op clones &s1,
2918            then &s2 is still marked stale.  Since &s1 is not active, and
2919            &foo closes over &s1’s implicit entry for &s2, we get a ‘Varia-
2920            ble will not stay shared’ warning.  Because it is the same stub
2921            that will be used when the introcv op for &s2 is executed, clos-
2922            ing over it is safe.  Hence, we have to turn off the stale flag
2923            on all lexical subs in the block before we clone any of them.
2924            Hence, having introcv clone the sub cannot work.  So we create a
2925            list of ops like this:
2926
2927                lineseq
2928                   |
2929                   +-- introcv
2930                   |
2931                   +-- introcv
2932                   |
2933                   +-- introcv
2934                   |
2935                   .
2936                   .
2937                   .
2938                   |
2939                   +-- clonecv
2940                   |
2941                   +-- clonecv
2942                   |
2943                   +-- clonecv
2944                   |
2945                   .
2946                   .
2947                   .
2948          */
2949         OP *kid = o->op_flags & OPf_KIDS ? cLISTOPo->op_first : o;
2950         OP * const last = o->op_flags & OPf_KIDS ? cLISTOPo->op_last : o;
2951         for (;; kid = kid->op_sibling) {
2952             OP *newkid = newOP(OP_CLONECV, 0);
2953             newkid->op_targ = kid->op_targ;
2954             o = op_append_elem(OP_LINESEQ, o, newkid);
2955             if (kid == last) break;
2956         }
2957         retval = op_prepend_elem(OP_LINESEQ, o, retval);
2958     }
2959
2960     CALL_BLOCK_HOOKS(bhk_post_end, &retval);
2961
2962     return retval;
2963 }
2964
2965 /*
2966 =head1 Compile-time scope hooks
2967
2968 =for apidoc Aox||blockhook_register
2969
2970 Register a set of hooks to be called when the Perl lexical scope changes
2971 at compile time. See L<perlguts/"Compile-time scope hooks">.
2972
2973 =cut
2974 */
2975
2976 void
2977 Perl_blockhook_register(pTHX_ BHK *hk)
2978 {
2979     PERL_ARGS_ASSERT_BLOCKHOOK_REGISTER;
2980
2981     Perl_av_create_and_push(aTHX_ &PL_blockhooks, newSViv(PTR2IV(hk)));
2982 }
2983
2984 STATIC OP *
2985 S_newDEFSVOP(pTHX)
2986 {
2987     dVAR;
2988     const PADOFFSET offset = pad_findmy_pvs("$_", 0);
2989     if (offset == NOT_IN_PAD || PAD_COMPNAME_FLAGS_isOUR(offset)) {
2990         return newSVREF(newGVOP(OP_GV, 0, PL_defgv));
2991     }
2992     else {
2993         OP * const o = newOP(OP_PADSV, 0);
2994         o->op_targ = offset;
2995         return o;
2996     }
2997 }
2998
2999 void
3000 Perl_newPROG(pTHX_ OP *o)
3001 {
3002     dVAR;
3003
3004     PERL_ARGS_ASSERT_NEWPROG;
3005
3006     if (PL_in_eval) {
3007         PERL_CONTEXT *cx;
3008         I32 i;
3009         if (PL_eval_root)
3010                 return;
3011         PL_eval_root = newUNOP(OP_LEAVEEVAL,
3012                                ((PL_in_eval & EVAL_KEEPERR)
3013                                 ? OPf_SPECIAL : 0), o);
3014
3015         cx = &cxstack[cxstack_ix];
3016         assert(CxTYPE(cx) == CXt_EVAL);
3017
3018         if ((cx->blk_gimme & G_WANT) == G_VOID)
3019             scalarvoid(PL_eval_root);
3020         else if ((cx->blk_gimme & G_WANT) == G_ARRAY)
3021             list(PL_eval_root);
3022         else
3023             scalar(PL_eval_root);
3024
3025         PL_eval_start = op_linklist(PL_eval_root);
3026         PL_eval_root->op_private |= OPpREFCOUNTED;
3027         OpREFCNT_set(PL_eval_root, 1);
3028         PL_eval_root->op_next = 0;
3029         i = PL_savestack_ix;
3030         SAVEFREEOP(o);
3031         ENTER;
3032         CALL_PEEP(PL_eval_start);
3033         finalize_optree(PL_eval_root);
3034         LEAVE;
3035         PL_savestack_ix = i;
3036     }
3037     else {
3038         if (o->op_type == OP_STUB) {
3039             /* This block is entered if nothing is compiled for the main
3040                program. This will be the case for an genuinely empty main
3041                program, or one which only has BEGIN blocks etc, so already
3042                run and freed.
3043
3044                Historically (5.000) the guard above was !o. However, commit
3045                f8a08f7b8bd67b28 (Jun 2001), integrated to blead as
3046                c71fccf11fde0068, changed perly.y so that newPROG() is now
3047                called with the output of block_end(), which returns a new
3048                OP_STUB for the case of an empty optree. ByteLoader (and
3049                maybe other things) also take this path, because they set up
3050                PL_main_start and PL_main_root directly, without generating an
3051                optree.
3052
3053                If the parsing the main program aborts (due to parse errors,
3054                or due to BEGIN or similar calling exit), then newPROG()
3055                isn't even called, and hence this code path and its cleanups
3056                are skipped. This shouldn't make a make a difference:
3057                * a non-zero return from perl_parse is a failure, and
3058                  perl_destruct() should be called immediately.
3059                * however, if exit(0) is called during the parse, then
3060                  perl_parse() returns 0, and perl_run() is called. As
3061                  PL_main_start will be NULL, perl_run() will return
3062                  promptly, and the exit code will remain 0.
3063             */
3064
3065             PL_comppad_name = 0;
3066             PL_compcv = 0;
3067             S_op_destroy(aTHX_ o);
3068             return;
3069         }
3070         PL_main_root = op_scope(sawparens(scalarvoid(o)));
3071         PL_curcop = &PL_compiling;
3072         PL_main_start = LINKLIST(PL_main_root);
3073         PL_main_root->op_private |= OPpREFCOUNTED;
3074         OpREFCNT_set(PL_main_root, 1);
3075         PL_main_root->op_next = 0;
3076         CALL_PEEP(PL_main_start);
3077         finalize_optree(PL_main_root);
3078         cv_forget_slab(PL_compcv);
3079         PL_compcv = 0;
3080
3081         /* Register with debugger */
3082         if (PERLDB_INTER) {
3083             CV * const cv = get_cvs("DB::postponed", 0);
3084             if (cv) {
3085                 dSP;
3086                 PUSHMARK(SP);
3087                 XPUSHs(MUTABLE_SV(CopFILEGV(&PL_compiling)));
3088                 PUTBACK;
3089                 call_sv(MUTABLE_SV(cv), G_DISCARD);
3090             }
3091         }
3092     }
3093 }
3094
3095 OP *
3096 Perl_localize(pTHX_ OP *o, I32 lex)
3097 {
3098     dVAR;
3099
3100     PERL_ARGS_ASSERT_LOCALIZE;
3101
3102     if (o->op_flags & OPf_PARENS)
3103 /* [perl #17376]: this appears to be premature, and results in code such as
3104    C< our(%x); > executing in list mode rather than void mode */
3105 #if 0
3106         list(o);
3107 #else
3108         NOOP;
3109 #endif
3110     else {
3111         if ( PL_parser->bufptr > PL_parser->oldbufptr
3112             && PL_parser->bufptr[-1] == ','
3113             && ckWARN(WARN_PARENTHESIS))
3114         {
3115             char *s = PL_parser->bufptr;
3116             bool sigil = FALSE;
3117
3118             /* some heuristics to detect a potential error */
3119             while (*s && (strchr(", \t\n", *s)))
3120                 s++;
3121
3122             while (1) {
3123                 if (*s && strchr("@$%*", *s) && *++s
3124                        && (isWORDCHAR(*s) || UTF8_IS_CONTINUED(*s))) {
3125                     s++;
3126                     sigil = TRUE;
3127                     while (*s && (isWORDCHAR(*s) || UTF8_IS_CONTINUED(*s)))
3128                         s++;
3129                     while (*s && (strchr(", \t\n", *s)))
3130                         s++;
3131                 }
3132                 else
3133                     break;
3134             }
3135             if (sigil && (*s == ';' || *s == '=')) {
3136                 Perl_warner(aTHX_ packWARN(WARN_PARENTHESIS),
3137                                 "Parentheses missing around \"%s\" list",
3138                                 lex
3139                                     ? (PL_parser->in_my == KEY_our
3140                                         ? "our"
3141                                         : PL_parser->in_my == KEY_state
3142                                             ? "state"
3143                                             : "my")
3144                                     : "local");
3145             }
3146         }
3147     }
3148     if (lex)
3149         o = my(o);
3150     else
3151         o = op_lvalue(o, OP_NULL);              /* a bit kludgey */
3152     PL_parser->in_my = FALSE;
3153     PL_parser->in_my_stash = NULL;
3154     return o;
3155 }
3156
3157 OP *
3158 Perl_jmaybe(pTHX_ OP *o)
3159 {
3160     PERL_ARGS_ASSERT_JMAYBE;
3161
3162     if (o->op_type == OP_LIST) {
3163         OP * const o2
3164             = newSVREF(newGVOP(OP_GV, 0, gv_fetchpvs(";", GV_ADD|GV_NOTQUAL, SVt_PV)));
3165         o = convert(OP_JOIN, 0, op_prepend_elem(OP_LIST, o2, o));
3166     }
3167     return o;
3168 }
3169
3170 PERL_STATIC_INLINE OP *
3171 S_op_std_init(pTHX_ OP *o)
3172 {
3173     I32 type = o->op_type;
3174
3175     PERL_ARGS_ASSERT_OP_STD_INIT;
3176
3177     if (PL_opargs[type] & OA_RETSCALAR)
3178         scalar(o);
3179     if (PL_opargs[type] & OA_TARGET && !o->op_targ)
3180         o->op_targ = pad_alloc(type, SVs_PADTMP);
3181
3182     return o;
3183 }
3184
3185 PERL_STATIC_INLINE OP *
3186 S_op_integerize(pTHX_ OP *o)
3187 {
3188     I32 type = o->op_type;
3189
3190     PERL_ARGS_ASSERT_OP_INTEGERIZE;
3191
3192     /* integerize op. */
3193     if ((PL_opargs[type] & OA_OTHERINT) && (PL_hints & HINT_INTEGER))
3194     {
3195         dVAR;
3196         o->op_ppaddr = PL_ppaddr[type = ++(o->op_type)];
3197     }
3198
3199     if (type == OP_NEGATE)
3200         /* XXX might want a ck_negate() for this */
3201         cUNOPo->op_first->op_private &= ~OPpCONST_STRICT;
3202
3203     return o;
3204 }
3205
3206 static OP *
3207 S_fold_constants(pTHX_ OP *o)
3208 {
3209     dVAR;
3210     OP * VOL curop;
3211     OP *newop;
3212     VOL I32 type = o->op_type;
3213     SV * VOL sv = NULL;
3214     int ret = 0;
3215     I32 oldscope;
3216     OP *old_next;
3217     SV * const oldwarnhook = PL_warnhook;
3218     SV * const olddiehook  = PL_diehook;
3219     COP not_compiling;
3220     dJMPENV;
3221
3222     PERL_ARGS_ASSERT_FOLD_CONSTANTS;
3223
3224     if (!(PL_opargs[type] & OA_FOLDCONST))
3225         goto nope;
3226
3227     switch (type) {
3228     case OP_UCFIRST:
3229     case OP_LCFIRST:
3230     case OP_UC:
3231     case OP_LC:
3232     case OP_SLT:
3233     case OP_SGT:
3234     case OP_SLE:
3235     case OP_SGE:
3236     case OP_SCMP:
3237     case OP_SPRINTF:
3238         /* XXX what about the numeric ops? */
3239         if (IN_LOCALE_COMPILETIME)
3240             goto nope;
3241         break;
3242     case OP_PACK:
3243         if (!cLISTOPo->op_first->op_sibling
3244           || cLISTOPo->op_first->op_sibling->op_type != OP_CONST)
3245             goto nope;
3246         {
3247             SV * const sv = cSVOPx_sv(cLISTOPo->op_first->op_sibling);
3248             if (!SvPOK(sv) || SvGMAGICAL(sv)) goto nope;
3249             {
3250                 const char *s = SvPVX_const(sv);
3251                 while (s < SvEND(sv)) {
3252                     if (*s == 'p' || *s == 'P') goto nope;
3253                     s++;
3254                 }
3255             }
3256         }
3257         break;
3258     case OP_REPEAT:
3259         if (o->op_private & OPpREPEAT_DOLIST) goto nope;
3260     }
3261
3262     if (PL_parser && PL_parser->error_count)
3263         goto nope;              /* Don't try to run w/ errors */
3264
3265     for (curop = LINKLIST(o); curop != o; curop = LINKLIST(curop)) {
3266         const OPCODE type = curop->op_type;
3267         if ((type != OP_CONST || (curop->op_private & OPpCONST_BARE)) &&
3268             type != OP_LIST &&
3269             type != OP_SCALAR &&
3270             type != OP_NULL &&
3271             type != OP_PUSHMARK)
3272         {
3273             goto nope;
3274         }
3275     }
3276
3277     curop = LINKLIST(o);
3278     old_next = o->op_next;
3279     o->op_next = 0;
3280     PL_op = curop;
3281
3282     oldscope = PL_scopestack_ix;
3283     create_eval_scope(G_FAKINGEVAL);
3284
3285     /* Verify that we don't need to save it:  */
3286     assert(PL_curcop == &PL_compiling);
3287     StructCopy(&PL_compiling, &not_compiling, COP);
3288     PL_curcop = &not_compiling;
3289     /* The above ensures that we run with all the correct hints of the
3290        currently compiling COP, but that IN_PERL_RUNTIME is not true. */
3291     assert(IN_PERL_RUNTIME);
3292     PL_warnhook = PERL_WARNHOOK_FATAL;
3293     PL_diehook  = NULL;
3294     JMPENV_PUSH(ret);
3295
3296     switch (ret) {
3297     case 0:
3298         CALLRUNOPS(aTHX);
3299         sv = *(PL_stack_sp--);
3300         if (o->op_targ && sv == PAD_SV(o->op_targ)) {   /* grab pad temp? */
3301 #ifdef PERL_MAD
3302             /* Can't simply swipe the SV from the pad, because that relies on
3303                the op being freed "real soon now". Under MAD, this doesn't
3304                happen (see the #ifdef below).  */
3305             sv = newSVsv(sv);
3306 #else
3307             pad_swipe(o->op_targ,  FALSE);
3308 #endif
3309         }
3310         else if (SvTEMP(sv)) {                  /* grab mortal temp? */
3311             SvREFCNT_inc_simple_void(sv);
3312             SvTEMP_off(sv);
3313         }
3314         break;
3315     case 3:
3316         /* Something tried to die.  Abandon constant folding.  */
3317         /* Pretend the error never happened.  */
3318         CLEAR_ERRSV();
3319         o->op_next = old_next;
3320         break;
3321     default:
3322         JMPENV_POP;
3323         /* Don't expect 1 (setjmp failed) or 2 (something called my_exit)  */
3324         PL_warnhook = oldwarnhook;
3325         PL_diehook  = olddiehook;
3326         /* XXX note that this croak may fail as we've already blown away
3327          * the stack - eg any nested evals */
3328         Perl_croak(aTHX_ "panic: fold_constants JMPENV_PUSH returned %d", ret);
3329     }
3330     JMPENV_POP;
3331     PL_warnhook = oldwarnhook;
3332     PL_diehook  = olddiehook;
3333     PL_curcop = &PL_compiling;
3334
3335     if (PL_scopestack_ix > oldscope)
3336         delete_eval_scope();
3337
3338     if (ret)
3339         goto nope;
3340
3341 #ifndef PERL_MAD
3342     op_free(o);
3343 #endif
3344     assert(sv);
3345     if (type == OP_RV2GV)
3346         newop = newGVOP(OP_GV, 0, MUTABLE_GV(sv));
3347     else
3348         newop = newSVOP(OP_CONST, OPpCONST_FOLDED<<8, MUTABLE_SV(sv));
3349     op_getmad(o,newop,'f');
3350     return newop;
3351
3352  nope:
3353     return o;
3354 }
3355
3356 static OP *
3357 S_gen_constant_list(pTHX_ OP *o)
3358 {
3359     dVAR;
3360     OP *curop;
3361     const I32 oldtmps_floor = PL_tmps_floor;
3362
3363     list(o);
3364     if (PL_parser && PL_parser->error_count)
3365         return o;               /* Don't attempt to run with errors */
3366
3367     PL_op = curop = LINKLIST(o);
3368     o->op_next = 0;
3369     CALL_PEEP(curop);
3370     Perl_pp_pushmark(aTHX);
3371     CALLRUNOPS(aTHX);
3372     PL_op = curop;
3373     assert (!(curop->op_flags & OPf_SPECIAL));
3374     assert(curop->op_type == OP_RANGE);
3375     Perl_pp_anonlist(aTHX);
3376     PL_tmps_floor = oldtmps_floor;
3377
3378     o->op_type = OP_RV2AV;
3379     o->op_ppaddr = PL_ppaddr[OP_RV2AV];
3380     o->op_flags &= ~OPf_REF;    /* treat \(1..2) like an ordinary list */
3381     o->op_flags |= OPf_PARENS;  /* and flatten \(1..2,3) */
3382     o->op_opt = 0;              /* needs to be revisited in rpeep() */
3383     curop = ((UNOP*)o)->op_first;
3384     ((UNOP*)o)->op_first = newSVOP(OP_CONST, 0, SvREFCNT_inc_NN(*PL_stack_sp--));
3385 #ifdef PERL_MAD
3386     op_getmad(curop,o,'O');
3387 #else
3388     op_free(curop);
3389 #endif
3390     LINKLIST(o);
3391     return list(o);
3392 }
3393
3394 OP *
3395 Perl_convert(pTHX_ I32 type, I32 flags, OP *o)
3396 {
3397     dVAR;
3398     if (type < 0) type = -type, flags |= OPf_SPECIAL;
3399     if (!o || o->op_type != OP_LIST)
3400         o = newLISTOP(OP_LIST, 0, o, NULL);
3401     else
3402         o->op_flags &= ~OPf_WANT;
3403
3404     if (!(PL_opargs[type] & OA_MARK))
3405         op_null(cLISTOPo->op_first);
3406     else {
3407         OP * const kid2 = cLISTOPo->op_first->op_sibling;
3408         if (kid2 && kid2->op_type == OP_COREARGS) {
3409             op_null(cLISTOPo->op_first);
3410             kid2->op_private |= OPpCOREARGS_PUSHMARK;
3411         }
3412     }
3413
3414     o->op_type = (OPCODE)type;
3415     o->op_ppaddr = PL_ppaddr[type];
3416     o->op_flags |= flags;
3417
3418     o = CHECKOP(type, o);
3419     if (o->op_type != (unsigned)type)
3420         return o;
3421
3422     return fold_constants(op_integerize(op_std_init(o)));
3423 }
3424
3425 /*
3426 =head1 Optree Manipulation Functions
3427 */
3428
3429 /* List constructors */
3430
3431 /*
3432 =for apidoc Am|OP *|op_append_elem|I32 optype|OP *first|OP *last
3433
3434 Append an item to the list of ops contained directly within a list-type
3435 op, returning the lengthened list.  I<first> is the list-type op,
3436 and I<last> is the op to append to the list.  I<optype> specifies the
3437 intended opcode for the list.  If I<first> is not already a list of the
3438 right type, it will be upgraded into one.  If either I<first> or I<last>
3439 is null, the other is returned unchanged.
3440
3441 =cut
3442 */
3443
3444 OP *
3445 Perl_op_append_elem(pTHX_ I32 type, OP *first, OP *last)
3446 {
3447     if (!first)
3448         return last;
3449
3450     if (!last)
3451         return first;
3452
3453     if (first->op_type != (unsigned)type
3454         || (type == OP_LIST && (first->op_flags & OPf_PARENS)))
3455     {
3456         return newLISTOP(type, 0, first, last);
3457     }
3458
3459     if (first->op_flags & OPf_KIDS)
3460         ((LISTOP*)first)->op_last->op_sibling = last;
3461     else {
3462         first->op_flags |= OPf_KIDS;
3463         ((LISTOP*)first)->op_first = last;
3464     }
3465     ((LISTOP*)first)->op_last = last;
3466     return first;
3467 }
3468
3469 /*
3470 =for apidoc Am|OP *|op_append_list|I32 optype|OP *first|OP *last
3471
3472 Concatenate the lists of ops contained directly within two list-type ops,
3473 returning the combined list.  I<first> and I<last> are the list-type ops
3474 to concatenate.  I<optype> specifies the intended opcode for the list.
3475 If either I<first> or I<last> is not already a list of the right type,
3476 it will be upgraded into one.  If either I<first> or I<last> is null,
3477 the other is returned unchanged.
3478
3479 =cut
3480 */
3481
3482 OP *
3483 Perl_op_append_list(pTHX_ I32 type, OP *first, OP *last)
3484 {
3485     if (!first)
3486         return last;
3487
3488     if (!last)
3489         return first;
3490
3491     if (first->op_type != (unsigned)type)
3492         return op_prepend_elem(type, first, last);
3493
3494     if (last->op_type != (unsigned)type)
3495         return op_append_elem(type, first, last);
3496
3497     ((LISTOP*)first)->op_last->op_sibling = ((LISTOP*)last)->op_first;
3498     ((LISTOP*)first)->op_last = ((LISTOP*)last)->op_last;
3499     first->op_flags |= (last->op_flags & OPf_KIDS);
3500
3501 #ifdef PERL_MAD
3502     if (((LISTOP*)last)->op_first && first->op_madprop) {
3503         MADPROP *mp = ((LISTOP*)last)->op_first->op_madprop;
3504         if (mp) {
3505             while (mp->mad_next)
3506                 mp = mp->mad_next;
3507             mp->mad_next = first->op_madprop;
3508         }
3509         else {
3510             ((LISTOP*)last)->op_first->op_madprop = first->op_madprop;
3511         }
3512     }
3513     first->op_madprop = last->op_madprop;
3514     last->op_madprop = 0;
3515 #endif
3516
3517     S_op_destroy(aTHX_ last);
3518
3519     return first;
3520 }
3521
3522 /*
3523 =for apidoc Am|OP *|op_prepend_elem|I32 optype|OP *first|OP *last
3524
3525 Prepend an item to the list of ops contained directly within a list-type
3526 op, returning the lengthened list.  I<first> is the op to prepend to the
3527 list, and I<last> is the list-type op.  I<optype> specifies the intended
3528 opcode for the list.  If I<last> is not already a list of the right type,
3529 it will be upgraded into one.  If either I<first> or I<last> is null,
3530 the other is returned unchanged.
3531
3532 =cut
3533 */
3534
3535 OP *
3536 Perl_op_prepend_elem(pTHX_ I32 type, OP *first, OP *last)
3537 {
3538     if (!first)
3539         return last;
3540
3541     if (!last)
3542         return first;
3543
3544     if (last->op_type == (unsigned)type) {
3545         if (type == OP_LIST) {  /* already a PUSHMARK there */
3546             first->op_sibling = ((LISTOP*)last)->op_first->op_sibling;
3547             ((LISTOP*)last)->op_first->op_sibling = first;
3548             if (!(first->op_flags & OPf_PARENS))
3549                 last->op_flags &= ~OPf_PARENS;
3550         }
3551         else {
3552             if (!(last->op_flags & OPf_KIDS)) {
3553                 ((LISTOP*)last)->op_last = first;
3554                 last->op_flags |= OPf_KIDS;
3555             }
3556             first->op_sibling = ((LISTOP*)last)->op_first;
3557             ((LISTOP*)last)->op_first = first;
3558         }
3559         last->op_flags |= OPf_KIDS;
3560         return last;
3561     }
3562
3563     return newLISTOP(type, 0, first, last);
3564 }
3565
3566 /* Constructors */
3567
3568 #ifdef PERL_MAD
3569
3570 TOKEN *
3571 Perl_newTOKEN(pTHX_ I32 optype, YYSTYPE lval, MADPROP* madprop)
3572 {
3573     TOKEN *tk;
3574     Newxz(tk, 1, TOKEN);
3575     tk->tk_type = (OPCODE)optype;
3576     tk->tk_type = 12345;
3577     tk->tk_lval = lval;
3578     tk->tk_mad = madprop;
3579     return tk;
3580 }
3581
3582 void
3583 Perl_token_free(pTHX_ TOKEN* tk)
3584 {
3585     PERL_ARGS_ASSERT_TOKEN_FREE;
3586
3587     if (tk->tk_type != 12345)
3588         return;
3589     mad_free(tk->tk_mad);
3590     Safefree(tk);
3591 }
3592
3593 void
3594 Perl_token_getmad(pTHX_ TOKEN* tk, OP* o, char slot)
3595 {
3596     MADPROP* mp;
3597     MADPROP* tm;
3598
3599     PERL_ARGS_ASSERT_TOKEN_GETMAD;
3600
3601     if (tk->tk_type != 12345) {
3602         Perl_warner(aTHX_ packWARN(WARN_MISC),
3603              "Invalid TOKEN object ignored");
3604         return;
3605     }
3606     tm = tk->tk_mad;
3607     if (!tm)
3608         return;
3609
3610     /* faked up qw list? */
3611     if (slot == '(' &&
3612         tm->mad_type == MAD_SV &&
3613         SvPVX((SV *)tm->mad_val)[0] == 'q')
3614             slot = 'x';
3615
3616     if (o) {
3617         mp = o->op_madprop;
3618         if (mp) {
3619             for (;;) {
3620                 /* pretend constant fold didn't happen? */
3621                 if (mp->mad_key == 'f' &&
3622                     (o->op_type == OP_CONST ||
3623                      o->op_type == OP_GV) )
3624                 {
3625                     token_getmad(tk,(OP*)mp->mad_val,slot);
3626                     return;
3627                 }
3628                 if (!mp->mad_next)
3629                     break;
3630                 mp = mp->mad_next;
3631             }
3632             mp->mad_next = tm;
3633             mp = mp->mad_next;
3634         }
3635         else {
3636             o->op_madprop = tm;
3637             mp = o->op_madprop;
3638         }
3639         if (mp->mad_key == 'X')
3640             mp->mad_key = slot; /* just change the first one */
3641
3642         tk->tk_mad = 0;
3643     }
3644     else
3645         mad_free(tm);
3646     Safefree(tk);
3647 }
3648
3649 void
3650 Perl_op_getmad_weak(pTHX_ OP* from, OP* o, char slot)
3651 {
3652     MADPROP* mp;
3653     if (!from)
3654         return;
3655     if (o) {
3656         mp = o->op_madprop;
3657         if (mp) {
3658             for (;;) {
3659                 /* pretend constant fold didn't happen? */
3660                 if (mp->mad_key == 'f' &&
3661                     (o->op_type == OP_CONST ||
3662                      o->op_type == OP_GV) )
3663                 {
3664                     op_getmad(from,(OP*)mp->mad_val,slot);
3665                     return;
3666                 }
3667                 if (!mp->mad_next)
3668                     break;
3669                 mp = mp->mad_next;
3670             }
3671             mp->mad_next = newMADPROP(slot,MAD_OP,from,0);
3672         }
3673         else {
3674             o->op_madprop = newMADPROP(slot,MAD_OP,from,0);
3675         }
3676     }
3677 }
3678
3679 void
3680 Perl_op_getmad(pTHX_ OP* from, OP* o, char slot)
3681 {
3682     MADPROP* mp;
3683     if (!from)
3684         return;
3685     if (o) {
3686         mp = o->op_madprop;
3687         if (mp) {
3688             for (;;) {
3689                 /* pretend constant fold didn't happen? */
3690                 if (mp->mad_key == 'f' &&
3691                     (o->op_type == OP_CONST ||
3692                      o->op_type == OP_GV) )
3693                 {
3694                     op_getmad(from,(OP*)mp->mad_val,slot);
3695                     return;
3696                 }
3697                 if (!mp->mad_next)
3698                     break;
3699                 mp = mp->mad_next;
3700             }
3701             mp->mad_next = newMADPROP(slot,MAD_OP,from,1);
3702         }
3703         else {
3704             o->op_madprop = newMADPROP(slot,MAD_OP,from,1);
3705         }
3706     }
3707     else {
3708         PerlIO_printf(PerlIO_stderr(),
3709                       "DESTROYING op = %0"UVxf"\n", PTR2UV(from));
3710         op_free(from);
3711     }
3712 }
3713
3714 void
3715 Perl_prepend_madprops(pTHX_ MADPROP* mp, OP* o, char slot)
3716 {
3717     MADPROP* tm;
3718     if (!mp || !o)
3719         return;
3720     if (slot)
3721         mp->mad_key = slot;
3722     tm = o->op_madprop;
3723     o->op_madprop = mp;
3724     for (;;) {
3725         if (!mp->mad_next)
3726             break;
3727         mp = mp->mad_next;
3728     }
3729     mp->mad_next = tm;
3730 }
3731
3732 void
3733 Perl_append_madprops(pTHX_ MADPROP* tm, OP* o, char slot)
3734 {
3735     if (!o)
3736         return;
3737     addmad(tm, &(o->op_madprop), slot);
3738 }
3739
3740 void
3741 Perl_addmad(pTHX_ MADPROP* tm, MADPROP** root, char slot)
3742 {
3743     MADPROP* mp;
3744     if (!tm || !root)
3745         return;
3746     if (slot)
3747         tm->mad_key = slot;
3748     mp = *root;
3749     if (!mp) {
3750         *root = tm;
3751         return;
3752     }
3753     for (;;) {
3754         if (!mp->mad_next)
3755             break;
3756         mp = mp->mad_next;
3757     }
3758     mp->mad_next = tm;
3759 }
3760
3761 MADPROP *
3762 Perl_newMADsv(pTHX_ char key, SV* sv)
3763 {
3764     PERL_ARGS_ASSERT_NEWMADSV;
3765
3766     return newMADPROP(key, MAD_SV, sv, 0);
3767 }
3768
3769 MADPROP *
3770 Perl_newMADPROP(pTHX_ char key, char type, void* val, I32 vlen)
3771 {
3772     MADPROP *const mp = (MADPROP *) PerlMemShared_malloc(sizeof(MADPROP));
3773     mp->mad_next = 0;
3774     mp->mad_key = key;
3775     mp->mad_vlen = vlen;
3776     mp->mad_type = type;
3777     mp->mad_val = val;
3778 /*    PerlIO_printf(PerlIO_stderr(), "NEW  mp = %0x\n", mp);  */
3779     return mp;
3780 }
3781
3782 void
3783 Perl_mad_free(pTHX_ MADPROP* mp)
3784 {
3785 /*    PerlIO_printf(PerlIO_stderr(), "FREE mp = %0x\n", mp); */
3786     if (!mp)
3787         return;
3788     if (mp->mad_next)
3789         mad_free(mp->mad_next);
3790 /*    if (PL_parser && PL_parser->lex_state != LEX_NOTPARSING && mp->mad_vlen)
3791         PerlIO_printf(PerlIO_stderr(), "DESTROYING '%c'=<%s>\n", mp->mad_key & 255, mp->mad_val); */
3792     switch (mp->mad_type) {
3793     case MAD_NULL:
3794         break;
3795     case MAD_PV:
3796         Safefree(mp->mad_val);
3797         break;
3798     case MAD_OP:
3799         if (mp->mad_vlen)       /* vlen holds "strong/weak" boolean */
3800             op_free((OP*)mp->mad_val);
3801         break;
3802     case MAD_SV:
3803         sv_free(MUTABLE_SV(mp->mad_val));
3804         break;
3805     default:
3806         PerlIO_printf(PerlIO_stderr(), "Unrecognized mad\n");
3807         break;
3808     }
3809     PerlMemShared_free(mp);
3810 }
3811
3812 #endif
3813
3814 /*
3815 =head1 Optree construction
3816
3817 =for apidoc Am|OP *|newNULLLIST
3818
3819 Constructs, checks, and returns a new C<stub> op, which represents an
3820 empty list expression.
3821
3822 =cut
3823 */
3824
3825 OP *
3826 Perl_newNULLLIST(pTHX)
3827 {
3828     return newOP(OP_STUB, 0);
3829 }
3830
3831 static OP *
3832 S_force_list(pTHX_ OP *o)
3833 {
3834     if (!o || o->op_type != OP_LIST)
3835         o = newLISTOP(OP_LIST, 0, o, NULL);
3836     op_null(o);
3837     return o;
3838 }
3839
3840 /*
3841 =for apidoc Am|OP *|newLISTOP|I32 type|I32 flags|OP *first|OP *last
3842
3843 Constructs, checks, and returns an op of any list type.  I<type> is
3844 the opcode.  I<flags> gives the eight bits of C<op_flags>, except that
3845 C<OPf_KIDS> will be set automatically if required.  I<first> and I<last>
3846 supply up to two ops to be direct children of the list op; they are
3847 consumed by this function and become part of the constructed op tree.
3848
3849 =cut
3850 */
3851
3852 OP *
3853 Perl_newLISTOP(pTHX_ I32 type, I32 flags, OP *first, OP *last)
3854 {
3855     dVAR;
3856     LISTOP *listop;
3857
3858     assert((PL_opargs[type] & OA_CLASS_MASK) == OA_LISTOP);
3859
3860     NewOp(1101, listop, 1, LISTOP);
3861
3862     listop->op_type = (OPCODE)type;
3863     listop->op_ppaddr = PL_ppaddr[type];
3864     if (first || last)
3865         flags |= OPf_KIDS;
3866     listop->op_flags = (U8)flags;
3867
3868     if (!last && first)
3869         last = first;
3870     else if (!first && last)
3871         first = last;
3872     else if (first)
3873         first->op_sibling = last;
3874     listop->op_first = first;
3875     listop->op_last = last;
3876     if (type == OP_LIST) {
3877         OP* const pushop = newOP(OP_PUSHMARK, 0);
3878         pushop->op_sibling = first;
3879         listop->op_first = pushop;
3880         listop->op_flags |= OPf_KIDS;
3881         if (!last)
3882             listop->op_last = pushop;
3883     }
3884
3885     return CHECKOP(type, listop);
3886 }
3887
3888 /*
3889 =for apidoc Am|OP *|newOP|I32 type|I32 flags
3890
3891 Constructs, checks, and returns an op of any base type (any type that
3892 has no extra fields).  I<type> is the opcode.  I<flags> gives the
3893 eight bits of C<op_flags>, and, shifted up eight bits, the eight bits
3894 of C<op_private>.
3895
3896 =cut
3897 */
3898
3899 OP *
3900 Perl_newOP(pTHX_ I32 type, I32 flags)
3901 {
3902     dVAR;
3903     OP *o;
3904
3905     if (type == -OP_ENTEREVAL) {
3906         type = OP_ENTEREVAL;
3907         flags |= OPpEVAL_BYTES<<8;
3908     }
3909
3910     assert((PL_opargs[type] & OA_CLASS_MASK) == OA_BASEOP
3911         || (PL_opargs[type] & OA_CLASS_MASK) == OA_BASEOP_OR_UNOP
3912         || (PL_opargs[type] & OA_CLASS_MASK) == OA_FILESTATOP
3913         || (PL_opargs[type] & OA_CLASS_MASK) == OA_LOOPEXOP);
3914
3915     NewOp(1101, o, 1, OP);
3916     o->op_type = (OPCODE)type;
3917     o->op_ppaddr = PL_ppaddr[type];
3918     o->op_flags = (U8)flags;
3919
3920     o->op_next = o;
3921     o->op_private = (U8)(0 | (flags >> 8));
3922     if (PL_opargs[type] & OA_RETSCALAR)
3923         scalar(o);
3924     if (PL_opargs[type] & OA_TARGET)
3925         o->op_targ = pad_alloc(type, SVs_PADTMP);
3926     return CHECKOP(type, o);
3927 }
3928
3929 /*
3930 =for apidoc Am|OP *|newUNOP|I32 type|I32 flags|OP *first
3931
3932 Constructs, checks, and returns an op of any unary type.  I<type> is
3933 the opcode.  I<flags> gives the eight bits of C<op_flags>, except that
3934 C<OPf_KIDS> will be set automatically if required, and, shifted up eight
3935 bits, the eight bits of C<op_private>, except that the bit with value 1
3936 is automatically set.  I<first> supplies an optional op to be the direct
3937 child of the unary op; it is consumed by this function and become part
3938 of the constructed op tree.
3939
3940 =cut
3941 */
3942
3943 OP *
3944 Perl_newUNOP(pTHX_ I32 type, I32 flags, OP *first)
3945 {
3946     dVAR;
3947     UNOP *unop;
3948
3949     if (type == -OP_ENTEREVAL) {
3950         type = OP_ENTEREVAL;
3951         flags |= OPpEVAL_BYTES<<8;
3952     }
3953
3954     assert((PL_opargs[type] & OA_CLASS_MASK) == OA_UNOP
3955         || (PL_opargs[type] & OA_CLASS_MASK) == OA_BASEOP_OR_UNOP
3956         || (PL_opargs[type] & OA_CLASS_MASK) == OA_FILESTATOP
3957         || (PL_opargs[type] & OA_CLASS_MASK) == OA_LOOPEXOP
3958         || type == OP_SASSIGN
3959         || type == OP_ENTERTRY
3960         || type == OP_NULL );
3961
3962     if (!first)
3963         first = newOP(OP_STUB, 0);
3964     if (PL_opargs[type] & OA_MARK)
3965         first = force_list(first);
3966
3967     NewOp(1101, unop, 1, UNOP);
3968     unop->op_type = (OPCODE)type;
3969     unop->op_ppaddr = PL_ppaddr[type];
3970     unop->op_first = first;
3971     unop->op_flags = (U8)(flags | OPf_KIDS);
3972     unop->op_private = (U8)(1 | (flags >> 8));
3973     unop = (UNOP*) CHECKOP(type, unop);
3974     if (unop->op_next)
3975         return (OP*)unop;
3976
3977     return fold_constants(op_integerize(op_std_init((OP *) unop)));
3978 }
3979
3980 /*
3981 =for apidoc Am|OP *|newBINOP|I32 type|I32 flags|OP *first|OP *last
3982
3983 Constructs, checks, and returns an op of any binary type.  I<type>
3984 is the opcode.  I<flags> gives the eight bits of C<op_flags>, except
3985 that C<OPf_KIDS> will be set automatically, and, shifted up eight bits,
3986 the eight bits of C<op_private>, except that the bit with value 1 or
3987 2 is automatically set as required.  I<first> and I<last> supply up to
3988 two ops to be the direct children of the binary op; they are consumed
3989 by this function and become part of the constructed op tree.
3990
3991 =cut
3992 */
3993
3994 OP *
3995 Perl_newBINOP(pTHX_ I32 type, I32 flags, OP *first, OP *last)
3996 {
3997     dVAR;
3998     BINOP *binop;
3999
4000     assert((PL_opargs[type] & OA_CLASS_MASK) == OA_BINOP
4001         || type == OP_SASSIGN || type == OP_NULL );
4002
4003     NewOp(1101, binop, 1, BINOP);
4004
4005     if (!first)
4006         first = newOP(OP_NULL, 0);
4007
4008     binop->op_type = (OPCODE)type;
4009     binop->op_ppaddr = PL_ppaddr[type];
4010     binop->op_first = first;
4011     binop->op_flags = (U8)(flags | OPf_KIDS);
4012     if (!last) {
4013         last = first;
4014         binop->op_private = (U8)(1 | (flags >> 8));
4015     }
4016     else {
4017         binop->op_private = (U8)(2 | (flags >> 8));
4018         first->op_sibling = last;
4019     }
4020
4021     binop = (BINOP*)CHECKOP(type, binop);
4022     if (binop->op_next || binop->op_type != (OPCODE)type)
4023         return (OP*)binop;
4024
4025     binop->op_last = binop->op_first->op_sibling;
4026
4027     return fold_constants(op_integerize(op_std_init((OP *)binop)));
4028 }
4029
4030 static int uvcompare(const void *a, const void *b)
4031     __attribute__nonnull__(1)
4032     __attribute__nonnull__(2)
4033     __attribute__pure__;
4034 static int uvcompare(const void *a, const void *b)
4035 {
4036     if (*((const UV *)a) < (*(const UV *)b))
4037         return -1;
4038     if (*((const UV *)a) > (*(const UV *)b))
4039         return 1;
4040     if (*((const UV *)a+1) < (*(const UV *)b+1))
4041         return -1;
4042     if (*((const UV *)a+1) > (*(const UV *)b+1))
4043         return 1;
4044     return 0;
4045 }
4046
4047 static OP *
4048 S_pmtrans(pTHX_ OP *o, OP *expr, OP *repl)
4049 {
4050     dVAR;
4051     SV * const tstr = ((SVOP*)expr)->op_sv;
4052     SV * const rstr =
4053 #ifdef PERL_MAD
4054                         (repl->op_type == OP_NULL)
4055                             ? ((SVOP*)((LISTOP*)repl)->op_first)->op_sv :
4056 #endif
4057                               ((SVOP*)repl)->op_sv;
4058     STRLEN tlen;
4059     STRLEN rlen;
4060     const U8 *t = (U8*)SvPV_const(tstr, tlen);
4061     const U8 *r = (U8*)SvPV_const(rstr, rlen);
4062     I32 i;
4063     I32 j;
4064     I32 grows = 0;
4065     short *tbl;
4066
4067     const I32 complement = o->op_private & OPpTRANS_COMPLEMENT;
4068     const I32 squash     = o->op_private & OPpTRANS_SQUASH;
4069     I32 del              = o->op_private & OPpTRANS_DELETE;
4070     SV* swash;
4071
4072     PERL_ARGS_ASSERT_PMTRANS;
4073
4074     PL_hints |= HINT_BLOCK_SCOPE;
4075
4076     if (SvUTF8(tstr))
4077         o->op_private |= OPpTRANS_FROM_UTF;
4078
4079     if (SvUTF8(rstr))
4080         o->op_private |= OPpTRANS_TO_UTF;
4081
4082     if (o->op_private & (OPpTRANS_FROM_UTF|OPpTRANS_TO_UTF)) {
4083         SV* const listsv = newSVpvs("# comment\n");
4084         SV* transv = NULL;
4085         const U8* tend = t + tlen;
4086         const U8* rend = r + rlen;
4087         STRLEN ulen;
4088         UV tfirst = 1;
4089         UV tlast = 0;
4090         IV tdiff;
4091         UV rfirst = 1;
4092         UV rlast = 0;
4093         IV rdiff;
4094         IV diff;
4095         I32 none = 0;
4096         U32 max = 0;
4097         I32 bits;
4098         I32 havefinal = 0;
4099         U32 final = 0;
4100         const I32 from_utf  = o->op_private & OPpTRANS_FROM_UTF;
4101         const I32 to_utf    = o->op_private & OPpTRANS_TO_UTF;
4102         U8* tsave = NULL;
4103         U8* rsave = NULL;
4104         const U32 flags = UTF8_ALLOW_DEFAULT;
4105
4106         if (!from_utf) {
4107             STRLEN len = tlen;
4108             t = tsave = bytes_to_utf8(t, &len);
4109             tend = t + len;
4110         }
4111         if (!to_utf && rlen) {
4112             STRLEN len = rlen;
4113             r = rsave = bytes_to_utf8(r, &len);
4114             rend = r + len;
4115         }
4116
4117 /* There are several snags with this code on EBCDIC:
4118    1. 0xFF is a legal UTF-EBCDIC byte (there are no illegal bytes).
4119    2. scan_const() in toke.c has encoded chars in native encoding which makes
4120       ranges at least in EBCDIC 0..255 range the bottom odd.
4121 */
4122
4123         if (complement) {
4124             U8 tmpbuf[UTF8_MAXBYTES+1];
4125             UV *cp;
4126             UV nextmin = 0;
4127             Newx(cp, 2*tlen, UV);
4128             i = 0;
4129             transv = newSVpvs("");
4130             while (t < tend) {
4131                 cp[2*i] = utf8n_to_uvuni(t, tend-t, &ulen, flags);
4132                 t += ulen;
4133                 if (t < tend && NATIVE_TO_UTF(*t) == 0xff) {
4134                     t++;
4135                     cp[2*i+1] = utf8n_to_uvuni(t, tend-t, &ulen, flags);
4136                     t += ulen;
4137                 }
4138                 else {
4139                  cp[2*i+1] = cp[2*i];
4140                 }
4141                 i++;
4142             }
4143             qsort(cp, i, 2*sizeof(UV), uvcompare);
4144             for (j = 0; j < i; j++) {
4145                 UV  val = cp[2*j];
4146                 diff = val - nextmin;
4147                 if (diff > 0) {
4148                     t = uvuni_to_utf8(tmpbuf,nextmin);
4149                     sv_catpvn(transv, (char*)tmpbuf, t - tmpbuf);
4150                     if (diff > 1) {
4151                         U8  range_mark = UTF_TO_NATIVE(0xff);
4152                         t = uvuni_to_utf8(tmpbuf, val - 1);
4153                         sv_catpvn(transv, (char *)&range_mark, 1);
4154                         sv_catpvn(transv, (char*)tmpbuf, t - tmpbuf);
4155                     }
4156                 }
4157                 val = cp[2*j+1];
4158                 if (val >= nextmin)
4159                     nextmin = val + 1;
4160             }
4161             t = uvuni_to_utf8(tmpbuf,nextmin);
4162             sv_catpvn(transv, (char*)tmpbuf, t - tmpbuf);
4163             {
4164                 U8 range_mark = UTF_TO_NATIVE(0xff);
4165                 sv_catpvn(transv, (char *)&range_mark, 1);
4166             }
4167             t = uvuni_to_utf8(tmpbuf, 0x7fffffff);
4168             sv_catpvn(transv, (char*)tmpbuf, t - tmpbuf);
4169             t = (const U8*)SvPVX_const(transv);
4170             tlen = SvCUR(transv);
4171             tend = t + tlen;
4172             Safefree(cp);
4173         }
4174         else if (!rlen && !del) {
4175             r = t; rlen = tlen; rend = tend;
4176         }
4177         if (!squash) {
4178                 if ((!rlen && !del) || t == r ||
4179                     (tlen == rlen && memEQ((char *)t, (char *)r, tlen)))
4180                 {
4181                     o->op_private |= OPpTRANS_IDENTICAL;
4182                 }
4183         }
4184
4185         while (t < tend || tfirst <= tlast) {
4186             /* see if we need more "t" chars */
4187             if (tfirst > tlast) {
4188                 tfirst = (I32)utf8n_to_uvuni(t, tend - t, &ulen, flags);
4189                 t += ulen;
4190                 if (t < tend && NATIVE_TO_UTF(*t) == 0xff) {    /* illegal utf8 val indicates range */
4191                     t++;
4192                     tlast = (I32)utf8n_to_uvuni(t, tend - t, &ulen, flags);
4193                     t += ulen;
4194                 }
4195                 else
4196                     tlast = tfirst;
4197             }
4198
4199             /* now see if we need more "r" chars */
4200             if (rfirst > rlast) {
4201                 if (r < rend) {
4202                     rfirst = (I32)utf8n_to_uvuni(r, rend - r, &ulen, flags);
4203                     r += ulen;
4204                     if (r < rend && NATIVE_TO_UTF(*r) == 0xff) {        /* illegal utf8 val indicates range */
4205                         r++;
4206                         rlast = (I32)utf8n_to_uvuni(r, rend - r, &ulen, flags);
4207                         r += ulen;
4208                     }
4209                     else
4210                         rlast = rfirst;
4211                 }
4212                 else {
4213                     if (!havefinal++)
4214                         final = rlast;
4215                     rfirst = rlast = 0xffffffff;
4216                 }
4217             }
4218
4219             /* now see which range will peter our first, if either. */
4220             tdiff = tlast - tfirst;
4221             rdiff = rlast - rfirst;
4222
4223             if (tdiff <= rdiff)
4224                 diff = tdiff;
4225             else
4226                 diff = rdiff;
4227
4228             if (rfirst == 0xffffffff) {
4229                 diff = tdiff;   /* oops, pretend rdiff is infinite */
4230                 if (diff > 0)
4231                     Perl_sv_catpvf(aTHX_ listsv, "%04lx\t%04lx\tXXXX\n",
4232                                    (long)tfirst, (long)tlast);
4233                 else
4234                     Perl_sv_catpvf(aTHX_ listsv, "%04lx\t\tXXXX\n", (long)tfirst);
4235             }
4236             else {
4237                 if (diff > 0)
4238                     Perl_sv_catpvf(aTHX_ listsv, "%04lx\t%04lx\t%04lx\n",
4239                                    (long)tfirst, (long)(tfirst + diff),
4240                                    (long)rfirst);
4241                 else
4242                     Perl_sv_catpvf(aTHX_ listsv, "%04lx\t\t%04lx\n",
4243                                    (long)tfirst, (long)rfirst);
4244
4245                 if (rfirst + diff > max)
4246                     max = rfirst + diff;
4247                 if (!grows)
4248                     grows = (tfirst < rfirst &&
4249                              UNISKIP(tfirst) < UNISKIP(rfirst + diff));
4250                 rfirst += diff + 1;
4251             }
4252             tfirst += diff + 1;
4253         }
4254
4255         none = ++max;
4256         if (del)
4257             del = ++max;
4258
4259         if (max > 0xffff)
4260             bits = 32;
4261         else if (max > 0xff)
4262             bits = 16;
4263         else
4264             bits = 8;
4265
4266         swash = MUTABLE_SV(swash_init("utf8", "", listsv, bits, none));
4267 #ifdef USE_ITHREADS
4268         cPADOPo->op_padix = pad_alloc(OP_TRANS, SVs_PADTMP);
4269         SvREFCNT_dec(PAD_SVl(cPADOPo->op_padix));
4270         PAD_SETSV(cPADOPo->op_padix, swash);
4271         SvPADTMP_on(swash);
4272         SvREADONLY_on(swash);
4273 #else
4274         cSVOPo->op_sv = swash;
4275 #endif
4276         SvREFCNT_dec(listsv);
4277         SvREFCNT_dec(transv);
4278
4279         if (!del && havefinal && rlen)
4280             (void)hv_store(MUTABLE_HV(SvRV(swash)), "FINAL", 5,
4281                            newSVuv((UV)final), 0);
4282
4283         if (grows)
4284             o->op_private |= OPpTRANS_GROWS;
4285
4286         Safefree(tsave);
4287         Safefree(rsave);
4288
4289 #ifdef PERL_MAD
4290         op_getmad(expr,o,'e');
4291         op_getmad(repl,o,'r');
4292 #else
4293         op_free(expr);
4294         op_free(repl);
4295 #endif
4296         return o;
4297     }
4298
4299     tbl = (short*)PerlMemShared_calloc(
4300         (o->op_private & OPpTRANS_COMPLEMENT) &&
4301             !(o->op_private & OPpTRANS_DELETE) ? 258 : 256,
4302         sizeof(short));
4303     cPVOPo->op_pv = (char*)tbl;
4304     if (complement) {
4305         for (i = 0; i < (I32)tlen; i++)
4306             tbl[t[i]] = -1;
4307         for (i = 0, j = 0; i < 256; i++) {
4308             if (!tbl[i]) {
4309                 if (j >= (I32)rlen) {
4310                     if (del)
4311                         tbl[i] = -2;
4312                     else if (rlen)
4313                         tbl[i] = r[j-1];
4314                     else
4315                         tbl[i] = (short)i;
4316                 }
4317                 else {
4318                     if (i < 128 && r[j] >= 128)
4319                         grows = 1;
4320                     tbl[i] = r[j++];
4321                 }
4322             }
4323         }
4324         if (!del) {
4325             if (!rlen) {
4326                 j = rlen;
4327                 if (!squash)
4328                     o->op_private |= OPpTRANS_IDENTICAL;
4329             }
4330             else if (j >= (I32)rlen)
4331                 j = rlen - 1;
4332             else {
4333                 tbl =
4334                     (short *)
4335                     PerlMemShared_realloc(tbl,
4336                                           (0x101+rlen-j) * sizeof(short));
4337                 cPVOPo->op_pv = (char*)tbl;
4338             }
4339             tbl[0x100] = (short)(rlen - j);
4340             for (i=0; i < (I32)rlen - j; i++)
4341                 tbl[0x101+i] = r[j+i];
4342         }
4343     }
4344     else {
4345         if (!rlen && !del) {
4346             r = t; rlen = tlen;
4347             if (!squash)
4348                 o->op_private |= OPpTRANS_IDENTICAL;
4349         }
4350         else if (!squash && rlen == tlen && memEQ((char*)t, (char*)r, tlen)) {
4351             o->op_private |= OPpTRANS_IDENTICAL;
4352         }
4353         for (i = 0; i < 256; i++)
4354             tbl[i] = -1;
4355         for (i = 0, j = 0; i < (I32)tlen; i++,j++) {
4356             if (j >= (I32)rlen) {
4357                 if (del) {
4358                     if (tbl[t[i]] == -1)
4359                         tbl[t[i]] = -2;
4360                     continue;
4361                 }
4362                 --j;
4363             }
4364             if (tbl[t[i]] == -1) {
4365                 if (t[i] < 128 && r[j] >= 128)
4366                     grows = 1;
4367                 tbl[t[i]] = r[j];
4368             }
4369         }
4370     }
4371
4372     if(del && rlen == tlen) {
4373         Perl_ck_warner(aTHX_ packWARN(WARN_MISC), "Useless use of /d modifier in transliteration operator");
4374     } else if(rlen > tlen) {
4375         Perl_ck_warner(aTHX_ packWARN(WARN_MISC), "Replacement list is longer than search list");
4376     }
4377
4378     if (grows)
4379         o->op_private |= OPpTRANS_GROWS;
4380 #ifdef PERL_MAD
4381     op_getmad(expr,o,'e');
4382     op_getmad(repl,o,'r');
4383 #else
4384     op_free(expr);
4385     op_free(repl);
4386 #endif
4387
4388     return o;
4389 }
4390
4391 /*
4392 =for apidoc Am|OP *|newPMOP|I32 type|I32 flags
4393
4394 Constructs, checks, and returns an op of any pattern matching type.
4395 I<type> is the opcode.  I<flags> gives the eight bits of C<op_flags>
4396 and, shifted up eight bits, the eight bits of C<op_private>.
4397
4398 =cut
4399 */
4400
4401 OP *
4402 Perl_newPMOP(pTHX_ I32 type, I32 flags)
4403 {
4404     dVAR;
4405     PMOP *pmop;
4406
4407     assert((PL_opargs[type] & OA_CLASS_MASK) == OA_PMOP);
4408
4409     NewOp(1101, pmop, 1, PMOP);
4410     pmop->op_type = (OPCODE)type;
4411     pmop->op_ppaddr = PL_ppaddr[type];
4412     pmop->op_flags = (U8)flags;
4413     pmop->op_private = (U8)(0 | (flags >> 8));
4414
4415     if (PL_hints & HINT_RE_TAINT)
4416         pmop->op_pmflags |= PMf_RETAINT;
4417     if (IN_LOCALE_COMPILETIME) {
4418         set_regex_charset(&(pmop->op_pmflags), REGEX_LOCALE_CHARSET);
4419     }
4420     else if ((! (PL_hints & HINT_BYTES))
4421                 /* Both UNI_8_BIT and locale :not_characters imply Unicode */
4422              && (PL_hints & (HINT_UNI_8_BIT|HINT_LOCALE_NOT_CHARS)))
4423     {
4424         set_regex_charset(&(pmop->op_pmflags), REGEX_UNICODE_CHARSET);
4425     }
4426     if (PL_hints & HINT_RE_FLAGS) {
4427         SV *reflags = Perl_refcounted_he_fetch_pvn(aTHX_
4428          PL_compiling.cop_hints_hash, STR_WITH_LEN("reflags"), 0, 0
4429         );
4430         if (reflags && SvOK(reflags)) pmop->op_pmflags |= SvIV(reflags);
4431         reflags = Perl_refcounted_he_fetch_pvn(aTHX_
4432          PL_compiling.cop_hints_hash, STR_WITH_LEN("reflags_charset"), 0, 0
4433         );
4434         if (reflags && SvOK(reflags)) {
4435             set_regex_charset(&(pmop->op_pmflags), (regex_charset)SvIV(reflags));
4436         }
4437     }
4438
4439
4440 #ifdef USE_ITHREADS
4441     assert(SvPOK(PL_regex_pad[0]));
4442     if (SvCUR(PL_regex_pad[0])) {
4443         /* Pop off the "packed" IV from the end.  */
4444         SV *const repointer_list = PL_regex_pad[0];
4445         const char *p = SvEND(repointer_list) - sizeof(IV);
4446         const IV offset = *((IV*)p);
4447
4448         assert(SvCUR(repointer_list) % sizeof(IV) == 0);
4449
4450         SvEND_set(repointer_list, p);
4451
4452         pmop->op_pmoffset = offset;
4453         /* This slot should be free, so assert this:  */
4454         assert(PL_regex_pad[offset] == &PL_sv_undef);
4455     } else {
4456         SV * const repointer = &PL_sv_undef;
4457         av_push(PL_regex_padav, repointer);
4458         pmop->op_pmoffset = av_len(PL_regex_padav);
4459         PL_regex_pad = AvARRAY(PL_regex_padav);
4460     }
4461 #endif
4462
4463     return CHECKOP(type, pmop);
4464 }
4465
4466 /* Given some sort of match op o, and an expression expr containing a
4467  * pattern, either compile expr into a regex and attach it to o (if it's
4468  * constant), or convert expr into a runtime regcomp op sequence (if it's
4469  * not)
4470  *
4471  * isreg indicates that the pattern is part of a regex construct, eg
4472  * $x =~ /pattern/ or split /pattern/, as opposed to $x =~ $pattern or
4473  * split "pattern", which aren't. In the former case, expr will be a list
4474  * if the pattern contains more than one term (eg /a$b/) or if it contains
4475  * a replacement, ie s/// or tr///.
4476  *
4477  * When the pattern has been compiled within a new anon CV (for
4478  * qr/(?{...})/ ), then floor indicates the savestack level just before
4479  * the new sub was created
4480  */
4481
4482 OP *
4483 Perl_pmruntime(pTHX_ OP *o, OP *expr, bool isreg, I32 floor)
4484 {
4485     dVAR;
4486     PMOP *pm;
4487     LOGOP *rcop;
4488     I32 repl_has_vars = 0;
4489     OP* repl = NULL;
4490     bool is_trans = (o->op_type == OP_TRANS || o->op_type == OP_TRANSR);
4491     bool is_compiletime;
4492     bool has_code;
4493
4494     PERL_ARGS_ASSERT_PMRUNTIME;
4495
4496     /* for s/// and tr///, last element in list is the replacement; pop it */
4497
4498     if (is_trans || o->op_type == OP_SUBST) {
4499         OP* kid;
4500         repl = cLISTOPx(expr)->op_last;
4501         kid = cLISTOPx(expr)->op_first;
4502         while (kid->op_sibling != repl)
4503             kid = kid->op_sibling;
4504         kid->op_sibling = NULL;
4505         cLISTOPx(expr)->op_last = kid;
4506     }
4507
4508     /* for TRANS, convert LIST/PUSH/CONST into CONST, and pass to pmtrans() */
4509
4510     if (is_trans) {
4511         OP* const oe = expr;
4512         assert(expr->op_type == OP_LIST);
4513         assert(cLISTOPx(expr)->op_first->op_type == OP_PUSHMARK);
4514         assert(cLISTOPx(expr)->op_first->op_sibling == cLISTOPx(expr)->op_last);
4515         expr = cLISTOPx(oe)->op_last;
4516         cLISTOPx(oe)->op_first->op_sibling = NULL;
4517         cLISTOPx(oe)->op_last = NULL;
4518         op_free(oe);
4519
4520         return pmtrans(o, expr, repl);
4521     }
4522
4523     /* find whether we have any runtime or code elements;
4524      * at the same time, temporarily set the op_next of each DO block;
4525      * then when we LINKLIST, this will cause the DO blocks to be excluded
4526      * from the op_next chain (and from having LINKLIST recursively
4527      * applied to them). We fix up the DOs specially later */
4528
4529     is_compiletime = 1;
4530     has_code = 0;
4531     if (expr->op_type == OP_LIST) {
4532         OP *o;
4533         for (o = cLISTOPx(expr)->op_first; o; o = o->op_sibling) {
4534             if (o->op_type == OP_NULL && (o->op_flags & OPf_SPECIAL)) {
4535                 has_code = 1;
4536                 assert(!o->op_next && o->op_sibling);
4537                 o->op_next = o->op_sibling;
4538             }
4539             else if (o->op_type != OP_CONST && o->op_type != OP_PUSHMARK)
4540                 is_compiletime = 0;
4541         }
4542     }
4543     else if (expr->op_type != OP_CONST)
4544         is_compiletime = 0;
4545
4546     LINKLIST(expr);
4547
4548     /* fix up DO blocks; treat each one as a separate little sub;
4549      * also, mark any arrays as LIST/REF */
4550
4551     if (expr->op_type == OP_LIST) {
4552         OP *o;
4553         for (o = cLISTOPx(expr)->op_first; o; o = o->op_sibling) {
4554
4555             if (o->op_type == OP_PADAV || o->op_type == OP_RV2AV) {
4556                 assert( !(o->op_flags  & OPf_WANT));
4557                 /* push the array rather than its contents. The regex
4558                  * engine will retrieve and join the elements later */
4559                 o->op_flags |= (OPf_WANT_LIST | OPf_REF);
4560                 continue;
4561             }
4562
4563             if (!(o->op_type == OP_NULL && (o->op_flags & OPf_SPECIAL)))
4564                 continue;
4565             o->op_next = NULL; /* undo temporary hack from above */
4566             scalar(o);
4567             LINKLIST(o);
4568             if (cLISTOPo->op_first->op_type == OP_LEAVE) {
4569                 LISTOP *leaveop = cLISTOPx(cLISTOPo->op_first);
4570                 /* skip ENTER */
4571                 assert(leaveop->op_first->op_type == OP_ENTER);
4572                 assert(leaveop->op_first->op_sibling);
4573                 o->op_next = leaveop->op_first->op_sibling;
4574                 /* skip leave */
4575                 assert(leaveop->op_flags & OPf_KIDS);
4576                 assert(leaveop->op_last->op_next == (OP*)leaveop);
4577                 leaveop->op_next = NULL; /* stop on last op */
4578                 op_null((OP*)leaveop);
4579             }
4580             else {
4581                 /* skip SCOPE */
4582                 OP *scope = cLISTOPo->op_first;
4583                 assert(scope->op_type == OP_SCOPE);
4584                 assert(scope->op_flags & OPf_KIDS);
4585                 scope->op_next = NULL; /* stop on last op */
4586                 op_null(scope);
4587             }
4588             /* have to peep the DOs individually as we've removed it from
4589              * the op_next chain */
4590             CALL_PEEP(o);
4591             if (is_compiletime)
4592                 /* runtime finalizes as part of finalizing whole tree */
4593                 finalize_optree(o);
4594         }
4595     }
4596     else if (expr->op_type == OP_PADAV || expr->op_type == OP_RV2AV) {
4597         assert( !(expr->op_flags  & OPf_WANT));
4598         /* push the array rather than its contents. The regex
4599          * engine will retrieve and join the elements later */
4600         expr->op_flags |= (OPf_WANT_LIST | OPf_REF);
4601     }
4602
4603     PL_hints |= HINT_BLOCK_SCOPE;
4604     pm = (PMOP*)o;
4605     assert(floor==0 || (pm->op_pmflags & PMf_HAS_CV));
4606
4607     if (is_compiletime) {
4608         U32 rx_flags = pm->op_pmflags & RXf_PMf_COMPILETIME;
4609         regexp_engine const *eng = current_re_engine();
4610
4611         if (o->op_flags & OPf_SPECIAL)
4612             rx_flags |= RXf_SPLIT;
4613
4614         if (!has_code || !eng->op_comp) {
4615             /* compile-time simple constant pattern */
4616
4617             if ((pm->op_pmflags & PMf_HAS_CV) && !has_code) {
4618                 /* whoops! we guessed that a qr// had a code block, but we
4619                  * were wrong (e.g. /[(?{}]/ ). Throw away the PL_compcv
4620                  * that isn't required now. Note that we have to be pretty
4621                  * confident that nothing used that CV's pad while the
4622                  * regex was parsed */
4623                 assert(AvFILLp(PL_comppad) == 0); /* just @_ */
4624                 /* But we know that one op is using this CV's slab. */
4625                 cv_forget_slab(PL_compcv);
4626                 LEAVE_SCOPE(floor);
4627                 pm->op_pmflags &= ~PMf_HAS_CV;
4628             }
4629
4630             PM_SETRE(pm,
4631                 eng->op_comp
4632                     ? eng->op_comp(aTHX_ NULL, 0, expr, eng, NULL, NULL,
4633                                         rx_flags, pm->op_pmflags)
4634                     : Perl_re_op_compile(aTHX_ NULL, 0, expr, eng, NULL, NULL,
4635                                         rx_flags, pm->op_pmflags)
4636             );
4637 #ifdef PERL_MAD
4638             op_getmad(expr,(OP*)pm,'e');
4639 #else
4640             op_free(expr);
4641 #endif
4642         }
4643         else {
4644             /* compile-time pattern that includes literal code blocks */
4645             REGEXP* re = eng->op_comp(aTHX_ NULL, 0, expr, eng, NULL, NULL,
4646                         rx_flags,
4647                         (pm->op_pmflags |
4648                             ((PL_hints & HINT_RE_EVAL) ? PMf_USE_RE_EVAL : 0))
4649                     );
4650             PM_SETRE(pm, re);
4651             if (pm->op_pmflags & PMf_HAS_CV) {
4652                 CV *cv;
4653                 /* this QR op (and the anon sub we embed it in) is never
4654                  * actually executed. It's just a placeholder where we can
4655                  * squirrel away expr in op_code_list without the peephole
4656                  * optimiser etc processing it for a second time */
4657                 OP *qr = newPMOP(OP_QR, 0);
4658                 ((PMOP*)qr)->op_code_list = expr;
4659
4660                 /* handle the implicit sub{} wrapped round the qr/(?{..})/ */
4661                 SvREFCNT_inc_simple_void(PL_compcv);
4662                 cv = newATTRSUB(floor, 0, NULL, NULL, qr);
4663                 ReANY(re)->qr_anoncv = cv;
4664
4665                 /* attach the anon CV to the pad so that
4666                  * pad_fixup_inner_anons() can find it */
4667                 (void)pad_add_anon(cv, o->op_type);
4668                 SvREFCNT_inc_simple_void(cv);
4669             }
4670             else {
4671                 pm->op_code_list = expr;
4672             }
4673         }
4674     }
4675     else {
4676         /* runtime pattern: build chain of regcomp etc ops */
4677         bool reglist;
4678         PADOFFSET cv_targ = 0;
4679
4680         reglist = isreg && expr->op_type == OP_LIST;
4681         if (reglist)
4682             op_null(expr);
4683
4684         if (has_code) {
4685             pm->op_code_list = expr;
4686             /* don't free op_code_list; its ops are embedded elsewhere too */
4687             pm->op_pmflags |= PMf_CODELIST_PRIVATE;
4688         }
4689
4690         if (o->op_flags & OPf_SPECIAL)
4691             pm->op_pmflags |= PMf_SPLIT;
4692
4693         /* the OP_REGCMAYBE is a placeholder in the non-threaded case
4694          * to allow its op_next to be pointed past the regcomp and
4695          * preceding stacking ops;
4696          * OP_REGCRESET is there to reset taint before executing the
4697          * stacking ops */
4698         if (pm->op_pmflags & PMf_KEEP || TAINTING_get)
4699             expr = newUNOP((TAINTING_get ? OP_REGCRESET : OP_REGCMAYBE),0,expr);
4700
4701         if (pm->op_pmflags & PMf_HAS_CV) {
4702             /* we have a runtime qr with literal code. This means
4703              * that the qr// has been wrapped in a new CV, which
4704              * means that runtime consts, vars etc will have been compiled
4705              * against a new pad. So... we need to execute those ops
4706              * within the environment of the new CV. So wrap them in a call
4707              * to a new anon sub. i.e. for
4708              *
4709              *     qr/a$b(?{...})/,
4710              *
4711              * we build an anon sub that looks like
4712              *
4713              *     sub { "a", $b, '(?{...})' }
4714              *
4715              * and call it, passing the returned list to regcomp.
4716              * Or to put it another way, the list of ops that get executed
4717              * are:
4718              *
4719              *     normal              PMf_HAS_CV
4720              *     ------              -------------------
4721              *                         pushmark (for regcomp)
4722              *                         pushmark (for entersub)
4723              *                         pushmark (for refgen)
4724              *                         anoncode
4725              *                         refgen
4726              *                         entersub
4727              *     regcreset                  regcreset
4728              *     pushmark                   pushmark
4729              *     const("a")                 const("a")
4730              *     gvsv(b)                    gvsv(b)
4731              *     const("(?{...})")          const("(?{...})")
4732              *                                leavesub
4733              *     regcomp             regcomp
4734              */
4735
4736             SvREFCNT_inc_simple_void(PL_compcv);
4737             /* these lines are just an unrolled newANONATTRSUB */
4738             expr = newSVOP(OP_ANONCODE, 0,
4739                     MUTABLE_SV(newATTRSUB(floor, 0, NULL, NULL, expr)));
4740             cv_targ = expr->op_targ;
4741             expr = newUNOP(OP_REFGEN, 0, expr);
4742
4743             expr = list(force_list(newUNOP(OP_ENTERSUB, 0, scalar(expr))));
4744         }
4745
4746         NewOp(1101, rcop, 1, LOGOP);
4747         rcop->op_type = OP_REGCOMP;
4748         rcop->op_ppaddr = PL_ppaddr[OP_REGCOMP];
4749         rcop->op_first = scalar(expr);
4750         rcop->op_flags |= OPf_KIDS
4751                             | ((PL_hints & HINT_RE_EVAL) ? OPf_SPECIAL : 0)
4752                             | (reglist ? OPf_STACKED : 0);
4753         rcop->op_private = 0;
4754         rcop->op_other = o;
4755         rcop->op_targ = cv_targ;
4756
4757         /* /$x/ may cause an eval, since $x might be qr/(?{..})/  */
4758         if (PL_hints & HINT_RE_EVAL) PL_cv_has_eval = 1;
4759
4760         /* establish postfix order */
4761         if (expr->op_type == OP_REGCRESET || expr->op_type == OP_REGCMAYBE) {
4762             LINKLIST(expr);
4763             rcop->op_next = expr;
4764             ((UNOP*)expr)->op_first->op_next = (OP*)rcop;
4765         }
4766         else {
4767             rcop->op_next = LINKLIST(expr);
4768             expr->op_next = (OP*)rcop;
4769         }
4770
4771         op_prepend_elem(o->op_type, scalar((OP*)rcop), o);
4772     }
4773
4774     if (repl) {
4775         OP *curop = repl;
4776         bool konst;
4777         if (pm->op_pmflags & PMf_EVAL) {
4778             if (CopLINE(PL_curcop) < (line_t)PL_parser->multi_end)
4779                 CopLINE_set(PL_curcop, (line_t)PL_parser->multi_end);
4780         }
4781         /* If we are looking at s//.../e with a single statement, get past
4782            the implicit do{}. */
4783         if (curop->op_type == OP_NULL && curop->op_flags & OPf_KIDS
4784          && cUNOPx(curop)->op_first->op_type == OP_SCOPE
4785          && cUNOPx(curop)->op_first->op_flags & OPf_KIDS) {
4786             OP *kid = cUNOPx(cUNOPx(curop)->op_first)->op_first;
4787             if (kid->op_type == OP_NULL && kid->op_sibling
4788              && !kid->op_sibling->op_sibling)
4789                 curop = kid->op_sibling;
4790         }
4791         if (curop->op_type == OP_CONST)
4792             konst = TRUE;
4793         else if (( (curop->op_type == OP_RV2SV ||
4794                     curop->op_type == OP_RV2AV ||
4795                     curop->op_type == OP_RV2HV ||
4796                     curop->op_type == OP_RV2GV)
4797                    && cUNOPx(curop)->op_first
4798                    && cUNOPx(curop)->op_first->op_type == OP_GV )
4799                 || curop->op_type == OP_PADSV
4800                 || curop->op_type == OP_PADAV
4801                 || curop->op_type == OP_PADHV
4802                 || curop->op_type == OP_PADANY) {
4803             repl_has_vars = 1;
4804             konst = TRUE;
4805         }
4806         else konst = FALSE;
4807         if (konst
4808             && !(repl_has_vars
4809                  && (!PM_GETRE(pm)
4810                      || !RX_PRELEN(PM_GETRE(pm))
4811                      || RX_EXTFLAGS(PM_GETRE(pm)) & RXf_EVAL_SEEN)))
4812         {
4813             pm->op_pmflags |= PMf_CONST;        /* const for long enough */
4814             op_prepend_elem(o->op_type, scalar(repl), o);
4815         }
4816         else {
4817             NewOp(1101, rcop, 1, LOGOP);
4818             rcop->op_type = OP_SUBSTCONT;
4819             rcop->op_ppaddr = PL_ppaddr[OP_SUBSTCONT];
4820             rcop->op_first = scalar(repl);
4821             rcop->op_flags |= OPf_KIDS;
4822             rcop->op_private = 1;
4823             rcop->op_other = o;
4824
4825             /* establish postfix order */
4826             rcop->op_next = LINKLIST(repl);
4827             repl->op_next = (OP*)rcop;
4828
4829             pm->op_pmreplrootu.op_pmreplroot = scalar((OP*)rcop);
4830             assert(!(pm->op_pmflags & PMf_ONCE));
4831             pm->op_pmstashstartu.op_pmreplstart = LINKLIST(rcop);
4832             rcop->op_next = 0;
4833         }
4834     }
4835
4836     return (OP*)pm;
4837 }
4838
4839 /*
4840 =for apidoc Am|OP *|newSVOP|I32 type|I32 flags|SV *sv
4841
4842 Constructs, checks, and returns an op of any type that involves an
4843 embedded SV.  I<type> is the opcode.  I<flags> gives the eight bits
4844 of C<op_flags>.  I<sv> gives the SV to embed in the op; this function
4845 takes ownership of one reference to it.
4846
4847 =cut
4848 */
4849
4850 OP *
4851 Perl_newSVOP(pTHX_ I32 type, I32 flags, SV *sv)
4852 {
4853     dVAR;
4854     SVOP *svop;
4855
4856     PERL_ARGS_ASSERT_NEWSVOP;
4857
4858     assert((PL_opargs[type] & OA_CLASS_MASK) == OA_SVOP
4859         || (PL_opargs[type] & OA_CLASS_MASK) == OA_PVOP_OR_SVOP
4860         || (PL_opargs[type] & OA_CLASS_MASK) == OA_FILESTATOP);
4861
4862     NewOp(1101, svop, 1, SVOP);
4863     svop->op_type = (OPCODE)type;
4864     svop->op_ppaddr = PL_ppaddr[type];
4865     svop->op_sv = sv;
4866     svop->op_next = (OP*)svop;
4867     svop->op_flags = (U8)flags;
4868     svop->op_private = (U8)(0 | (flags >> 8));
4869     if (PL_opargs[type] & OA_RETSCALAR)
4870         scalar((OP*)svop);
4871     if (PL_opargs[type] & OA_TARGET)
4872         svop->op_targ = pad_alloc(type, SVs_PADTMP);
4873     return CHECKOP(type, svop);
4874 }
4875
4876 #ifdef USE_ITHREADS
4877
4878 /*
4879 =for apidoc Am|OP *|newPADOP|I32 type|I32 flags|SV *sv
4880
4881 Constructs, checks, and returns an op of any type that involves a
4882 reference to a pad element.  I<type> is the opcode.  I<flags> gives the
4883 eight bits of C<op_flags>.  A pad slot is automatically allocated, and
4884 is populated with I<sv>; this function takes ownership of one reference
4885 to it.
4886
4887 This function only exists if Perl has been compiled to use ithreads.
4888
4889 =cut
4890 */
4891
4892 OP *
4893 Perl_newPADOP(pTHX_ I32 type, I32 flags, SV *sv)
4894 {
4895     dVAR;
4896     PADOP *padop;
4897
4898     PERL_ARGS_ASSERT_NEWPADOP;
4899
4900     assert((PL_opargs[type] & OA_CLASS_MASK) == OA_SVOP
4901         || (PL_opargs[type] & OA_CLASS_MASK) == OA_PVOP_OR_SVOP
4902         || (PL_opargs[type] & OA_CLASS_MASK) == OA_FILESTATOP);
4903
4904     NewOp(1101, padop, 1, PADOP);
4905     padop->op_type = (OPCODE)type;
4906     padop->op_ppaddr = PL_ppaddr[type];
4907     padop->op_padix = pad_alloc(type, SVs_PADTMP);
4908     SvREFCNT_dec(PAD_SVl(padop->op_padix));
4909     PAD_SETSV(padop->op_padix, sv);
4910     assert(sv);
4911     SvPADTMP_on(sv);
4912     padop->op_next = (OP*)padop;
4913     padop->op_flags = (U8)flags;
4914     if (PL_opargs[type] & OA_RETSCALAR)
4915         scalar((OP*)padop);
4916     if (PL_opargs[type] & OA_TARGET)
4917         padop->op_targ = pad_alloc(type, SVs_PADTMP);
4918     return CHECKOP(type, padop);
4919 }
4920
4921 #endif /* !USE_ITHREADS */
4922
4923 /*
4924 =for apidoc Am|OP *|newGVOP|I32 type|I32 flags|GV *gv
4925
4926 Constructs, checks, and returns an op of any type that involves an
4927 embedded reference to a GV.  I<type> is the opcode.  I<flags> gives the
4928 eight bits of C<op_flags>.  I<gv> identifies the GV that the op should
4929 reference; calling this function does not transfer ownership of any
4930 reference to it.
4931
4932 =cut
4933 */
4934
4935 OP *
4936 Perl_newGVOP(pTHX_ I32 type, I32 flags, GV *gv)
4937 {
4938     dVAR;
4939
4940     PERL_ARGS_ASSERT_NEWGVOP;
4941
4942 #ifdef USE_ITHREADS
4943     GvIN_PAD_on(gv);
4944     return newPADOP(type, flags, SvREFCNT_inc_simple_NN(gv));
4945 #else
4946     return newSVOP(type, flags, SvREFCNT_inc_simple_NN(gv));
4947 #endif
4948 }
4949
4950 /*
4951 =for apidoc Am|OP *|newPVOP|I32 type|I32 flags|char *pv
4952
4953 Constructs, checks, and returns an op of any type that involves an
4954 embedded C-level pointer (PV).  I<type> is the opcode.  I<flags> gives
4955 the eight bits of C<op_flags>.  I<pv> supplies the C-level pointer, which
4956 must have been allocated using L</PerlMemShared_malloc>; the memory will
4957 be freed when the op is destroyed.
4958
4959 =cut
4960 */
4961
4962 OP *
4963 Perl_newPVOP(pTHX_ I32 type, I32 flags, char *pv)
4964 {
4965     dVAR;
4966     const bool utf8 = cBOOL(flags & SVf_UTF8);
4967     PVOP *pvop;
4968
4969     flags &= ~SVf_UTF8;
4970
4971     assert((PL_opargs[type] & OA_CLASS_MASK) == OA_PVOP_OR_SVOP
4972         || type == OP_RUNCV
4973         || (PL_opargs[type] & OA_CLASS_MASK) == OA_LOOPEXOP);
4974
4975     NewOp(1101, pvop, 1, PVOP);
4976     pvop->op_type = (OPCODE)type;
4977     pvop->op_ppaddr = PL_ppaddr[type];
4978     pvop->op_pv = pv;
4979     pvop->op_next = (OP*)pvop;
4980     pvop->op_flags = (U8)flags;
4981     pvop->op_private = utf8 ? OPpPV_IS_UTF8 : 0;
4982     if (PL_opargs[type] & OA_RETSCALAR)
4983         scalar((OP*)pvop);
4984     if (PL_opargs[type] & OA_TARGET)
4985         pvop->op_targ = pad_alloc(type, SVs_PADTMP);
4986     return CHECKOP(type, pvop);
4987 }
4988
4989 #ifdef PERL_MAD
4990 OP*
4991 #else
4992 void
4993 #endif
4994 Perl_package(pTHX_ OP *o)
4995 {
4996     dVAR;
4997     SV *const sv = cSVOPo->op_sv;
4998 #ifdef PERL_MAD
4999     OP *pegop;
5000 #endif
5001
5002     PERL_ARGS_ASSERT_PACKAGE;
5003
5004     SAVEGENERICSV(PL_curstash);
5005     save_item(PL_curstname);
5006
5007     PL_curstash = (HV *)SvREFCNT_inc(gv_stashsv(sv, GV_ADD));
5008
5009     sv_setsv(PL_curstname, sv);
5010
5011     PL_hints |= HINT_BLOCK_SCOPE;
5012     PL_parser->copline = NOLINE;
5013     PL_parser->expect = XSTATE;
5014
5015 #ifndef PERL_MAD
5016     op_free(o);
5017 #else
5018     if (!PL_madskills) {
5019         op_free(o);
5020         return NULL;
5021     }
5022
5023     pegop = newOP(OP_NULL,0);
5024     op_getmad(o,pegop,'P');
5025     return pegop;
5026 #endif
5027 }
5028
5029 void
5030 Perl_package_version( pTHX_ OP *v )
5031 {
5032     dVAR;
5033     U32 savehints = PL_hints;
5034     PERL_ARGS_ASSERT_PACKAGE_VERSION;
5035     PL_hints &= ~HINT_STRICT_VARS;
5036     sv_setsv( GvSV(gv_fetchpvs("VERSION", GV_ADDMULTI, SVt_PV)), cSVOPx(v)->op_sv );
5037     PL_hints = savehints;
5038     op_free(v);
5039 }
5040
5041 #ifdef PERL_MAD
5042 OP*
5043 #else
5044 void
5045 #endif
5046 Perl_utilize(pTHX_ int aver, I32 floor, OP *version, OP *idop, OP *arg)
5047 {
5048     dVAR;
5049     OP *pack;
5050     OP *imop;
5051     OP *veop;
5052 #ifdef PERL_MAD
5053     OP *pegop = PL_madskills ? newOP(OP_NULL,0) : NULL;
5054 #endif
5055     SV *use_version = NULL;
5056
5057     PERL_ARGS_ASSERT_UTILIZE;
5058
5059     if (idop->op_type != OP_CONST)
5060         Perl_croak(aTHX_ "Module name must be constant");
5061
5062     if (PL_madskills)
5063         op_getmad(idop,pegop,'U');
5064
5065     veop = NULL;
5066
5067     if (version) {
5068         SV * const vesv = ((SVOP*)version)->op_sv;
5069
5070         if (PL_madskills)
5071             op_getmad(version,pegop,'V');
5072         if (!arg && !SvNIOKp(vesv)) {
5073             arg = version;
5074         }
5075         else {
5076             OP *pack;
5077             SV *meth;
5078
5079             if (version->op_type != OP_CONST || !SvNIOKp(vesv))
5080                 Perl_croak(aTHX_ "Version number must be a constant number");
5081
5082             /* Make copy of idop so we don't free it twice */
5083             pack = newSVOP(OP_CONST, 0, newSVsv(((SVOP*)idop)->op_sv));
5084
5085             /* Fake up a method call to VERSION */
5086             meth = newSVpvs_share("VERSION");
5087             veop = convert(OP_ENTERSUB, OPf_STACKED|OPf_SPECIAL,
5088                             op_append_elem(OP_LIST,
5089                                         op_prepend_elem(OP_LIST, pack, list(version)),
5090                                         newSVOP(OP_METHOD_NAMED, 0, meth)));
5091         }
5092     }
5093
5094     /* Fake up an import/unimport */
5095     if (arg && arg->op_type == OP_STUB) {
5096         if (PL_madskills)
5097             op_getmad(arg,pegop,'S');
5098         imop = arg;             /* no import on explicit () */
5099     }
5100     else if (SvNIOKp(((SVOP*)idop)->op_sv)) {
5101         imop = NULL;            /* use 5.0; */
5102         if (aver)
5103             use_version = ((SVOP*)idop)->op_sv;
5104         else
5105             idop->op_private |= OPpCONST_NOVER;
5106     }
5107     else {
5108         SV *meth;
5109
5110         if (PL_madskills)
5111             op_getmad(arg,pegop,'A');
5112
5113         /* Make copy of idop so we don't free it twice */
5114         pack = newSVOP(OP_CONST, 0, newSVsv(((SVOP*)idop)->op_sv));
5115
5116         /* Fake up a method call to import/unimport */
5117         meth = aver
5118             ? newSVpvs_share("import") : newSVpvs_share("unimport");
5119         imop = convert(OP_ENTERSUB, OPf_STACKED|OPf_SPECIAL,
5120                        op_append_elem(OP_LIST,
5121                                    op_prepend_elem(OP_LIST, pack, list(arg)),
5122                                    newSVOP(OP_METHOD_NAMED, 0, meth)));
5123     }
5124
5125     /* Fake up the BEGIN {}, which does its thing immediately. */
5126     newATTRSUB(floor,
5127         newSVOP(OP_CONST, 0, newSVpvs_share("BEGIN")),
5128         NULL,
5129         NULL,
5130         op_append_elem(OP_LINESEQ,
5131             op_append_elem(OP_LINESEQ,
5132                 newSTATEOP(0, NULL, newUNOP(OP_REQUIRE, 0, idop)),
5133                 newSTATEOP(0, NULL, veop)),
5134             newSTATEOP(0, NULL, imop) ));
5135
5136     if (use_version) {
5137         /* Enable the
5138          * feature bundle that corresponds to the required version. */
5139         use_version = sv_2mortal(new_version(use_version));
5140         S_enable_feature_bundle(aTHX_ use_version);
5141
5142         /* If a version >= 5.11.0 is requested, strictures are on by default! */
5143         if (vcmp(use_version,
5144                  sv_2mortal(upg_version(newSVnv(5.011000), FALSE))) >= 0) {
5145             if (!(PL_hints & HINT_EXPLICIT_STRICT_REFS))
5146                 PL_hints |= HINT_STRICT_REFS;
5147             if (!(PL_hints & HINT_EXPLICIT_STRICT_SUBS))
5148                 PL_hints |= HINT_STRICT_SUBS;
5149             if (!(PL_hints & HINT_EXPLICIT_STRICT_VARS))
5150                 PL_hints |= HINT_STRICT_VARS;
5151         }
5152         /* otherwise they are off */
5153         else {
5154             if (!(PL_hints & HINT_EXPLICIT_STRICT_REFS))
5155                 PL_hints &= ~HINT_STRICT_REFS;
5156             if (!(PL_hints & HINT_EXPLICIT_STRICT_SUBS))
5157                 PL_hints &= ~HINT_STRICT_SUBS;
5158             if (!(PL_hints & HINT_EXPLICIT_STRICT_VARS))
5159                 PL_hints &= ~HINT_STRICT_VARS;
5160         }
5161     }
5162
5163     /* The "did you use incorrect case?" warning used to be here.
5164      * The problem is that on case-insensitive filesystems one
5165      * might get false positives for "use" (and "require"):
5166      * "use Strict" or "require CARP" will work.  This causes
5167      * portability problems for the script: in case-strict
5168      * filesystems the script will stop working.
5169      *
5170      * The "incorrect case" warning checked whether "use Foo"
5171      * imported "Foo" to your namespace, but that is wrong, too:
5172      * there is no requirement nor promise in the language that
5173      * a Foo.pm should or would contain anything in package "Foo".
5174      *
5175      * There is very little Configure-wise that can be done, either:
5176      * the case-sensitivity of the build filesystem of Perl does not
5177      * help in guessing the case-sensitivity of the runtime environment.
5178      */
5179
5180     PL_hints |= HINT_BLOCK_SCOPE;
5181     PL_parser->copline = NOLINE;
5182     PL_parser->expect = XSTATE;
5183     PL_cop_seqmax++; /* Purely for B::*'s benefit */
5184     if (PL_cop_seqmax == PERL_PADSEQ_INTRO) /* not a legal value */
5185         PL_cop_seqmax++;
5186
5187 #ifdef PERL_MAD
5188     return pegop;
5189 #endif
5190 }
5191
5192 /*
5193 =head1 Embedding Functions
5194
5195 =for apidoc load_module
5196
5197 Loads the module whose name is pointed to by the string part of name.
5198 Note that the actual module name, not its filename, should be given.
5199 Eg, "Foo::Bar" instead of "Foo/Bar.pm".  flags can be any of
5200 PERL_LOADMOD_DENY, PERL_LOADMOD_NOIMPORT, or PERL_LOADMOD_IMPORT_OPS
5201 (or 0 for no flags). ver, if specified and not NULL, provides version semantics
5202 similar to C<use Foo::Bar VERSION>.  The optional trailing SV*
5203 arguments can be used to specify arguments to the module's import()
5204 method, similar to C<use Foo::Bar VERSION LIST>.  They must be
5205 terminated with a final NULL pointer.  Note that this list can only
5206 be omitted when the PERL_LOADMOD_NOIMPORT flag has been used.
5207 Otherwise at least a single NULL pointer to designate the default
5208 import list is required.
5209
5210 The reference count for each specified C<SV*> parameter is decremented.
5211
5212 =cut */
5213
5214 void
5215 Perl_load_module(pTHX_ U32 flags, SV *name, SV *ver, ...)
5216 {
5217     va_list args;
5218
5219     PERL_ARGS_ASSERT_LOAD_MODULE;
5220
5221     va_start(args, ver);
5222     vload_module(flags, name, ver, &args);
5223     va_end(args);
5224 }
5225
5226 #ifdef PERL_IMPLICIT_CONTEXT
5227 void
5228 Perl_load_module_nocontext(U32 flags, SV *name, SV *ver, ...)
5229 {
5230     dTHX;
5231     va_list args;
5232     PERL_ARGS_ASSERT_LOAD_MODULE_NOCONTEXT;
5233     va_start(args, ver);
5234     vload_module(flags, name, ver, &args);
5235     va_end(args);
5236 }
5237 #endif
5238
5239 void
5240 Perl_vload_module(pTHX_ U32 flags, SV *name, SV *ver, va_list *args)
5241 {
5242     dVAR;
5243     OP *veop, *imop;
5244     OP * const modname = newSVOP(OP_CONST, 0, name);
5245
5246     PERL_ARGS_ASSERT_VLOAD_MODULE;
5247
5248     modname->op_private |= OPpCONST_BARE;
5249     if (ver) {
5250         veop = newSVOP(OP_CONST, 0, ver);
5251     }
5252     else
5253         veop = NULL;
5254     if (flags & PERL_LOADMOD_NOIMPORT) {
5255         imop = sawparens(newNULLLIST());
5256     }
5257     else if (flags & PERL_LOADMOD_IMPORT_OPS) {
5258         imop = va_arg(*args, OP*);
5259     }
5260     else {
5261         SV *sv;
5262         imop = NULL;
5263         sv = va_arg(*args, SV*);
5264         while (sv) {
5265             imop = op_append_elem(OP_LIST, imop, newSVOP(OP_CONST, 0, sv));
5266             sv = va_arg(*args, SV*);
5267         }
5268     }
5269
5270     /* utilize() fakes up a BEGIN { require ..; import ... }, so make sure
5271      * that it has a PL_parser to play with while doing that, and also
5272      * that it doesn't mess with any existing parser, by creating a tmp
5273      * new parser with lex_start(). This won't actually be used for much,
5274      * since pp_require() will create another parser for the real work. */
5275
5276     ENTER;
5277     SAVEVPTR(PL_curcop);
5278     lex_start(NULL, NULL, LEX_START_SAME_FILTER);
5279     utilize(!(flags & PERL_LOADMOD_DENY), start_subparse(FALSE, 0),
5280             veop, modname, imop);
5281     LEAVE;
5282 }
5283
5284 OP *
5285 Perl_dofile(pTHX_ OP *term, I32 force_builtin)
5286 {
5287     dVAR;
5288     OP *doop;
5289     GV *gv = NULL;
5290
5291     PERL_ARGS_ASSERT_DOFILE;
5292
5293     if (!force_builtin) {
5294         gv = gv_fetchpvs("do", GV_NOTQUAL, SVt_PVCV);
5295         if (!(gv && GvCVu(gv) && GvIMPORTED_CV(gv))) {
5296             GV * const * const gvp = (GV**)hv_fetchs(PL_globalstash, "do", FALSE);
5297             gv = gvp ? *gvp : NULL;
5298         }
5299     }
5300
5301     if (gv && GvCVu(gv) && GvIMPORTED_CV(gv)) {
5302         doop = newUNOP(OP_ENTERSUB, OPf_STACKED,
5303                                op_append_elem(OP_LIST, term,
5304                                            scalar(newUNOP(OP_RV2CV, 0,
5305                                                           newGVOP(OP_GV, 0, gv)))));
5306     }
5307     else {
5308         doop = newUNOP(OP_DOFILE, 0, scalar(term));
5309     }
5310     return doop;
5311 }
5312
5313 /*
5314 =head1 Optree construction
5315
5316 =for apidoc Am|OP *|newSLICEOP|I32 flags|OP *subscript|OP *listval
5317
5318 Constructs, checks, and returns an C<lslice> (list slice) op.  I<flags>
5319 gives the eight bits of C<op_flags>, except that C<OPf_KIDS> will
5320 be set automatically, and, shifted up eight bits, the eight bits of
5321 C<op_private>, except that the bit with value 1 or 2 is automatically
5322 set as required.  I<listval> and I<subscript> supply the parameters of
5323 the slice; they are consumed by this function and become part of the
5324 constructed op tree.
5325
5326 =cut
5327 */
5328
5329 OP *
5330 Perl_newSLICEOP(pTHX_ I32 flags, OP *subscript, OP *listval)
5331 {
5332     return newBINOP(OP_LSLICE, flags,
5333             list(force_list(subscript)),
5334             list(force_list(listval)) );
5335 }
5336
5337 STATIC I32
5338 S_is_list_assignment(pTHX_ const OP *o)
5339 {
5340     unsigned type;
5341     U8 flags;
5342
5343     if (!o)
5344         return TRUE;
5345
5346     if ((o->op_type == OP_NULL) && (o->op_flags & OPf_KIDS))
5347         o = cUNOPo->op_first;
5348
5349     flags = o->op_flags;
5350     type = o->op_type;
5351     if (type == OP_COND_EXPR) {
5352         const I32 t = is_list_assignment(cLOGOPo->op_first->op_sibling);
5353         const I32 f = is_list_assignment(cLOGOPo->op_first->op_sibling->op_sibling);
5354
5355         if (t && f)
5356             return TRUE;
5357         if (t || f)
5358             yyerror("Assignment to both a list and a scalar");
5359         return FALSE;
5360     }
5361
5362     if (type == OP_LIST &&
5363         (flags & OPf_WANT) == OPf_WANT_SCALAR &&
5364         o->op_private & OPpLVAL_INTRO)
5365         return FALSE;
5366
5367     if (type == OP_LIST || flags & OPf_PARENS ||
5368         type == OP_RV2AV || type == OP_RV2HV ||
5369         type == OP_ASLICE || type == OP_HSLICE)
5370         return TRUE;
5371
5372     if (type == OP_PADAV || type == OP_PADHV)
5373         return TRUE;
5374
5375     if (type == OP_RV2SV)
5376         return FALSE;
5377
5378     return FALSE;
5379 }
5380
5381 /*
5382   Helper function for newASSIGNOP to detection commonality between the
5383   lhs and the rhs.  Marks all variables with PL_generation.  If it
5384   returns TRUE the assignment must be able to handle common variables.
5385 */
5386 PERL_STATIC_INLINE bool
5387 S_aassign_common_vars(pTHX_ OP* o)
5388 {
5389     OP *curop;
5390     for (curop = cUNOPo->op_first; curop; curop=curop->op_sibling) {
5391         if (PL_opargs[curop->op_type] & OA_DANGEROUS) {
5392             if (curop->op_type == OP_GV) {
5393                 GV *gv = cGVOPx_gv(curop);
5394                 if (gv == PL_defgv
5395                     || (int)GvASSIGN_GENERATION(gv) == PL_generation)
5396                     return TRUE;
5397                 GvASSIGN_GENERATION_set(gv, PL_generation);
5398             }
5399             else if (curop->op_type == OP_PADSV ||
5400                 curop->op_type == OP_PADAV ||
5401                 curop->op_type == OP_PADHV ||
5402                 curop->op_type == OP_PADANY)
5403                 {
5404                     if (PAD_COMPNAME_GEN(curop->op_targ)
5405                         == (STRLEN)PL_generation)
5406                         return TRUE;
5407                     PAD_COMPNAME_GEN_set(curop->op_targ, PL_generation);
5408
5409                 }
5410             else if (curop->op_type == OP_RV2CV)
5411                 return TRUE;
5412             else if (curop->op_type == OP_RV2SV ||
5413                 curop->op_type == OP_RV2AV ||
5414                 curop->op_type == OP_RV2HV ||
5415                 curop->op_type == OP_RV2GV) {
5416                 if (cUNOPx(curop)->op_first->op_type != OP_GV)  /* funny deref? */
5417                     return TRUE;
5418             }
5419             else if (curop->op_type == OP_PUSHRE) {
5420 #ifdef USE_ITHREADS
5421                 if (((PMOP*)curop)->op_pmreplrootu.op_pmtargetoff) {
5422                     GV *const gv = MUTABLE_GV(PAD_SVl(((PMOP*)curop)->op_pmreplrootu.op_pmtargetoff));
5423                     if (gv == PL_defgv
5424                         || (int)GvASSIGN_GENERATION(gv) == PL_generation)
5425                         return TRUE;
5426                     GvASSIGN_GENERATION_set(gv, PL_generation);
5427                 }
5428 #else
5429                 GV *const gv
5430                     = ((PMOP*)curop)->op_pmreplrootu.op_pmtargetgv;
5431                 if (gv) {
5432                     if (gv == PL_defgv
5433                         || (int)GvASSIGN_GENERATION(gv) == PL_generation)
5434                         return TRUE;
5435                     GvASSIGN_GENERATION_set(gv, PL_generation);
5436                 }
5437 #endif
5438             }
5439             else
5440                 return TRUE;
5441         }
5442
5443         if (curop->op_flags & OPf_KIDS) {
5444             if (aassign_common_vars(curop))
5445                 return TRUE;
5446         }
5447     }
5448     return FALSE;
5449 }
5450
5451 /*
5452 =for apidoc Am|OP *|newASSIGNOP|I32 flags|OP *left|I32 optype|OP *right
5453
5454 Constructs, checks, and returns an assignment op.  I<left> and I<right>
5455 supply the parameters of the assignment; they are consumed by this
5456 function and become part of the constructed op tree.
5457
5458 If I<optype> is C<OP_ANDASSIGN>, C<OP_ORASSIGN>, or C<OP_DORASSIGN>, then
5459 a suitable conditional optree is constructed.  If I<optype> is the opcode
5460 of a binary operator, such as C<OP_BIT_OR>, then an op is constructed that
5461 performs the binary operation and assigns the result to the left argument.
5462 Either way, if I<optype> is non-zero then I<flags> has no effect.
5463
5464 If I<optype> is zero, then a plain scalar or list assignment is
5465 constructed.  Which type of assignment it is is automatically determined.
5466 I<flags> gives the eight bits of C<op_flags>, except that C<OPf_KIDS>
5467 will be set automatically, and, shifted up eight bits, the eight bits
5468 of C<op_private>, except that the bit with value 1 or 2 is automatically
5469 set as required.
5470
5471 =cut
5472 */
5473
5474 OP *
5475 Perl_newASSIGNOP(pTHX_ I32 flags, OP *left, I32 optype, OP *right)
5476 {
5477     dVAR;
5478     OP *o;
5479
5480     if (optype) {
5481         if (optype == OP_ANDASSIGN || optype == OP_ORASSIGN || optype == OP_DORASSIGN) {
5482             return newLOGOP(optype, 0,
5483                 op_lvalue(scalar(left), optype),
5484                 newUNOP(OP_SASSIGN, 0, scalar(right)));
5485         }
5486         else {
5487             return newBINOP(optype, OPf_STACKED,
5488                 op_lvalue(scalar(left), optype), scalar(right));
5489         }
5490     }
5491
5492     if (is_list_assignment(left)) {
5493         static const char no_list_state[] = "Initialization of state variables"
5494             " in list context currently forbidden";
5495         OP *curop;
5496         bool maybe_common_vars = TRUE;
5497
5498         PL_modcount = 0;
5499         left = op_lvalue(left, OP_AASSIGN);
5500         curop = list(force_list(left));
5501         o = newBINOP(OP_AASSIGN, flags, list(force_list(right)), curop);
5502         o->op_private = (U8)(0 | (flags >> 8));
5503
5504         if ((left->op_type == OP_LIST
5505              || (left->op_type == OP_NULL && left->op_targ == OP_LIST)))
5506         {
5507             OP* lop = ((LISTOP*)left)->op_first;
5508             maybe_common_vars = FALSE;
5509             while (lop) {
5510                 if (lop->op_type == OP_PADSV ||
5511                     lop->op_type == OP_PADAV ||
5512                     lop->op_type == OP_PADHV ||
5513                     lop->op_type == OP_PADANY) {
5514                     if (!(lop->op_private & OPpLVAL_INTRO))
5515                         maybe_common_vars = TRUE;
5516
5517                     if (lop->op_private & OPpPAD_STATE) {
5518                         if (left->op_private & OPpLVAL_INTRO) {
5519                             /* Each variable in state($a, $b, $c) = ... */
5520                         }
5521                         else {
5522                             /* Each state variable in
5523                                (state $a, my $b, our $c, $d, undef) = ... */
5524                         }
5525                         yyerror(no_list_state);
5526                     } else {
5527                         /* Each my variable in
5528                            (state $a, my $b, our $c, $d, undef) = ... */
5529                     }
5530                 } else if (lop->op_type == OP_UNDEF ||
5531                            lop->op_type == OP_PUSHMARK) {
5532                     /* undef may be interesting in
5533                        (state $a, undef, state $c) */
5534                 } else {
5535                     /* Other ops in the list. */
5536                     maybe_common_vars = TRUE;
5537                 }
5538                 lop = lop->op_sibling;
5539             }
5540         }
5541         else if ((left->op_private & OPpLVAL_INTRO)
5542                 && (   left->op_type == OP_PADSV
5543                     || left->op_type == OP_PADAV
5544                     || left->op_type == OP_PADHV
5545                     || left->op_type == OP_PADANY))
5546         {
5547             if (left->op_type == OP_PADSV) maybe_common_vars = FALSE;
5548             if (left->op_private & OPpPAD_STATE) {
5549                 /* All single variable list context state assignments, hence
5550                    state ($a) = ...
5551                    (state $a) = ...
5552                    state @a = ...
5553                    state (@a) = ...
5554                    (state @a) = ...
5555                    state %a = ...
5556                    state (%a) = ...
5557                    (state %a) = ...
5558                 */
5559                 yyerror(no_list_state);
5560             }
5561         }
5562
5563         /* PL_generation sorcery:
5564          * an assignment like ($a,$b) = ($c,$d) is easier than
5565          * ($a,$b) = ($c,$a), since there is no need for temporary vars.
5566          * To detect whether there are common vars, the global var
5567          * PL_generation is incremented for each assign op we compile.
5568          * Then, while compiling the assign op, we run through all the
5569          * variables on both sides of the assignment, setting a spare slot
5570          * in each of them to PL_generation. If any of them already have
5571          * that value, we know we've got commonality.  We could use a
5572          * single bit marker, but then we'd have to make 2 passes, first
5573          * to clear the flag, then to test and set it.  To find somewhere
5574          * to store these values, evil chicanery is done with SvUVX().
5575          */
5576
5577         if (maybe_common_vars) {
5578             PL_generation++;
5579             if (aassign_common_vars(o))
5580                 o->op_private |= OPpASSIGN_COMMON;
5581             LINKLIST(o);
5582         }
5583
5584         if (right && right->op_type == OP_SPLIT && !PL_madskills) {
5585             OP* tmpop = ((LISTOP*)right)->op_first;
5586             if (tmpop && (tmpop->op_type == OP_PUSHRE)) {
5587                 PMOP * const pm = (PMOP*)tmpop;
5588                 if (left->op_type == OP_RV2AV &&
5589                     !(left->op_private & OPpLVAL_INTRO) &&
5590                     !(o->op_private & OPpASSIGN_COMMON) )
5591                 {
5592                     tmpop = ((UNOP*)left)->op_first;
5593                     if (tmpop->op_type == OP_GV
5594 #ifdef USE_ITHREADS
5595                         && !pm->op_pmreplrootu.op_pmtargetoff
5596 #else
5597                         && !pm->op_pmreplrootu.op_pmtargetgv
5598 #endif
5599                         ) {
5600 #ifdef USE_ITHREADS
5601                         pm->op_pmreplrootu.op_pmtargetoff
5602                             = cPADOPx(tmpop)->op_padix;
5603                         cPADOPx(tmpop)->op_padix = 0;   /* steal it */
5604 #else
5605                         pm->op_pmreplrootu.op_pmtargetgv
5606                             = MUTABLE_GV(cSVOPx(tmpop)->op_sv);
5607                         cSVOPx(tmpop)->op_sv = NULL;    /* steal it */
5608 #endif
5609                         tmpop = cUNOPo->op_first;       /* to list (nulled) */
5610                         tmpop = ((UNOP*)tmpop)->op_first; /* to pushmark */
5611                         tmpop->op_sibling = NULL;       /* don't free split */
5612                         right->op_next = tmpop->op_next;  /* fix starting loc */
5613                         op_free(o);                     /* blow off assign */
5614                         right->op_flags &= ~OPf_WANT;
5615                                 /* "I don't know and I don't care." */
5616                         return right;
5617                     }
5618                 }
5619                 else {
5620                    if (PL_modcount < RETURN_UNLIMITED_NUMBER &&
5621                       ((LISTOP*)right)->op_last->op_type == OP_CONST)
5622                     {
5623                         SV *sv = ((SVOP*)((LISTOP*)right)->op_last)->op_sv;
5624                         if (SvIOK(sv) && SvIVX(sv) == 0)
5625                             sv_setiv(sv, PL_modcount+1);
5626                     }
5627                 }
5628             }
5629         }
5630         return o;
5631     }
5632     if (!right)
5633         right = newOP(OP_UNDEF, 0);
5634     if (right->op_type == OP_READLINE) {
5635         right->op_flags |= OPf_STACKED;
5636         return newBINOP(OP_NULL, flags, op_lvalue(scalar(left), OP_SASSIGN),
5637                 scalar(right));
5638     }
5639     else {
5640         o = newBINOP(OP_SASSIGN, flags,
5641             scalar(right), op_lvalue(scalar(left), OP_SASSIGN) );
5642     }
5643     return o;
5644 }
5645
5646 /*
5647 =for apidoc Am|OP *|newSTATEOP|I32 flags|char *label|OP *o
5648
5649 Constructs a state op (COP).  The state op is normally a C<nextstate> op,
5650 but will be a C<dbstate> op if debugging is enabled for currently-compiled
5651 code.  The state op is populated from L</PL_curcop> (or L</PL_compiling>).
5652 If I<label> is non-null, it supplies the name of a label to attach to
5653 the state op; this function takes ownership of the memory pointed at by
5654 I<label>, and will free it.  I<flags> gives the eight bits of C<op_flags>
5655 for the state op.
5656
5657 If I<o> is null, the state op is returned.  Otherwise the state op is
5658 combined with I<o> into a C<lineseq> list op, which is returned.  I<o>
5659 is consumed by this function and becomes part of the returned op tree.
5660
5661 =cut
5662 */
5663
5664 OP *
5665 Perl_newSTATEOP(pTHX_ I32 flags, char *label, OP *o)
5666 {
5667     dVAR;
5668     const U32 seq = intro_my();
5669     const U32 utf8 = flags & SVf_UTF8;
5670     COP *cop;
5671
5672     flags &= ~SVf_UTF8;
5673
5674     NewOp(1101, cop, 1, COP);
5675     if (PERLDB_LINE && CopLINE(PL_curcop) && PL_curstash != PL_debstash) {
5676         cop->op_type = OP_DBSTATE;
5677         cop->op_ppaddr = PL_ppaddr[ OP_DBSTATE ];
5678     }
5679     else {
5680         cop->op_type = OP_NEXTSTATE;
5681         cop->op_ppaddr = PL_ppaddr[ OP_NEXTSTATE ];
5682     }
5683     cop->op_flags = (U8)flags;
5684     CopHINTS_set(cop, PL_hints);
5685 #ifdef NATIVE_HINTS
5686     cop->op_private |= NATIVE_HINTS;
5687 #endif
5688     CopHINTS_set(&PL_compiling, CopHINTS_get(cop));
5689     cop->op_next = (OP*)cop;
5690
5691     cop->cop_seq = seq;
5692     cop->cop_warnings = DUP_WARNINGS(PL_curcop->cop_warnings);
5693     CopHINTHASH_set(cop, cophh_copy(CopHINTHASH_get(PL_curcop)));
5694     if (label) {
5695         Perl_cop_store_label(aTHX_ cop, label, strlen(label), utf8);
5696
5697         PL_hints |= HINT_BLOCK_SCOPE;
5698         /* It seems that we need to defer freeing this pointer, as other parts
5699            of the grammar end up wanting to copy it after this op has been
5700            created. */
5701         SAVEFREEPV(label);
5702     }
5703
5704     if (PL_parser && PL_parser->copline == NOLINE)
5705         CopLINE_set(cop, CopLINE(PL_curcop));
5706     else {
5707         CopLINE_set(cop, PL_parser->copline);
5708         PL_parser->copline = NOLINE;
5709     }
5710 #ifdef USE_ITHREADS
5711     CopFILE_set(cop, CopFILE(PL_curcop));       /* XXX share in a pvtable? */
5712 #else
5713     CopFILEGV_set(cop, CopFILEGV(PL_curcop));
5714 #endif
5715     CopSTASH_set(cop, PL_curstash);
5716
5717     if ((PERLDB_LINE || PERLDB_SAVESRC) && PL_curstash != PL_debstash) {
5718         /* this line can have a breakpoint - store the cop in IV */
5719         AV *av = CopFILEAVx(PL_curcop);
5720         if (av) {
5721             SV * const * const svp = av_fetch(av, (I32)CopLINE(cop), FALSE);
5722             if (svp && *svp != &PL_sv_undef ) {
5723                 (void)SvIOK_on(*svp);
5724                 SvIV_set(*svp, PTR2IV(cop));
5725             }
5726         }
5727     }
5728
5729     if (flags & OPf_SPECIAL)
5730         op_null((OP*)cop);
5731     return op_prepend_elem(OP_LINESEQ, (OP*)cop, o);
5732 }
5733
5734 /*
5735 =for apidoc Am|OP *|newLOGOP|I32 type|I32 flags|OP *first|OP *other
5736
5737 Constructs, checks, and returns a logical (flow control) op.  I<type>
5738 is the opcode.  I<flags> gives the eight bits of C<op_flags>, except
5739 that C<OPf_KIDS> will be set automatically, and, shifted up eight bits,
5740 the eight bits of C<op_private>, except that the bit with value 1 is
5741 automatically set.  I<first> supplies the expression controlling the
5742 flow, and I<other> supplies the side (alternate) chain of ops; they are
5743 consumed by this function and become part of the constructed op tree.
5744
5745 =cut
5746 */
5747
5748 OP *
5749 Perl_newLOGOP(pTHX_ I32 type, I32 flags, OP *first, OP *other)
5750 {
5751     dVAR;
5752
5753     PERL_ARGS_ASSERT_NEWLOGOP;
5754
5755     return new_logop(type, flags, &first, &other);
5756 }
5757
5758 STATIC OP *
5759 S_search_const(pTHX_ OP *o)
5760 {
5761     PERL_ARGS_ASSERT_SEARCH_CONST;
5762
5763     switch (o->op_type) {
5764         case OP_CONST:
5765             return o;
5766         case OP_NULL:
5767             if (o->op_flags & OPf_KIDS)
5768                 return search_const(cUNOPo->op_first);
5769             break;
5770         case OP_LEAVE:
5771         case OP_SCOPE:
5772         case OP_LINESEQ:
5773         {
5774             OP *kid;
5775             if (!(o->op_flags & OPf_KIDS))
5776                 return NULL;
5777             kid = cLISTOPo->op_first;
5778             do {
5779                 switch (kid->op_type) {
5780                     case OP_ENTER:
5781                     case OP_NULL:
5782                     case OP_NEXTSTATE:
5783                         kid = kid->op_sibling;
5784                         break;
5785                     default:
5786                         if (kid != cLISTOPo->op_last)
5787                             return NULL;
5788                         goto last;
5789                 }
5790             } while (kid);
5791             if (!kid)
5792                 kid = cLISTOPo->op_last;
5793 last:
5794             return search_const(kid);
5795         }
5796     }
5797
5798     return NULL;
5799 }
5800
5801 STATIC OP *
5802 S_new_logop(pTHX_ I32 type, I32 flags, OP** firstp, OP** otherp)
5803 {
5804     dVAR;
5805     LOGOP *logop;
5806     OP *o;
5807     OP *first;
5808     OP *other;
5809     OP *cstop = NULL;
5810     int prepend_not = 0;
5811
5812     PERL_ARGS_ASSERT_NEW_LOGOP;
5813
5814     first = *firstp;
5815     other = *otherp;
5816
5817     if (type == OP_XOR)         /* Not short circuit, but here by precedence. */
5818         return newBINOP(type, flags, scalar(first), scalar(other));
5819
5820     assert((PL_opargs[type] & OA_CLASS_MASK) == OA_LOGOP);
5821
5822     scalarboolean(first);
5823     /* optimize AND and OR ops that have NOTs as children */
5824     if (first->op_type == OP_NOT
5825         && (first->op_flags & OPf_KIDS)
5826         && ((first->op_flags & OPf_SPECIAL) /* unless ($x) { } */
5827             || (other->op_type == OP_NOT))  /* if (!$x && !$y) { } */
5828         && !PL_madskills) {
5829         if (type == OP_AND || type == OP_OR) {
5830             if (type == OP_AND)
5831                 type = OP_OR;
5832             else
5833                 type = OP_AND;
5834             op_null(first);
5835             if (other->op_type == OP_NOT) { /* !a AND|OR !b => !(a OR|AND b) */
5836                 op_null(other);
5837                 prepend_not = 1; /* prepend a NOT op later */
5838             }
5839         }
5840     }
5841     /* search for a constant op that could let us fold the test */
5842     if ((cstop = search_const(first))) {
5843         if (cstop->op_private & OPpCONST_STRICT)
5844             no_bareword_allowed(cstop);
5845         else if ((cstop->op_private & OPpCONST_BARE))
5846                 Perl_ck_warner(aTHX_ packWARN(WARN_BAREWORD), "Bareword found in conditional");
5847         if ((type == OP_AND &&  SvTRUE(((SVOP*)cstop)->op_sv)) ||
5848             (type == OP_OR  && !SvTRUE(((SVOP*)cstop)->op_sv)) ||
5849             (type == OP_DOR && !SvOK(((SVOP*)cstop)->op_sv))) {
5850             *firstp = NULL;
5851             if (other->op_type == OP_CONST)
5852                 other->op_private |= OPpCONST_SHORTCIRCUIT;
5853             if (PL_madskills) {
5854                 OP *newop = newUNOP(OP_NULL, 0, other);
5855                 op_getmad(first, newop, '1');
5856                 newop->op_targ = type;  /* set "was" field */
5857                 return newop;
5858             }
5859             op_free(first);
5860             if (other->op_type == OP_LEAVE)
5861                 other = newUNOP(OP_NULL, OPf_SPECIAL, other);
5862             else if (other->op_type == OP_MATCH
5863                   || other->op_type == OP_SUBST
5864                   || other->op_type == OP_TRANSR
5865                   || other->op_type == OP_TRANS)
5866                 /* Mark the op as being unbindable with =~ */
5867                 other->op_flags |= OPf_SPECIAL;
5868             else if (other->op_type == OP_CONST)
5869                 other->op_private |= OPpCONST_FOLDED;
5870             return other;
5871         }
5872         else {
5873             /* check for C<my $x if 0>, or C<my($x,$y) if 0> */
5874             const OP *o2 = other;
5875             if ( ! (o2->op_type == OP_LIST
5876                     && (( o2 = cUNOPx(o2)->op_first))
5877                     && o2->op_type == OP_PUSHMARK
5878                     && (( o2 = o2->op_sibling)) )
5879             )
5880                 o2 = other;
5881             if ((o2->op_type == OP_PADSV || o2->op_type == OP_PADAV
5882                         || o2->op_type == OP_PADHV)
5883                 && o2->op_private & OPpLVAL_INTRO
5884                 && !(o2->op_private & OPpPAD_STATE))
5885             {
5886                 Perl_ck_warner_d(aTHX_ packWARN(WARN_DEPRECATED),
5887                                  "Deprecated use of my() in false conditional");
5888             }
5889
5890             *otherp = NULL;
5891             if (first->op_type == OP_CONST)
5892                 first->op_private |= OPpCONST_SHORTCIRCUIT;
5893             if (PL_madskills) {
5894                 first = newUNOP(OP_NULL, 0, first);
5895                 op_getmad(other, first, '2');
5896                 first->op_targ = type;  /* set "was" field */
5897             }
5898             else
5899                 op_free(other);
5900             return first;
5901         }
5902     }
5903     else if ((first->op_flags & OPf_KIDS) && type != OP_DOR
5904         && ckWARN(WARN_MISC)) /* [#24076] Don't warn for <FH> err FOO. */
5905     {
5906         const OP * const k1 = ((UNOP*)first)->op_first;
5907         const OP * const k2 = k1->op_sibling;
5908         OPCODE warnop = 0;
5909         switch (first->op_type)
5910         {
5911         case OP_NULL:
5912             if (k2 && k2->op_type == OP_READLINE
5913                   && (k2->op_flags & OPf_STACKED)
5914                   && ((k1->op_flags & OPf_WANT) == OPf_WANT_SCALAR))
5915             {
5916                 warnop = k2->op_type;
5917             }
5918             break;
5919
5920         case OP_SASSIGN:
5921             if (k1->op_type == OP_READDIR
5922                   || k1->op_type == OP_GLOB
5923                   || (k1->op_type == OP_NULL && k1->op_targ == OP_GLOB)
5924                  || k1->op_type == OP_EACH
5925                  || k1->op_type == OP_AEACH)
5926             {
5927                 warnop = ((k1->op_type == OP_NULL)
5928                           ? (OPCODE)k1->op_targ : k1->op_type);
5929             }
5930             break;
5931         }
5932         if (warnop) {
5933             const line_t oldline = CopLINE(PL_curcop);
5934             /* This ensures that warnings are reported at the first line
5935                of the construction, not the last.  */
5936             CopLINE_set(PL_curcop, PL_parser->copline);
5937             Perl_warner(aTHX_ packWARN(WARN_MISC),
5938                  "Value of %s%s can be \"0\"; test with defined()",
5939                  PL_op_desc[warnop],
5940                  ((warnop == OP_READLINE || warnop == OP_GLOB)
5941                   ? " construct" : "() operator"));
5942             CopLINE_set(PL_curcop, oldline);
5943         }
5944     }
5945
5946     if (!other)
5947         return first;
5948
5949     if (type == OP_ANDASSIGN || type == OP_ORASSIGN || type == OP_DORASSIGN)
5950         other->op_private |= OPpASSIGN_BACKWARDS;  /* other is an OP_SASSIGN */
5951
5952     NewOp(1101, logop, 1, LOGOP);
5953
5954     logop->op_type = (OPCODE)type;
5955     logop->op_ppaddr = PL_ppaddr[type];
5956     logop->op_first = first;
5957     logop->op_flags = (U8)(flags | OPf_KIDS);
5958     logop->op_other = LINKLIST(other);
5959     logop->op_private = (U8)(1 | (flags >> 8));
5960
5961     /* establish postfix order */
5962     logop->op_next = LINKLIST(first);
5963     first->op_next = (OP*)logop;
5964     first->op_sibling = other;
5965
5966     CHECKOP(type,logop);
5967
5968     o = newUNOP(prepend_not ? OP_NOT : OP_NULL, 0, (OP*)logop);
5969     other->op_next = o;
5970
5971     return o;
5972 }
5973
5974 /*
5975 =for apidoc Am|OP *|newCONDOP|I32 flags|OP *first|OP *trueop|OP *falseop
5976
5977 Constructs, checks, and returns a conditional-expression (C<cond_expr>)
5978 op.  I<flags> gives the eight bits of C<op_flags>, except that C<OPf_KIDS>
5979 will be set automatically, and, shifted up eight bits, the eight bits of
5980 C<op_private>, except that the bit with value 1 is automatically set.
5981 I<first> supplies the expression selecting between the two branches,
5982 and I<trueop> and I<falseop> supply the branches; they are consumed by
5983 this function and become part of the constructed op tree.
5984
5985 =cut
5986 */
5987
5988 OP *
5989 Perl_newCONDOP(pTHX_ I32 flags, OP *first, OP *trueop, OP *falseop)
5990 {
5991     dVAR;
5992     LOGOP *logop;
5993     OP *start;
5994     OP *o;
5995     OP *cstop;
5996
5997     PERL_ARGS_ASSERT_NEWCONDOP;
5998
5999     if (!falseop)
6000         return newLOGOP(OP_AND, 0, first, trueop);
6001     if (!trueop)
6002         return newLOGOP(OP_OR, 0, first, falseop);
6003
6004     scalarboolean(first);
6005     if ((cstop = search_const(first))) {
6006         /* Left or right arm of the conditional?  */
6007         const bool left = SvTRUE(((SVOP*)cstop)->op_sv);
6008         OP *live = left ? trueop : falseop;
6009         OP *const dead = left ? falseop : trueop;
6010         if (cstop->op_private & OPpCONST_BARE &&
6011             cstop->op_private & OPpCONST_STRICT) {
6012             no_bareword_allowed(cstop);
6013         }
6014         if (PL_madskills) {
6015             /* This is all dead code when PERL_MAD is not defined.  */
6016             live = newUNOP(OP_NULL, 0, live);
6017             op_getmad(first, live, 'C');
6018             op_getmad(dead, live, left ? 'e' : 't');
6019         } else {
6020             op_free(first);
6021             op_free(dead);
6022         }
6023         if (live->op_type == OP_LEAVE)
6024             live = newUNOP(OP_NULL, OPf_SPECIAL, live);
6025         else if (live->op_type == OP_MATCH || live->op_type == OP_SUBST
6026               || live->op_type == OP_TRANS || live->op_type == OP_TRANSR)
6027             /* Mark the op as being unbindable with =~ */
6028             live->op_flags |= OPf_SPECIAL;
6029         else if (live->op_type == OP_CONST)
6030             live->op_private |= OPpCONST_FOLDED;
6031         return live;
6032     }
6033     NewOp(1101, logop, 1, LOGOP);
6034     logop->op_type = OP_COND_EXPR;
6035     logop->op_ppaddr = PL_ppaddr[OP_COND_EXPR];
6036     logop->op_first = first;
6037     logop->op_flags = (U8)(flags | OPf_KIDS);
6038     logop->op_private = (U8)(1 | (flags >> 8));
6039     logop->op_other = LINKLIST(trueop);
6040     logop->op_next = LINKLIST(falseop);
6041
6042     CHECKOP(OP_COND_EXPR, /* that's logop->op_type */
6043             logop);
6044
6045     /* establish postfix order */
6046     start = LINKLIST(first);
6047     first->op_next = (OP*)logop;
6048
6049     first->op_sibling = trueop;
6050     trueop->op_sibling = falseop;
6051     o = newUNOP(OP_NULL, 0, (OP*)logop);
6052
6053     trueop->op_next = falseop->op_next = o;
6054
6055     o->op_next = start;
6056     return o;
6057 }
6058
6059 /*
6060 =for apidoc Am|OP *|newRANGE|I32 flags|OP *left|OP *right
6061
6062 Constructs and returns a C<range> op, with subordinate C<flip> and
6063 C<flop> ops.  I<flags> gives the eight bits of C<op_flags> for the
6064 C<flip> op and, shifted up eight bits, the eight bits of C<op_private>
6065 for both the C<flip> and C<range> ops, except that the bit with value
6066 1 is automatically set.  I<left> and I<right> supply the expressions
6067 controlling the endpoints of the range; they are consumed by this function
6068 and become part of the constructed op tree.
6069
6070 =cut
6071 */
6072
6073 OP *
6074 Perl_newRANGE(pTHX_ I32 flags, OP *left, OP *right)
6075 {
6076     dVAR;
6077     LOGOP *range;
6078     OP *flip;
6079     OP *flop;
6080     OP *leftstart;
6081     OP *o;
6082
6083     PERL_ARGS_ASSERT_NEWRANGE;
6084
6085     NewOp(1101, range, 1, LOGOP);
6086
6087     range->op_type = OP_RANGE;
6088     range->op_ppaddr = PL_ppaddr[OP_RANGE];
6089     range->op_first = left;
6090     range->op_flags = OPf_KIDS;
6091     leftstart = LINKLIST(left);
6092     range->op_other = LINKLIST(right);
6093     range->op_private = (U8)(1 | (flags >> 8));
6094
6095     left->op_sibling = right;
6096
6097     range->op_next = (OP*)range;
6098     flip = newUNOP(OP_FLIP, flags, (OP*)range);
6099     flop = newUNOP(OP_FLOP, 0, flip);
6100     o = newUNOP(OP_NULL, 0, flop);
6101     LINKLIST(flop);
6102     range->op_next = leftstart;
6103
6104     left->op_next = flip;
6105     right->op_next = flop;
6106
6107     range->op_targ = pad_alloc(OP_RANGE, SVs_PADMY);
6108     sv_upgrade(PAD_SV(range->op_targ), SVt_PVNV);
6109     flip->op_targ = pad_alloc(OP_RANGE, SVs_PADMY);
6110     sv_upgrade(PAD_SV(flip->op_targ), SVt_PVNV);
6111
6112     flip->op_private =  left->op_type == OP_CONST ? OPpFLIP_LINENUM : 0;
6113     flop->op_private = right->op_type == OP_CONST ? OPpFLIP_LINENUM : 0;
6114
6115     /* check barewords before they might be optimized aways */
6116     if (flip->op_private && cSVOPx(left)->op_private & OPpCONST_STRICT)
6117         no_bareword_allowed(left);
6118     if (flop->op_private && cSVOPx(right)->op_private & OPpCONST_STRICT)
6119         no_bareword_allowed(right);
6120
6121     flip->op_next = o;
6122     if (!flip->op_private || !flop->op_private)
6123         LINKLIST(o);            /* blow off optimizer unless constant */
6124
6125     return o;
6126 }
6127
6128 /*
6129 =for apidoc Am|OP *|newLOOPOP|I32 flags|I32 debuggable|OP *expr|OP *block
6130
6131 Constructs, checks, and returns an op tree expressing a loop.  This is
6132 only a loop in the control flow through the op tree; it does not have
6133 the heavyweight loop structure that allows exiting the loop by C<last>
6134 and suchlike.  I<flags> gives the eight bits of C<op_flags> for the
6135 top-level op, except that some bits will be set automatically as required.
6136 I<expr> supplies the expression controlling loop iteration, and I<block>
6137 supplies the body of the loop; they are consumed by this function and
6138 become part of the constructed op tree.  I<debuggable> is currently
6139 unused and should always be 1.
6140
6141 =cut
6142 */
6143
6144 OP *
6145 Perl_newLOOPOP(pTHX_ I32 flags, I32 debuggable, OP *expr, OP *block)
6146 {
6147     dVAR;
6148     OP* listop;
6149     OP* o;
6150     const bool once = block && block->op_flags & OPf_SPECIAL &&
6151       (block->op_type == OP_ENTERSUB || block->op_type == OP_NULL);
6152
6153     PERL_UNUSED_ARG(debuggable);
6154
6155     if (expr) {
6156         if (once && expr->op_type == OP_CONST && !SvTRUE(((SVOP*)expr)->op_sv))
6157             return block;       /* do {} while 0 does once */
6158         if (expr->op_type == OP_READLINE
6159             || expr->op_type == OP_READDIR
6160             || expr->op_type == OP_GLOB
6161             || expr->op_type == OP_EACH || expr->op_type == OP_AEACH
6162             || (expr->op_type == OP_NULL && expr->op_targ == OP_GLOB)) {
6163             expr = newUNOP(OP_DEFINED, 0,
6164                 newASSIGNOP(0, newDEFSVOP(), 0, expr) );
6165         } else if (expr->op_flags & OPf_KIDS) {
6166             const OP * const k1 = ((UNOP*)expr)->op_first;
6167             const OP * const k2 = k1 ? k1->op_sibling : NULL;
6168             switch (expr->op_type) {
6169               case OP_NULL:
6170                 if (k2 && (k2->op_type == OP_READLINE || k2->op_type == OP_READDIR)
6171                       && (k2->op_flags & OPf_STACKED)
6172                       && ((k1->op_flags & OPf_WANT) == OPf_WANT_SCALAR))
6173                     expr = newUNOP(OP_DEFINED, 0, expr);
6174                 break;
6175
6176               case OP_SASSIGN:
6177                 if (k1 && (k1->op_type == OP_READDIR
6178                       || k1->op_type == OP_GLOB
6179                       || (k1->op_type == OP_NULL && k1->op_targ == OP_GLOB)
6180                      || k1->op_type == OP_EACH
6181                      || k1->op_type == OP_AEACH))
6182                     expr = newUNOP(OP_DEFINED, 0, expr);
6183                 break;
6184             }
6185         }
6186     }
6187
6188     /* if block is null, the next op_append_elem() would put UNSTACK, a scalar
6189      * op, in listop. This is wrong. [perl #27024] */
6190     if (!block)
6191         block = newOP(OP_NULL, 0);
6192     listop = op_append_elem(OP_LINESEQ, block, newOP(OP_UNSTACK, 0));
6193     o = new_logop(OP_AND, 0, &expr, &listop);
6194
6195     if (listop)
6196         ((LISTOP*)listop)->op_last->op_next = LINKLIST(o);
6197
6198     if (once && o != listop)
6199         o->op_next = ((LOGOP*)cUNOPo->op_first)->op_other;
6200
6201     if (o == listop)
6202         o = newUNOP(OP_NULL, 0, o);     /* or do {} while 1 loses outer block */
6203
6204     o->op_flags |= flags;
6205     o = op_scope(o);
6206     o->op_flags |= OPf_SPECIAL; /* suppress POPBLOCK curpm restoration*/
6207     return o;
6208 }
6209
6210 /*
6211 =for apidoc Am|OP *|newWHILEOP|I32 flags|I32 debuggable|LOOP *loop|OP *expr|OP *block|OP *cont|I32 has_my
6212
6213 Constructs, checks, and returns an op tree expressing a C<while> loop.
6214 This is a heavyweight loop, with structure that allows exiting the loop
6215 by C<last> and suchlike.
6216
6217 I<loop> is an optional preconstructed C<enterloop> op to use in the
6218 loop; if it is null then a suitable op will be constructed automatically.
6219 I<expr> supplies the loop's controlling expression.  I<block> supplies the
6220 main body of the loop, and I<cont> optionally supplies a C<continue> block
6221 that operates as a second half of the body.  All of these optree inputs
6222 are consumed by this function and become part of the constructed op tree.
6223
6224 I<flags> gives the eight bits of C<op_flags> for the C<leaveloop>
6225 op and, shifted up eight bits, the eight bits of C<op_private> for
6226 the C<leaveloop> op, except that (in both cases) some bits will be set
6227 automatically.  I<debuggable> is currently unused and should always be 1.
6228 I<has_my> can be supplied as true to force the
6229 loop body to be enclosed in its own scope.
6230
6231 =cut
6232 */
6233
6234 OP *
6235 Perl_newWHILEOP(pTHX_ I32 flags, I32 debuggable, LOOP *loop,
6236         OP *expr, OP *block, OP *cont, I32 has_my)
6237 {
6238     dVAR;
6239     OP *redo;
6240     OP *next = NULL;
6241     OP *listop;
6242     OP *o;
6243     U8 loopflags = 0;
6244
6245     PERL_UNUSED_ARG(debuggable);
6246
6247     if (expr) {
6248         if (expr->op_type == OP_READLINE
6249          || expr->op_type == OP_READDIR
6250          || expr->op_type == OP_GLOB
6251          || expr->op_type == OP_EACH || expr->op_type == OP_AEACH
6252                      || (expr->op_type == OP_NULL && expr->op_targ == OP_GLOB)) {
6253             expr = newUNOP(OP_DEFINED, 0,
6254                 newASSIGNOP(0, newDEFSVOP(), 0, expr) );
6255         } else if (expr->op_flags & OPf_KIDS) {
6256             const OP * const k1 = ((UNOP*)expr)->op_first;
6257             const OP * const k2 = (k1) ? k1->op_sibling : NULL;
6258             switch (expr->op_type) {
6259               case OP_NULL:
6260                 if (k2 && (k2->op_type == OP_READLINE || k2->op_type == OP_READDIR)
6261                       && (k2->op_flags & OPf_STACKED)
6262                       && ((k1->op_flags & OPf_WANT) == OPf_WANT_SCALAR))
6263                     expr = newUNOP(OP_DEFINED, 0, expr);
6264                 break;
6265
6266               case OP_SASSIGN:
6267                 if (k1 && (k1->op_type == OP_READDIR
6268                       || k1->op_type == OP_GLOB
6269                       || (k1->op_type == OP_NULL && k1->op_targ == OP_GLOB)
6270                      || k1->op_type == OP_EACH
6271                      || k1->op_type == OP_AEACH))
6272                     expr = newUNOP(OP_DEFINED, 0, expr);
6273                 break;
6274             }
6275         }
6276     }
6277
6278     if (!block)
6279         block = newOP(OP_NULL, 0);
6280     else if (cont || has_my) {
6281         block = op_scope(block);
6282     }
6283
6284     if (cont) {
6285         next = LINKLIST(cont);
6286     }
6287     if (expr) {
6288         OP * const unstack = newOP(OP_UNSTACK, 0);
6289         if (!next)
6290             next = unstack;
6291         cont = op_append_elem(OP_LINESEQ, cont, unstack);
6292     }
6293
6294     assert(block);
6295     listop = op_append_list(OP_LINESEQ, block, cont);
6296     assert(listop);
6297     redo = LINKLIST(listop);
6298
6299     if (expr) {
6300         scalar(listop);
6301         o = new_logop(OP_AND, 0, &expr, &listop);
6302         if (o == expr && o->op_type == OP_CONST && !SvTRUE(cSVOPo->op_sv)) {
6303             op_free((OP*)loop);
6304             return expr;                /* listop already freed by new_logop */
6305         }
6306         if (listop)
6307             ((LISTOP*)listop)->op_last->op_next =
6308                 (o == listop ? redo : LINKLIST(o));
6309     }
6310     else
6311         o = listop;
6312
6313     if (!loop) {
6314         NewOp(1101,loop,1,LOOP);
6315         loop->op_type = OP_ENTERLOOP;
6316         loop->op_ppaddr = PL_ppaddr[OP_ENTERLOOP];
6317         loop->op_private = 0;
6318         loop->op_next = (OP*)loop;
6319     }
6320
6321     o = newBINOP(OP_LEAVELOOP, 0, (OP*)loop, o);
6322
6323     loop->op_redoop = redo;
6324     loop->op_lastop = o;
6325     o->op_private |= loopflags;
6326
6327     if (next)
6328         loop->op_nextop = next;
6329     else
6330         loop->op_nextop = o;
6331
6332     o->op_flags |= flags;
6333     o->op_private |= (flags >> 8);
6334     return o;
6335 }
6336
6337 /*
6338 =for apidoc Am|OP *|newFOROP|I32 flags|OP *sv|OP *expr|OP *block|OP *cont
6339
6340 Constructs, checks, and returns an op tree expressing a C<foreach>
6341 loop (iteration through a list of values).  This is a heavyweight loop,
6342 with structure that allows exiting the loop by C<last> and suchlike.
6343
6344 I<sv> optionally supplies the variable that will be aliased to each
6345 item in turn; if null, it defaults to C<$_> (either lexical or global).
6346 I<expr> supplies the list of values to iterate over.  I<block> supplies
6347 the main body of the loop, and I<cont> optionally supplies a C<continue>
6348 block that operates as a second half of the body.  All of these optree
6349 inputs are consumed by this function and become part of the constructed
6350 op tree.
6351
6352 I<flags> gives the eight bits of C<op_flags> for the C<leaveloop>
6353 op and, shifted up eight bits, the eight bits of C<op_private> for
6354 the C<leaveloop> op, except that (in both cases) some bits will be set
6355 automatically.
6356
6357 =cut
6358 */
6359
6360 OP *
6361 Perl_newFOROP(pTHX_ I32 flags, OP *sv, OP *expr, OP *block, OP *cont)
6362 {
6363     dVAR;
6364     LOOP *loop;
6365     OP *wop;
6366     PADOFFSET padoff = 0;
6367     I32 iterflags = 0;
6368     I32 iterpflags = 0;
6369     OP *madsv = NULL;
6370
6371     PERL_ARGS_ASSERT_NEWFOROP;
6372
6373     if (sv) {
6374         if (sv->op_type == OP_RV2SV) {  /* symbol table variable */
6375             iterpflags = sv->op_private & OPpOUR_INTRO; /* for our $x () */
6376             sv->op_type = OP_RV2GV;
6377             sv->op_ppaddr = PL_ppaddr[OP_RV2GV];
6378
6379             /* The op_type check is needed to prevent a possible segfault
6380              * if the loop variable is undeclared and 'strict vars' is in
6381              * effect. This is illegal but is nonetheless parsed, so we
6382              * may reach this point with an OP_CONST where we're expecting
6383              * an OP_GV.
6384              */
6385             if (cUNOPx(sv)->op_first->op_type == OP_GV
6386              && cGVOPx_gv(cUNOPx(sv)->op_first) == PL_defgv)
6387                 iterpflags |= OPpITER_DEF;
6388         }
6389         else if (sv->op_type == OP_PADSV) { /* private variable */
6390             iterpflags = sv->op_private & OPpLVAL_INTRO; /* for my $x () */
6391             padoff = sv->op_targ;
6392             if (PL_madskills)
6393                 madsv = sv;
6394             else {
6395                 sv->op_targ = 0;
6396                 op_free(sv);
6397             }
6398             sv = NULL;
6399         }
6400         else
6401             Perl_croak(aTHX_ "Can't use %s for loop variable", PL_op_desc[sv->op_type]);
6402         if (padoff) {
6403             SV *const namesv = PAD_COMPNAME_SV(padoff);
6404             STRLEN len;
6405             const char *const name = SvPV_const(namesv, len);
6406
6407             if (len == 2 && name[0] == '$' && name[1] == '_')
6408                 iterpflags |= OPpITER_DEF;
6409         }
6410     }
6411     else {
6412         const PADOFFSET offset = pad_findmy_pvs("$_", 0);
6413         if (offset == NOT_IN_PAD || PAD_COMPNAME_FLAGS_isOUR(offset)) {
6414             sv = newGVOP(OP_GV, 0, PL_defgv);
6415         }
6416         else {
6417             padoff = offset;
6418         }
6419         iterpflags |= OPpITER_DEF;
6420     }
6421     if (expr->op_type == OP_RV2AV || expr->op_type == OP_PADAV) {
6422         expr = op_lvalue(force_list(scalar(ref(expr, OP_ITER))), OP_GREPSTART);
6423         iterflags |= OPf_STACKED;
6424     }
6425     else if (expr->op_type == OP_NULL &&
6426              (expr->op_flags & OPf_KIDS) &&
6427              ((BINOP*)expr)->op_first->op_type == OP_FLOP)
6428     {
6429         /* Basically turn for($x..$y) into the same as for($x,$y), but we
6430          * set the STACKED flag to indicate that these values are to be
6431          * treated as min/max values by 'pp_enteriter'.
6432          */
6433         const UNOP* const flip = (UNOP*)((UNOP*)((BINOP*)expr)->op_first)->op_first;
6434         LOGOP* const range = (LOGOP*) flip->op_first;
6435         OP* const left  = range->op_first;
6436         OP* const right = left->op_sibling;
6437         LISTOP* listop;
6438
6439         range->op_flags &= ~OPf_KIDS;
6440         range->op_first = NULL;
6441
6442         listop = (LISTOP*)newLISTOP(OP_LIST, 0, left, right);
6443         listop->op_first->op_next = range->op_next;
6444         left->op_next = range->op_other;
6445         right->op_next = (OP*)listop;
6446         listop->op_next = listop->op_first;
6447
6448 #ifdef PERL_MAD
6449         op_getmad(expr,(OP*)listop,'O');
6450 #else
6451         op_free(expr);
6452 #endif
6453         expr = (OP*)(listop);
6454         op_null(expr);
6455         iterflags |= OPf_STACKED;
6456     }
6457     else {
6458         expr = op_lvalue(force_list(expr), OP_GREPSTART);
6459     }
6460
6461     loop = (LOOP*)list(convert(OP_ENTERITER, iterflags,
6462                                op_append_elem(OP_LIST, expr, scalar(sv))));
6463     assert(!loop->op_next);
6464     /* for my  $x () sets OPpLVAL_INTRO;
6465      * for our $x () sets OPpOUR_INTRO */
6466     loop->op_private = (U8)iterpflags;
6467     if (loop->op_slabbed
6468      && DIFF(loop, OpSLOT(loop)->opslot_next)
6469          < SIZE_TO_PSIZE(sizeof(LOOP)))
6470     {
6471         LOOP *tmp;
6472         NewOp(1234,tmp,1,LOOP);
6473         Copy(loop,tmp,1,LISTOP);
6474         S_op_destroy(aTHX_ (OP*)loop);
6475         loop = tmp;
6476     }
6477     else if (!loop->op_slabbed)
6478         loop = (LOOP*)PerlMemShared_realloc(loop, sizeof(LOOP));
6479     loop->op_targ = padoff;
6480     wop = newWHILEOP(flags, 1, loop, newOP(OP_ITER, 0), block, cont, 0);
6481     if (madsv)
6482         op_getmad(madsv, (OP*)loop, 'v');
6483     return wop;
6484 }
6485
6486 /*
6487 =for apidoc Am|OP *|newLOOPEX|I32 type|OP *label
6488
6489 Constructs, checks, and returns a loop-exiting op (such as C<goto>
6490 or C<last>).  I<type> is the opcode.  I<label> supplies the parameter
6491 determining the target of the op; it is consumed by this function and
6492 becomes part of the constructed op tree.
6493
6494 =cut
6495 */
6496
6497 OP*
6498 Perl_newLOOPEX(pTHX_ I32 type, OP *label)
6499 {
6500     dVAR;
6501     OP *o = NULL;
6502
6503     PERL_ARGS_ASSERT_NEWLOOPEX;
6504
6505     assert((PL_opargs[type] & OA_CLASS_MASK) == OA_LOOPEXOP);
6506
6507     if (type != OP_GOTO) {
6508         /* "last()" means "last" */
6509         if (label->op_type == OP_STUB && (label->op_flags & OPf_PARENS)) {
6510             o = newOP(type, OPf_SPECIAL);
6511         }
6512     }
6513     else {
6514         /* Check whether it's going to be a goto &function */
6515         if (label->op_type == OP_ENTERSUB
6516                 && !(label->op_flags & OPf_STACKED))
6517             label = newUNOP(OP_REFGEN, 0, op_lvalue(label, OP_REFGEN));
6518     }
6519
6520     /* Check for a constant argument */
6521     if (label->op_type == OP_CONST) {
6522             SV * const sv = ((SVOP *)label)->op_sv;
6523             STRLEN l;
6524             const char *s = SvPV_const(sv,l);
6525             if (l == strlen(s)) {
6526                 o = newPVOP(type,
6527                             SvUTF8(((SVOP*)label)->op_sv),
6528                             savesharedpv(
6529                                 SvPV_nolen_const(((SVOP*)label)->op_sv)));
6530             }
6531     }
6532
6533     /* If we have already created an op, we do not need the label. */
6534     if (o)
6535 #ifdef PERL_MAD
6536                 op_getmad(label,o,'L');
6537 #else
6538                 op_free(label);
6539 #endif
6540     else o = newUNOP(type, OPf_STACKED, label);
6541
6542     PL_hints |= HINT_BLOCK_SCOPE;
6543     return o;
6544 }
6545
6546 /* if the condition is a literal array or hash
6547    (or @{ ... } etc), make a reference to it.
6548  */
6549 STATIC OP *
6550 S_ref_array_or_hash(pTHX_ OP *cond)
6551 {
6552     if (cond
6553     && (cond->op_type == OP_RV2AV
6554     ||  cond->op_type == OP_PADAV
6555     ||  cond->op_type == OP_RV2HV
6556     ||  cond->op_type == OP_PADHV))
6557
6558         return newUNOP(OP_REFGEN, 0, op_lvalue(cond, OP_REFGEN));
6559
6560     else if(cond
6561     && (cond->op_type == OP_ASLICE
6562     ||  cond->op_type == OP_HSLICE)) {
6563
6564         /* anonlist now needs a list from this op, was previously used in
6565          * scalar context */
6566         cond->op_flags |= ~(OPf_WANT_SCALAR | OPf_REF);
6567         cond->op_flags |= OPf_WANT_LIST;
6568
6569         return newANONLIST(op_lvalue(cond, OP_ANONLIST));
6570     }
6571
6572     else
6573         return cond;
6574 }
6575
6576 /* These construct the optree fragments representing given()
6577    and when() blocks.
6578
6579    entergiven and enterwhen are LOGOPs; the op_other pointer
6580    points up to the associated leave op. We need this so we
6581    can put it in the context and make break/continue work.
6582    (Also, of course, pp_enterwhen will jump straight to
6583    op_other if the match fails.)
6584  */
6585
6586 STATIC OP *
6587 S_newGIVWHENOP(pTHX_ OP *cond, OP *block,
6588                    I32 enter_opcode, I32 leave_opcode,
6589                    PADOFFSET entertarg)
6590 {
6591     dVAR;
6592     LOGOP *enterop;
6593     OP *o;
6594
6595     PERL_ARGS_ASSERT_NEWGIVWHENOP;
6596
6597     NewOp(1101, enterop, 1, LOGOP);
6598     enterop->op_type = (Optype)enter_opcode;
6599     enterop->op_ppaddr = PL_ppaddr[enter_opcode];
6600     enterop->op_flags =  (U8) OPf_KIDS;
6601     enterop->op_targ = ((entertarg == NOT_IN_PAD) ? 0 : entertarg);
6602     enterop->op_private = 0;
6603
6604     o = newUNOP(leave_opcode, 0, (OP *) enterop);
6605
6606     if (cond) {
6607         enterop->op_first = scalar(cond);
6608         cond->op_sibling = block;
6609
6610         o->op_next = LINKLIST(cond);
6611         cond->op_next = (OP *) enterop;
6612     }
6613     else {
6614         /* This is a default {} block */
6615         enterop->op_first = block;
6616         enterop->op_flags |= OPf_SPECIAL;
6617         o      ->op_flags |= OPf_SPECIAL;
6618
6619         o->op_next = (OP *) enterop;
6620     }
6621
6622     CHECKOP(enter_opcode, enterop); /* Currently does nothing, since
6623                                        entergiven and enterwhen both
6624                                        use ck_null() */
6625
6626     enterop->op_next = LINKLIST(block);
6627     block->op_next = enterop->op_other = o;
6628
6629     return o;
6630 }
6631
6632 /* Does this look like a boolean operation? For these purposes
6633    a boolean operation is:
6634      - a subroutine call [*]
6635      - a logical connective
6636      - a comparison operator
6637      - a filetest operator, with the exception of -s -M -A -C
6638      - defined(), exists() or eof()
6639      - /$re/ or $foo =~ /$re/
6640
6641    [*] possibly surprising
6642  */
6643 STATIC bool
6644 S_looks_like_bool(pTHX_ const OP *o)
6645 {
6646     dVAR;
6647
6648     PERL_ARGS_ASSERT_LOOKS_LIKE_BOOL;
6649
6650     switch(o->op_type) {
6651         case OP_OR:
6652         case OP_DOR:
6653             return looks_like_bool(cLOGOPo->op_first);
6654
6655         case OP_AND:
6656             return (
6657                 looks_like_bool(cLOGOPo->op_first)
6658              && looks_like_bool(cLOGOPo->op_first->op_sibling));
6659
6660         case OP_NULL:
6661         case OP_SCALAR:
6662             return (
6663                 o->op_flags & OPf_KIDS
6664             && looks_like_bool(cUNOPo->op_first));
6665
6666         case OP_ENTERSUB:
6667
6668         case OP_NOT:    case OP_XOR:
6669
6670         case OP_EQ:     case OP_NE:     case OP_LT:
6671         case OP_GT:     case OP_LE:     case OP_GE:
6672
6673         case OP_I_EQ:   case OP_I_NE:   case OP_I_LT:
6674         case OP_I_GT:   case OP_I_LE:   case OP_I_GE:
6675
6676         case OP_SEQ:    case OP_SNE:    case OP_SLT:
6677         case OP_SGT:    case OP_SLE:    case OP_SGE:
6678
6679         case OP_SMARTMATCH:
6680
6681         case OP_FTRREAD:  case OP_FTRWRITE: case OP_FTREXEC:
6682         case OP_FTEREAD:  case OP_FTEWRITE: case OP_FTEEXEC:
6683         case OP_FTIS:     case OP_FTEOWNED: case OP_FTROWNED:
6684         case OP_FTZERO:   case OP_FTSOCK:   case OP_FTCHR:
6685         case OP_FTBLK:    case OP_FTFILE:   case OP_FTDIR:
6686         case OP_FTPIPE:   case OP_FTLINK:   case OP_FTSUID:
6687         case OP_FTSGID:   case OP_FTSVTX:   case OP_FTTTY:
6688         case OP_FTTEXT:   case OP_FTBINARY:
6689
6690         case OP_DEFINED: case OP_EXISTS:
6691         case OP_MATCH:   case OP_EOF:
6692
6693         case OP_FLOP:
6694
6695             return TRUE;
6696
6697         case OP_CONST:
6698             /* Detect comparisons that have been optimized away */
6699             if (cSVOPo->op_sv == &PL_sv_yes
6700             ||  cSVOPo->op_sv == &PL_sv_no)
6701
6702                 return TRUE;
6703             else
6704                 return FALSE;
6705
6706         /* FALL THROUGH */
6707         default:
6708             return FALSE;
6709     }
6710 }
6711
6712 /*
6713 =for apidoc Am|OP *|newGIVENOP|OP *cond|OP *block|PADOFFSET defsv_off
6714
6715 Constructs, checks, and returns an op tree expressing a C<given> block.
6716 I<cond> supplies the expression that will be locally assigned to a lexical
6717 variable, and I<block> supplies the body of the C<given> construct; they
6718 are consumed by this function and become part of the constructed op tree.
6719 I<defsv_off> is the pad offset of the scalar lexical variable that will
6720 be affected.  If it is 0, the global $_ will be used.
6721
6722 =cut
6723 */
6724
6725 OP *
6726 Perl_newGIVENOP(pTHX_ OP *cond, OP *block, PADOFFSET defsv_off)
6727 {
6728     dVAR;
6729     PERL_ARGS_ASSERT_NEWGIVENOP;
6730     return newGIVWHENOP(
6731         ref_array_or_hash(cond),
6732         block,
6733         OP_ENTERGIVEN, OP_LEAVEGIVEN,
6734         defsv_off);
6735 }
6736
6737 /*
6738 =for apidoc Am|OP *|newWHENOP|OP *cond|OP *block
6739
6740 Constructs, checks, and returns an op tree expressing a C<when> block.
6741 I<cond> supplies the test expression, and I<block> supplies the block
6742 that will be executed if the test evaluates to true; they are consumed
6743 by this function and become part of the constructed op tree.  I<cond>
6744 will be interpreted DWIMically, often as a comparison against C<$_>,
6745 and may be null to generate a C<default> block.
6746
6747 =cut
6748 */
6749
6750 OP *
6751 Perl_newWHENOP(pTHX_ OP *cond, OP *block)
6752 {
6753     const bool cond_llb = (!cond || looks_like_bool(cond));
6754     OP *cond_op;
6755
6756     PERL_ARGS_ASSERT_NEWWHENOP;
6757
6758     if (cond_llb)
6759         cond_op = cond;
6760     else {
6761         cond_op = newBINOP(OP_SMARTMATCH, OPf_SPECIAL,
6762                 newDEFSVOP(),
6763                 scalar(ref_array_or_hash(cond)));
6764     }
6765
6766     return newGIVWHENOP(cond_op, block, OP_ENTERWHEN, OP_LEAVEWHEN, 0);
6767 }
6768
6769 void
6770 Perl_cv_ckproto_len_flags(pTHX_ const CV *cv, const GV *gv, const char *p,
6771                     const STRLEN len, const U32 flags)
6772 {
6773     const char * const cvp = SvROK(cv) ? "" : CvPROTO(cv);
6774     const STRLEN clen = CvPROTOLEN(cv);
6775
6776     PERL_ARGS_ASSERT_CV_CKPROTO_LEN_FLAGS;
6777
6778     if (((!p != !cvp) /* One has prototype, one has not.  */
6779         || (p && (
6780                   (flags & SVf_UTF8) == SvUTF8(cv)
6781                    ? len != clen || memNE(cvp, p, len)
6782                    : flags & SVf_UTF8
6783                       ? bytes_cmp_utf8((const U8 *)cvp, clen,
6784                                        (const U8 *)p, len)
6785                       : bytes_cmp_utf8((const U8 *)p, len,
6786                                        (const U8 *)cvp, clen)
6787                  )
6788            )
6789         )
6790          && ckWARN_d(WARN_PROTOTYPE)) {
6791         SV* const msg = sv_newmortal();
6792         SV* name = NULL;
6793
6794         if (gv)
6795         {
6796           if (isGV(gv))
6797             gv_efullname3(name = sv_newmortal(), gv, NULL);
6798           else if (SvPOK(gv) && *SvPVX((SV *)gv) == '&')
6799             name = newSVpvn_flags(SvPVX((SV *)gv)+1, SvCUR(gv)-1,
6800                                   SvUTF8(gv)|SVs_TEMP);
6801           else name = (SV *)gv;
6802         }
6803         sv_setpvs(msg, "Prototype mismatch:");
6804         if (name)
6805             Perl_sv_catpvf(aTHX_ msg, " sub %"SVf, SVfARG(name));
6806         if (cvp)
6807             Perl_sv_catpvf(aTHX_ msg, " (%"SVf")",
6808                 SVfARG(newSVpvn_flags(cvp,clen, SvUTF8(cv)|SVs_TEMP))
6809             );
6810         else
6811             sv_catpvs(msg, ": none");
6812         sv_catpvs(msg, " vs ");
6813         if (p)
6814             Perl_sv_catpvf(aTHX_ msg, "(%"SVf")", SVfARG(newSVpvn_flags(p, len, flags | SVs_TEMP)));
6815         else
6816             sv_catpvs(msg, "none");
6817         Perl_warner(aTHX_ packWARN(WARN_PROTOTYPE), "%"SVf, SVfARG(msg));
6818     }
6819 }
6820
6821 static void const_sv_xsub(pTHX_ CV* cv);
6822
6823 /*
6824
6825 =head1 Optree Manipulation Functions
6826
6827 =for apidoc cv_const_sv
6828
6829 If C<cv> is a constant sub eligible for inlining. returns the constant
6830 value returned by the sub.  Otherwise, returns NULL.
6831
6832 Constant subs can be created with C<newCONSTSUB> or as described in
6833 L<perlsub/"Constant Functions">.
6834
6835 =cut
6836 */
6837 SV *
6838 Perl_cv_const_sv(pTHX_ const CV *const cv)
6839 {
6840     PERL_UNUSED_CONTEXT;
6841     if (!cv)
6842         return NULL;
6843     if (!(SvTYPE(cv) == SVt_PVCV || SvTYPE(cv) == SVt_PVFM))
6844         return NULL;
6845     return CvCONST(cv) ? MUTABLE_SV(CvXSUBANY(cv).any_ptr) : NULL;
6846 }
6847
6848 /* op_const_sv:  examine an optree to determine whether it's in-lineable.
6849  * Can be called in 3 ways:
6850  *
6851  * !cv
6852  *      look for a single OP_CONST with attached value: return the value
6853  *
6854  * cv && CvCLONE(cv) && !CvCONST(cv)
6855  *
6856  *      examine the clone prototype, and if contains only a single
6857  *      OP_CONST referencing a pad const, or a single PADSV referencing
6858  *      an outer lexical, return a non-zero value to indicate the CV is
6859  *      a candidate for "constizing" at clone time
6860  *
6861  * cv && CvCONST(cv)
6862  *
6863  *      We have just cloned an anon prototype that was marked as a const
6864  *      candidate. Try to grab the current value, and in the case of
6865  *      PADSV, ignore it if it has multiple references. In this case we
6866  *      return a newly created *copy* of the value.
6867  */
6868
6869 SV *
6870 Perl_op_const_sv(pTHX_ const OP *o, CV *cv)
6871 {
6872     dVAR;
6873     SV *sv = NULL;
6874
6875     if (PL_madskills)
6876         return NULL;
6877
6878     if (!o)
6879         return NULL;
6880
6881     if (o->op_type == OP_LINESEQ && cLISTOPo->op_first)
6882         o = cLISTOPo->op_first->op_sibling;
6883
6884     for (; o; o = o->op_next) {
6885         const OPCODE type = o->op_type;
6886
6887         if (sv && o->op_next == o)
6888             return sv;
6889         if (o->op_next != o) {
6890             if (type == OP_NEXTSTATE
6891              || (type == OP_NULL && !(o->op_flags & OPf_KIDS))
6892              || type == OP_PUSHMARK)
6893                 continue;
6894             if (type == OP_DBSTATE)
6895                 continue;
6896         }
6897         if (type == OP_LEAVESUB || type == OP_RETURN)
6898             break;
6899         if (sv)
6900             return NULL;
6901         if (type == OP_CONST && cSVOPo->op_sv)
6902             sv = cSVOPo->op_sv;
6903         else if (cv && type == OP_CONST) {
6904             sv = PAD_BASE_SV(CvPADLIST(cv), o->op_targ);
6905             if (!sv)
6906                 return NULL;
6907         }
6908         else if (cv && type == OP_PADSV) {
6909             if (CvCONST(cv)) { /* newly cloned anon */
6910                 sv = PAD_BASE_SV(CvPADLIST(cv), o->op_targ);
6911                 /* the candidate should have 1 ref from this pad and 1 ref
6912                  * from the parent */
6913                 if (!sv || SvREFCNT(sv) != 2)
6914                     return NULL;
6915                 sv = newSVsv(sv);
6916                 SvREADONLY_on(sv);
6917                 return sv;
6918             }
6919             else {
6920                 if (PAD_COMPNAME_FLAGS(o->op_targ) & SVf_FAKE)
6921                     sv = &PL_sv_undef; /* an arbitrary non-null value */
6922             }
6923         }
6924         else {
6925             return NULL;
6926         }
6927     }
6928     return sv;
6929 }
6930
6931 static bool
6932 S_already_defined(pTHX_ CV *const cv, OP * const block, OP * const o,
6933                         PADNAME * const name, SV ** const const_svp)
6934 {
6935     assert (cv);
6936     assert (o || name);
6937     assert (const_svp);
6938     if ((!block
6939 #ifdef PERL_MAD
6940          || block->op_type == OP_NULL
6941 #endif
6942          )) {
6943         if (CvFLAGS(PL_compcv)) {
6944             /* might have had built-in attrs applied */
6945             const bool pureperl = !CvISXSUB(cv) && CvROOT(cv);
6946             if (CvLVALUE(PL_compcv) && ! CvLVALUE(cv) && pureperl
6947              && ckWARN(WARN_MISC))
6948             {
6949                 /* protect against fatal warnings leaking compcv */
6950                 SAVEFREESV(PL_compcv);
6951                 Perl_warner(aTHX_ packWARN(WARN_MISC), "lvalue attribute ignored after the subroutine has been defined");
6952                 SvREFCNT_inc_simple_void_NN(PL_compcv);
6953             }
6954             CvFLAGS(cv) |=
6955                 (CvFLAGS(PL_compcv) & CVf_BUILTIN_ATTRS
6956                   & ~(CVf_LVALUE * pureperl));
6957         }
6958         return FALSE;
6959     }
6960
6961     /* redundant check for speed: */
6962     if (CvCONST(cv) || ckWARN(WARN_REDEFINE)) {
6963         const line_t oldline = CopLINE(PL_curcop);
6964         SV *namesv = o
6965             ? cSVOPo->op_sv
6966             : sv_2mortal(newSVpvn_utf8(
6967                 PadnamePV(name)+1,PadnameLEN(name)-1, PadnameUTF8(name)
6968               ));
6969         if (PL_parser && PL_parser->copline != NOLINE)
6970             /* This ensures that warnings are reported at the first
6971                line of a redefinition, not the last.  */
6972             CopLINE_set(PL_curcop, PL_parser->copline);
6973         /* protect against fatal warnings leaking compcv */
6974         SAVEFREESV(PL_compcv);
6975         report_redefined_cv(namesv, cv, const_svp);
6976         SvREFCNT_inc_simple_void_NN(PL_compcv);
6977         CopLINE_set(PL_curcop, oldline);
6978     }
6979 #ifdef PERL_MAD
6980     if (!PL_minus_c)    /* keep old one around for madskills */
6981 #endif
6982     {
6983         /* (PL_madskills unset in used file.) */
6984         SvREFCNT_dec(cv);
6985     }
6986     return TRUE;
6987 }
6988
6989 CV *
6990 Perl_newMYSUB(pTHX_ I32 floor, OP *o, OP *proto, OP *attrs, OP *block)
6991 {
6992     dVAR;
6993     CV **spot;
6994     SV **svspot;
6995     const char *ps;
6996     STRLEN ps_len = 0; /* init it to avoid false uninit warning from icc */
6997     U32 ps_utf8 = 0;
6998     CV *cv = NULL;
6999     CV *compcv = PL_compcv;
7000     SV *const_sv;
7001     PADNAME *name;
7002     PADOFFSET pax = o->op_targ;
7003     CV *outcv = CvOUTSIDE(PL_compcv);
7004     CV *clonee = NULL;
7005     HEK *hek = NULL;
7006     bool reusable = FALSE;
7007
7008     PERL_ARGS_ASSERT_NEWMYSUB;
7009
7010     /* Find the pad slot for storing the new sub.
7011        We cannot use PL_comppad, as it is the pad owned by the new sub.  We
7012        need to look in CvOUTSIDE and find the pad belonging to the enclos-
7013        ing sub.  And then we need to dig deeper if this is a lexical from
7014        outside, as in:
7015            my sub foo; sub { sub foo { } }
7016      */
7017    redo:
7018     name = PadlistNAMESARRAY(CvPADLIST(outcv))[pax];
7019     if (PadnameOUTER(name) && PARENT_PAD_INDEX(name)) {
7020         pax = PARENT_PAD_INDEX(name);
7021         outcv = CvOUTSIDE(outcv);
7022         assert(outcv);
7023         goto redo;
7024     }
7025     svspot =
7026         &PadARRAY(PadlistARRAY(CvPADLIST(outcv))
7027                         [CvDEPTH(outcv) ? CvDEPTH(outcv) : 1])[pax];
7028     spot = (CV **)svspot;
7029
7030     if (proto) {
7031         assert(proto->op_type == OP_CONST);
7032         ps = SvPV_const(((SVOP*)proto)->op_sv, ps_len);
7033         ps_utf8 = SvUTF8(((SVOP*)proto)->op_sv);
7034     }
7035     else
7036         ps = NULL;
7037
7038     if (!PL_madskills) {
7039         if (proto)
7040             SAVEFREEOP(proto);
7041         if (attrs)
7042             SAVEFREEOP(attrs);
7043     }
7044
7045     if (PL_parser && PL_parser->error_count) {
7046         op_free(block);
7047         SvREFCNT_dec(PL_compcv);
7048         PL_compcv = 0;
7049         goto done;
7050     }
7051
7052     if (CvDEPTH(outcv) && CvCLONE(compcv)) {
7053         cv = *spot;
7054         svspot = (SV **)(spot = &clonee);
7055     }
7056     else if (PadnameIsSTATE(name) || CvDEPTH(outcv))
7057         cv = *spot;
7058     else {
7059         MAGIC *mg;
7060         SvUPGRADE(name, SVt_PVMG);
7061         mg = mg_find(name, PERL_MAGIC_proto);
7062         assert (SvTYPE(*spot) == SVt_PVCV);
7063         if (CvNAMED(*spot))
7064             hek = CvNAME_HEK(*spot);
7065         else {
7066             CvNAME_HEK_set(*spot, hek =
7067                 share_hek(
7068                     PadnamePV(name)+1,
7069                     PadnameLEN(name)-1 * (PadnameUTF8(name) ? -1 : 1), 0
7070                 )
7071             );
7072         }
7073         if (mg) {
7074             assert(mg->mg_obj);
7075             cv = (CV *)mg->mg_obj;
7076         }
7077         else {
7078             sv_magic(name, &PL_sv_undef, PERL_MAGIC_proto, NULL, 0);
7079             mg = mg_find(name, PERL_MAGIC_proto);
7080         }
7081         spot = (CV **)(svspot = &mg->mg_obj);
7082     }
7083
7084     if (!block || !ps || *ps || attrs
7085         || (CvFLAGS(compcv) & CVf_BUILTIN_ATTRS)
7086 #ifdef PERL_MAD
7087         || block->op_type == OP_NULL
7088 #endif
7089         )
7090         const_sv = NULL;
7091     else
7092         const_sv = op_const_sv(block, NULL);
7093
7094     if (cv) {
7095         const bool exists = CvROOT(cv) || CvXSUB(cv);
7096
7097         /* if the subroutine doesn't exist and wasn't pre-declared
7098          * with a prototype, assume it will be AUTOLOADed,
7099          * skipping the prototype check
7100          */
7101         if (exists || SvPOK(cv))
7102             cv_ckproto_len_flags(cv, (GV *)name, ps, ps_len, ps_utf8);
7103         /* already defined? */
7104         if (exists) {
7105             if (S_already_defined(aTHX_ cv, block, NULL, name, &const_sv))
7106                 cv = NULL;
7107             else {
7108                 if (attrs) goto attrs;
7109                 /* just a "sub foo;" when &foo is already defined */
7110                 SAVEFREESV(compcv);
7111                 goto done;
7112             }
7113         }
7114         else if (CvDEPTH(outcv) && CvCLONE(compcv)) {
7115             cv = NULL;
7116             reusable = TRUE;
7117         }
7118     }
7119     if (const_sv) {
7120         SvREFCNT_inc_simple_void_NN(const_sv);
7121         if (cv) {
7122             assert(!CvROOT(cv) && !CvCONST(cv));
7123             cv_forget_slab(cv);
7124         }
7125         else {
7126             cv = MUTABLE_CV(newSV_type(SVt_PVCV));
7127             CvFILE_set_from_cop(cv, PL_curcop);
7128             CvSTASH_set(cv, PL_curstash);
7129             *spot = cv;
7130         }
7131         sv_setpvs(MUTABLE_SV(cv), "");  /* prototype is "" */
7132         CvXSUBANY(cv).any_ptr = const_sv;
7133         CvXSUB(cv) = const_sv_xsub;
7134         CvCONST_on(cv);
7135         CvISXSUB_on(cv);
7136         if (PL_madskills)
7137             goto install_block;
7138         op_free(block);
7139         SvREFCNT_dec(compcv);
7140         PL_compcv = NULL;
7141         goto clone;
7142     }
7143     /* Checking whether outcv is CvOUTSIDE(compcv) is not sufficient to
7144        determine whether this sub definition is in the same scope as its
7145        declaration.  If this sub definition is inside an inner named pack-
7146        age sub (my sub foo; sub bar { sub foo { ... } }), outcv points to
7147        the package sub.  So check PadnameOUTER(name) too.
7148      */
7149     if (outcv == CvOUTSIDE(compcv) && !PadnameOUTER(name)) {
7150         assert(!CvWEAKOUTSIDE(compcv));
7151         SvREFCNT_dec(CvOUTSIDE(compcv));
7152         CvWEAKOUTSIDE_on(compcv);
7153     }
7154     /* XXX else do we have a circular reference? */
7155     if (cv) {   /* must reuse cv in case stub is referenced elsewhere */
7156         /* transfer PL_compcv to cv */
7157         if (block
7158 #ifdef PERL_MAD
7159                   && block->op_type != OP_NULL
7160 #endif
7161         ) {
7162             cv_flags_t preserved_flags =
7163                 CvFLAGS(cv) & (CVf_BUILTIN_ATTRS|CVf_NAMED);
7164             PADLIST *const temp_padl = CvPADLIST(cv);
7165             CV *const temp_cv = CvOUTSIDE(cv);
7166             const cv_flags_t other_flags =
7167                 CvFLAGS(cv) & (CVf_SLABBED|CVf_WEAKOUTSIDE);
7168             OP * const cvstart = CvSTART(cv);
7169
7170             SvPOK_off(cv);
7171             CvFLAGS(cv) =
7172                 CvFLAGS(compcv) | preserved_flags;
7173             CvOUTSIDE(cv) = CvOUTSIDE(compcv);
7174             CvOUTSIDE_SEQ(cv) = CvOUTSIDE_SEQ(compcv);
7175             CvPADLIST(cv) = CvPADLIST(compcv);
7176             CvOUTSIDE(compcv) = temp_cv;
7177             CvPADLIST(compcv) = temp_padl;
7178             CvSTART(cv) = CvSTART(compcv);
7179             CvSTART(compcv) = cvstart;
7180             CvFLAGS(compcv) &= ~(CVf_SLABBED|CVf_WEAKOUTSIDE);
7181             CvFLAGS(compcv) |= other_flags;
7182
7183             if (CvFILE(cv) && CvDYNFILE(cv)) {
7184                 Safefree(CvFILE(cv));
7185             }
7186
7187             /* inner references to compcv must be fixed up ... */
7188             pad_fixup_inner_anons(CvPADLIST(cv), compcv, cv);
7189             if (PERLDB_INTER)/* Advice debugger on the new sub. */
7190               ++PL_sub_generation;
7191         }
7192         else {
7193             /* Might have had built-in attributes applied -- propagate them. */
7194             CvFLAGS(cv) |= (CvFLAGS(compcv) & CVf_BUILTIN_ATTRS);
7195         }
7196         /* ... before we throw it away */
7197         SvREFCNT_dec(compcv);
7198         PL_compcv = compcv = cv;
7199     }
7200     else {
7201         cv = compcv;
7202         *spot = cv;
7203     }
7204     if (!CvNAME_HEK(cv)) {
7205         CvNAME_HEK_set(cv,
7206          hek
7207           ? share_hek_hek(hek)
7208           : share_hek(PadnamePV(name)+1,
7209                       PadnameLEN(name)-1 * (PadnameUTF8(name) ? -1 : 1),
7210                       0)
7211         );
7212     }
7213     CvFILE_set_from_cop(cv, PL_curcop);
7214     CvSTASH_set(cv, PL_curstash);
7215
7216     if (ps) {
7217         sv_setpvn(MUTABLE_SV(cv), ps, ps_len);
7218         if ( ps_utf8 ) SvUTF8_on(MUTABLE_SV(cv));
7219     }
7220
7221  install_block:
7222     if (!block)
7223         goto attrs;
7224
7225     /* If we assign an optree to a PVCV, then we've defined a subroutine that
7226        the debugger could be able to set a breakpoint in, so signal to
7227        pp_entereval that it should not throw away any saved lines at scope
7228        exit.  */
7229
7230     PL_breakable_sub_gen++;
7231     /* This makes sub {}; work as expected.  */
7232     if (block->op_type == OP_STUB) {
7233             OP* const newblock = newSTATEOP(0, NULL, 0);
7234 #ifdef PERL_MAD
7235             op_getmad(block,newblock,'B');
7236 #else
7237             op_free(block);
7238 #endif
7239             block = newblock;
7240     }
7241     CvROOT(cv) = CvLVALUE(cv)
7242                    ? newUNOP(OP_LEAVESUBLV, 0,
7243                              op_lvalue(scalarseq(block), OP_LEAVESUBLV))
7244                    : newUNOP(OP_LEAVESUB, 0, scalarseq(block));
7245     CvROOT(cv)->op_private |= OPpREFCOUNTED;
7246     OpREFCNT_set(CvROOT(cv), 1);
7247     /* The cv no longer needs to hold a refcount on the slab, as CvROOT
7248        itself has a refcount. */
7249     CvSLABBED_off(cv);
7250     OpslabREFCNT_dec_padok((OPSLAB *)CvSTART(cv));
7251     CvSTART(cv) = LINKLIST(CvROOT(cv));
7252     CvROOT(cv)->op_next = 0;
7253     CALL_PEEP(CvSTART(cv));
7254     finalize_optree(CvROOT(cv));
7255
7256     /* now that optimizer has done its work, adjust pad values */
7257
7258     pad_tidy(CvCLONE(cv) ? padtidy_SUBCLONE : padtidy_SUB);
7259
7260     if (CvCLONE(cv)) {
7261         assert(!CvCONST(cv));
7262         if (ps && !*ps && op_const_sv(block, cv))
7263             CvCONST_on(cv);
7264     }
7265
7266   attrs:
7267     if (attrs) {
7268         /* Need to do a C<use attributes $stash_of_cv,\&cv,@attrs>. */
7269         apply_attrs(PL_curstash, MUTABLE_SV(cv), attrs);
7270     }
7271
7272     if (block) {
7273         if (PERLDB_SUBLINE && PL_curstash != PL_debstash) {
7274             SV * const tmpstr = sv_newmortal();
7275             GV * const db_postponed = gv_fetchpvs("DB::postponed",
7276                                                   GV_ADDMULTI, SVt_PVHV);
7277             HV *hv;
7278             SV * const sv = Perl_newSVpvf(aTHX_ "%s:%ld-%ld",
7279                                           CopFILE(PL_curcop),
7280                                           (long)PL_subline,
7281                                           (long)CopLINE(PL_curcop));
7282             if (HvNAME_HEK(PL_curstash)) {
7283                 sv_sethek(tmpstr, HvNAME_HEK(PL_curstash));
7284                 sv_catpvs(tmpstr, "::");
7285             }
7286             else sv_setpvs(tmpstr, "__ANON__::");
7287             sv_catpvn_flags(tmpstr, PadnamePV(name)+1, PadnameLEN(name)-1,
7288                             PadnameUTF8(name) ? SV_CATUTF8 : SV_CATBYTES);
7289             (void)hv_store(GvHV(PL_DBsub), SvPVX_const(tmpstr),
7290                     SvUTF8(tmpstr) ? -(I32)SvCUR(tmpstr) : (I32)SvCUR(tmpstr), sv, 0);
7291             hv = GvHVn(db_postponed);
7292             if (HvTOTALKEYS(hv) > 0 && hv_exists(hv, SvPVX_const(tmpstr), SvUTF8(tmpstr) ? -(I32)SvCUR(tmpstr) : (I32)SvCUR(tmpstr))) {
7293                 CV * const pcv = GvCV(db_postponed);
7294                 if (pcv) {
7295                     dSP;
7296                     PUSHMARK(SP);
7297                     XPUSHs(tmpstr);
7298                     PUTBACK;
7299                     call_sv(MUTABLE_SV(pcv), G_DISCARD);
7300                 }
7301             }
7302         }
7303     }
7304
7305   clone:
7306     if (clonee) {
7307         assert(CvDEPTH(outcv));
7308         spot = (CV **)
7309             &PadARRAY(PadlistARRAY(CvPADLIST(outcv))[CvDEPTH(outcv)])[pax];
7310         if (reusable) cv_clone_into(clonee, *spot);
7311         else *spot = cv_clone(clonee);
7312         SvREFCNT_dec_NN(clonee);
7313         cv = *spot;
7314         SvPADMY_on(cv);
7315     }
7316     if (CvDEPTH(outcv) && !reusable && PadnameIsSTATE(name)) {
7317         PADOFFSET depth = CvDEPTH(outcv);
7318         while (--depth) {
7319             SV *oldcv;
7320             svspot = &PadARRAY(PadlistARRAY(CvPADLIST(outcv))[depth])[pax];
7321             oldcv = *svspot;
7322             *svspot = SvREFCNT_inc_simple_NN(cv);
7323             SvREFCNT_dec(oldcv);
7324         }
7325     }
7326
7327   done:
7328     if (PL_parser)
7329         PL_parser->copline = NOLINE;
7330     LEAVE_SCOPE(floor);
7331     if (o) op_free(o);
7332     return cv;
7333 }
7334
7335 CV *
7336 Perl_newATTRSUB(pTHX_ I32 floor, OP *o, OP *proto, OP *attrs, OP *block)
7337 {
7338     return newATTRSUB_flags(floor, o, proto, attrs, block, 0);
7339 }
7340
7341 CV *
7342 Perl_newATTRSUB_flags(pTHX_ I32 floor, OP *o, OP *proto, OP *attrs,
7343                             OP *block, U32 flags)
7344 {
7345     dVAR;
7346     GV *gv;
7347     const char *ps;
7348     STRLEN ps_len = 0; /* init it to avoid false uninit warning from icc */
7349     U32 ps_utf8 = 0;
7350     CV *cv = NULL;
7351     SV *const_sv;
7352     const bool ec = PL_parser && PL_parser->error_count;
7353     /* If the subroutine has no body, no attributes, and no builtin attributes
7354        then it's just a sub declaration, and we may be able to get away with
7355        storing with a placeholder scalar in the symbol table, rather than a
7356        full GV and CV.  If anything is present then it will take a full CV to
7357        store it.  */
7358     const I32 gv_fetch_flags
7359         = ec ? GV_NOADD_NOINIT :
7360          (block || attrs || (CvFLAGS(PL_compcv) & CVf_BUILTIN_ATTRS)
7361            || PL_madskills)
7362         ? GV_ADDMULTI : GV_ADDMULTI | GV_NOINIT;
7363     STRLEN namlen = 0;
7364     const bool o_is_gv = flags & 1;
7365     const char * const name =
7366          o ? SvPV_const(o_is_gv ? (SV *)o : cSVOPo->op_sv, namlen) : NULL;
7367     bool has_name;
7368     bool name_is_utf8 = o && !o_is_gv && SvUTF8(cSVOPo->op_sv);
7369 #ifdef PERL_DEBUG_READONLY_OPS
7370     OPSLAB *slab = NULL;
7371 #endif
7372
7373     if (proto) {
7374         assert(proto->op_type == OP_CONST);
7375         ps = SvPV_const(((SVOP*)proto)->op_sv, ps_len);
7376         ps_utf8 = SvUTF8(((SVOP*)proto)->op_sv);
7377     }
7378     else
7379         ps = NULL;
7380
7381     if (o_is_gv) {
7382         gv = (GV*)o;
7383         o = NULL;
7384         has_name = TRUE;
7385     } else if (name) {
7386         gv = gv_fetchsv(cSVOPo->op_sv, gv_fetch_flags, SVt_PVCV);
7387         has_name = TRUE;
7388     } else if (PERLDB_NAMEANON && CopLINE(PL_curcop)) {
7389         SV * const sv = sv_newmortal();
7390         Perl_sv_setpvf(aTHX_ sv, "%s[%s:%"IVdf"]",
7391                        PL_curstash ? "__ANON__" : "__ANON__::__ANON__",
7392                        CopFILE(PL_curcop), (IV)CopLINE(PL_curcop));
7393         gv = gv_fetchsv(sv, gv_fetch_flags, SVt_PVCV);
7394         has_name = TRUE;
7395     } else if (PL_curstash) {
7396         gv = gv_fetchpvs("__ANON__", gv_fetch_flags, SVt_PVCV);
7397         has_name = FALSE;
7398     } else {
7399         gv = gv_fetchpvs("__ANON__::__ANON__", gv_fetch_flags, SVt_PVCV);
7400         has_name = FALSE;
7401     }
7402
7403     if (!PL_madskills) {
7404         if (o)
7405             SAVEFREEOP(o);
7406         if (proto)
7407             SAVEFREEOP(proto);
7408         if (attrs)
7409             SAVEFREEOP(attrs);
7410     }
7411
7412     if (ec) {
7413         op_free(block);
7414         if (name) SvREFCNT_dec(PL_compcv);
7415         else cv = PL_compcv;
7416         PL_compcv = 0;
7417         if (name && block) {
7418             const char *s = strrchr(name, ':');
7419             s = s ? s+1 : name;
7420             if (strEQ(s, "BEGIN")) {
7421                 if (PL_in_eval & EVAL_KEEPERR)
7422                     Perl_croak_nocontext("BEGIN not safe after errors--compilation aborted");
7423                 else {
7424                     SV * const errsv = ERRSV;
7425                     /* force display of errors found but not reported */
7426                     sv_catpvs(errsv, "BEGIN not safe after errors--compilation aborted");
7427                     Perl_croak_nocontext("%"SVf, SVfARG(errsv));
7428                 }
7429             }
7430         }
7431         goto done;
7432     }
7433
7434     if (SvTYPE(gv) != SVt_PVGV) {       /* Maybe prototype now, and had at
7435                                            maximum a prototype before. */
7436         if (SvTYPE(gv) > SVt_NULL) {
7437             cv_ckproto_len_flags((const CV *)gv,
7438                                  o ? (const GV *)cSVOPo->op_sv : NULL, ps,
7439                                  ps_len, ps_utf8);
7440         }
7441         if (ps) {
7442             sv_setpvn(MUTABLE_SV(gv), ps, ps_len);
7443             if ( ps_utf8 ) SvUTF8_on(MUTABLE_SV(gv));
7444         }
7445         else
7446             sv_setiv(MUTABLE_SV(gv), -1);
7447
7448         SvREFCNT_dec(PL_compcv);
7449         cv = PL_compcv = NULL;
7450         goto done;
7451     }
7452
7453     cv = (!name || GvCVGEN(gv)) ? NULL : GvCV(gv);
7454
7455     if (!block || !ps || *ps || attrs
7456         || (CvFLAGS(PL_compcv) & CVf_BUILTIN_ATTRS)
7457 #ifdef PERL_MAD
7458         || block->op_type == OP_NULL
7459 #endif
7460         )
7461         const_sv = NULL;
7462     else
7463         const_sv = op_const_sv(block, NULL);
7464
7465     if (cv) {
7466         const bool exists = CvROOT(cv) || CvXSUB(cv);
7467
7468         /* if the subroutine doesn't exist and wasn't pre-declared
7469          * with a prototype, assume it will be AUTOLOADed,
7470          * skipping the prototype check
7471          */
7472         if (exists || SvPOK(cv))
7473             cv_ckproto_len_flags(cv, gv, ps, ps_len, ps_utf8);
7474         /* already defined (or promised)? */
7475         if (exists || GvASSUMECV(gv)) {
7476             if (S_already_defined(aTHX_ cv, block, o, NULL, &const_sv))
7477                 cv = NULL;
7478             else {
7479                 if (attrs) goto attrs;
7480                 /* just a "sub foo;" when &foo is already defined */
7481                 SAVEFREESV(PL_compcv);
7482                 goto done;
7483             }
7484         }
7485     }
7486     if (const_sv) {
7487         SvREFCNT_inc_simple_void_NN(const_sv);
7488         if (cv) {
7489             assert(!CvROOT(cv) && !CvCONST(cv));
7490             cv_forget_slab(cv);
7491             sv_setpvs(MUTABLE_SV(cv), "");  /* prototype is "" */
7492             CvXSUBANY(cv).any_ptr = const_sv;
7493             CvXSUB(cv) = const_sv_xsub;
7494             CvCONST_on(cv);
7495             CvISXSUB_on(cv);
7496         }
7497         else {
7498             GvCV_set(gv, NULL);
7499             cv = newCONSTSUB_flags(
7500                 NULL, name, namlen, name_is_utf8 ? SVf_UTF8 : 0,
7501                 const_sv
7502             );
7503         }
7504         if (PL_madskills)
7505             goto install_block;
7506         op_free(block);
7507         SvREFCNT_dec(PL_compcv);
7508         PL_compcv = NULL;
7509         goto done;
7510     }
7511     if (cv) {                           /* must reuse cv if autoloaded */
7512         /* transfer PL_compcv to cv */
7513         if (block
7514 #ifdef PERL_MAD
7515                   && block->op_type != OP_NULL
7516 #endif
7517         ) {
7518             cv_flags_t existing_builtin_attrs = CvFLAGS(cv) & CVf_BUILTIN_ATTRS;
7519             PADLIST *const temp_av = CvPADLIST(cv);
7520             CV *const temp_cv = CvOUTSIDE(cv);
7521             const cv_flags_t other_flags =
7522                 CvFLAGS(cv) & (CVf_SLABBED|CVf_WEAKOUTSIDE);
7523             OP * const cvstart = CvSTART(cv);
7524
7525             CvGV_set(cv,gv);
7526             assert(!CvCVGV_RC(cv));
7527             assert(CvGV(cv) == gv);
7528
7529             SvPOK_off(cv);
7530             CvFLAGS(cv) = CvFLAGS(PL_compcv) | existing_builtin_attrs;
7531             CvOUTSIDE(cv) = CvOUTSIDE(PL_compcv);
7532             CvOUTSIDE_SEQ(cv) = CvOUTSIDE_SEQ(PL_compcv);
7533             CvPADLIST(cv) = CvPADLIST(PL_compcv);
7534             CvOUTSIDE(PL_compcv) = temp_cv;
7535             CvPADLIST(PL_compcv) = temp_av;
7536             CvSTART(cv) = CvSTART(PL_compcv);
7537             CvSTART(PL_compcv) = cvstart;
7538             CvFLAGS(PL_compcv) &= ~(CVf_SLABBED|CVf_WEAKOUTSIDE);
7539             CvFLAGS(PL_compcv) |= other_flags;
7540
7541             if (CvFILE(cv) && CvDYNFILE(cv)) {
7542                 Safefree(CvFILE(cv));
7543     }
7544             CvFILE_set_from_cop(cv, PL_curcop);
7545             CvSTASH_set(cv, PL_curstash);
7546
7547             /* inner references to PL_compcv must be fixed up ... */
7548             pad_fixup_inner_anons(CvPADLIST(cv), PL_compcv, cv);
7549             if (PERLDB_INTER)/* Advice debugger on the new sub. */
7550               ++PL_sub_generation;
7551         }
7552         else {
7553             /* Might have had built-in attributes applied -- propagate them. */
7554             CvFLAGS(cv) |= (CvFLAGS(PL_compcv) & CVf_BUILTIN_ATTRS);
7555         }
7556         /* ... before we throw it away */
7557         SvREFCNT_dec(PL_compcv);
7558         PL_compcv = cv;
7559     }
7560     else {
7561         cv = PL_compcv;
7562         if (name) {
7563             GvCV_set(gv, cv);
7564             GvCVGEN(gv) = 0;
7565             if (HvENAME_HEK(GvSTASH(gv)))
7566                 /* sub Foo::bar { (shift)+1 } */
7567                 gv_method_changed(gv);
7568         }
7569     }
7570     if (!CvGV(cv)) {
7571         CvGV_set(cv, gv);
7572         CvFILE_set_from_cop(cv, PL_curcop);
7573         CvSTASH_set(cv, PL_curstash);
7574     }
7575
7576     if (ps) {
7577         sv_setpvn(MUTABLE_SV(cv), ps, ps_len);
7578         if ( ps_utf8 ) SvUTF8_on(MUTABLE_SV(cv));
7579     }
7580
7581  install_block:
7582     if (!block)
7583         goto attrs;
7584
7585     /* If we assign an optree to a PVCV, then we've defined a subroutine that
7586        the debugger could be able to set a breakpoint in, so signal to
7587        pp_entereval that it should not throw away any saved lines at scope
7588        exit.  */
7589
7590     PL_breakable_sub_gen++;
7591     /* This makes sub {}; work as expected.  */
7592     if (block->op_type == OP_STUB) {
7593             OP* const newblock = newSTATEOP(0, NULL, 0);
7594 #ifdef PERL_MAD
7595             op_getmad(block,newblock,'B');
7596 #else
7597             op_free(block);
7598 #endif
7599             block = newblock;
7600     }
7601     CvROOT(cv) = CvLVALUE(cv)
7602                    ? newUNOP(OP_LEAVESUBLV, 0,
7603                              op_lvalue(scalarseq(block), OP_LEAVESUBLV))
7604                    : newUNOP(OP_LEAVESUB, 0, scalarseq(block));
7605     CvROOT(cv)->op_private |= OPpREFCOUNTED;
7606     OpREFCNT_set(CvROOT(cv), 1);
7607     /* The cv no longer needs to hold a refcount on the slab, as CvROOT
7608        itself has a refcount. */
7609     CvSLABBED_off(cv);
7610     OpslabREFCNT_dec_padok((OPSLAB *)CvSTART(cv));
7611 #ifdef PERL_DEBUG_READONLY_OPS
7612     slab = (OPSLAB *)CvSTART(cv);
7613 #endif
7614     CvSTART(cv) = LINKLIST(CvROOT(cv));
7615     CvROOT(cv)->op_next = 0;
7616     CALL_PEEP(CvSTART(cv));
7617     finalize_optree(CvROOT(cv));
7618
7619     /* now that optimizer has done its work, adjust pad values */
7620
7621     pad_tidy(CvCLONE(cv) ? padtidy_SUBCLONE : padtidy_SUB);
7622
7623     if (CvCLONE(cv)) {
7624         assert(!CvCONST(cv));
7625         if (ps && !*ps && op_const_sv(block, cv))
7626             CvCONST_on(cv);
7627     }
7628
7629   attrs:
7630     if (attrs) {
7631         /* Need to do a C<use attributes $stash_of_cv,\&cv,@attrs>. */
7632         HV *stash = name && GvSTASH(CvGV(cv)) ? GvSTASH(CvGV(cv)) : PL_curstash;
7633         if (!name) SAVEFREESV(cv);
7634         apply_attrs(stash, MUTABLE_SV(cv), attrs);
7635         if (!name) SvREFCNT_inc_simple_void_NN(cv);
7636     }
7637
7638     if (block && has_name) {
7639         if (PERLDB_SUBLINE && PL_curstash != PL_debstash) {
7640             SV * const tmpstr = sv_newmortal();
7641             GV * const db_postponed = gv_fetchpvs("DB::postponed",
7642                                                   GV_ADDMULTI, SVt_PVHV);
7643             HV *hv;
7644             SV * const sv = Perl_newSVpvf(aTHX_ "%s:%ld-%ld",
7645                                           CopFILE(PL_curcop),
7646                                           (long)PL_subline,
7647                                           (long)CopLINE(PL_curcop));
7648             gv_efullname3(tmpstr, gv, NULL);
7649             (void)hv_store(GvHV(PL_DBsub), SvPVX_const(tmpstr),
7650                     SvUTF8(tmpstr) ? -(I32)SvCUR(tmpstr) : (I32)SvCUR(tmpstr), sv, 0);
7651             hv = GvHVn(db_postponed);
7652             if (HvTOTALKEYS(hv) > 0 && hv_exists(hv, SvPVX_const(tmpstr), SvUTF8(tmpstr) ? -(I32)SvCUR(tmpstr) : (I32)SvCUR(tmpstr))) {
7653                 CV * const pcv = GvCV(db_postponed);
7654                 if (pcv) {
7655                     dSP;
7656                     PUSHMARK(SP);
7657                     XPUSHs(tmpstr);
7658                     PUTBACK;
7659                     call_sv(MUTABLE_SV(pcv), G_DISCARD);
7660                 }
7661             }
7662         }
7663
7664         if (name && ! (PL_parser && PL_parser->error_count))
7665             process_special_blocks(floor, name, gv, cv);
7666     }
7667
7668   done:
7669     if (PL_parser)
7670         PL_parser->copline = NOLINE;
7671     LEAVE_SCOPE(floor);
7672 #ifdef PERL_DEBUG_READONLY_OPS
7673     /* Watch out for BEGIN blocks */
7674     if (slab && gv && isGV(gv) && GvCV(gv)) Slab_to_ro(slab);
7675 #endif
7676     return cv;
7677 }
7678
7679 STATIC void
7680 S_process_special_blocks(pTHX_ I32 floor, const char *const fullname,
7681                          GV *const gv,
7682                          CV *const cv)
7683 {
7684     const char *const colon = strrchr(fullname,':');
7685     const char *const name = colon ? colon + 1 : fullname;
7686
7687     PERL_ARGS_ASSERT_PROCESS_SPECIAL_BLOCKS;
7688
7689     if (*name == 'B') {
7690         if (strEQ(name, "BEGIN")) {
7691             const I32 oldscope = PL_scopestack_ix;
7692             if (floor) LEAVE_SCOPE(floor);
7693             ENTER;
7694             SAVECOPFILE(&PL_compiling);
7695             SAVECOPLINE(&PL_compiling);
7696             SAVEVPTR(PL_curcop);
7697
7698             DEBUG_x( dump_sub(gv) );
7699             Perl_av_create_and_push(aTHX_ &PL_beginav, MUTABLE_SV(cv));
7700             GvCV_set(gv,0);             /* cv has been hijacked */
7701             call_list(oldscope, PL_beginav);
7702
7703             CopHINTS_set(&PL_compiling, PL_hints);
7704             LEAVE;
7705         }
7706         else
7707             return;
7708     } else {
7709         if (*name == 'E') {
7710             if strEQ(name, "END") {
7711                 DEBUG_x( dump_sub(gv) );
7712                 Perl_av_create_and_unshift_one(aTHX_ &PL_endav, MUTABLE_SV(cv));
7713             } else
7714                 return;
7715         } else if (*name == 'U') {
7716             if (strEQ(name, "UNITCHECK")) {
7717                 /* It's never too late to run a unitcheck block */
7718                 Perl_av_create_and_unshift_one(aTHX_ &PL_unitcheckav, MUTABLE_SV(cv));
7719             }
7720             else
7721                 return;
7722         } else if (*name == 'C') {
7723             if (strEQ(name, "CHECK")) {
7724                 if (PL_main_start)
7725                     /* diag_listed_as: Too late to run %s block */
7726                     Perl_ck_warner(aTHX_ packWARN(WARN_VOID),
7727                                    "Too late to run CHECK block");
7728                 Perl_av_create_and_unshift_one(aTHX_ &PL_checkav, MUTABLE_SV(cv));
7729             }
7730             else
7731                 return;
7732         } else if (*name == 'I') {
7733             if (strEQ(name, "INIT")) {
7734                 if (PL_main_start)
7735                     /* diag_listed_as: Too late to run %s block */
7736                     Perl_ck_warner(aTHX_ packWARN(WARN_VOID),
7737                                    "Too late to run INIT block");
7738                 Perl_av_create_and_push(aTHX_ &PL_initav, MUTABLE_SV(cv));
7739             }
7740             else
7741                 return;
7742         } else
7743             return;
7744         DEBUG_x( dump_sub(gv) );
7745         GvCV_set(gv,0);         /* cv has been hijacked */
7746     }
7747 }
7748
7749 /*
7750 =for apidoc newCONSTSUB
7751
7752 See L</newCONSTSUB_flags>.
7753
7754 =cut
7755 */
7756
7757 CV *
7758 Perl_newCONSTSUB(pTHX_ HV *stash, const char *name, SV *sv)
7759 {
7760     return newCONSTSUB_flags(stash, name, name ? strlen(name) : 0, 0, sv);
7761 }
7762
7763 /*
7764 =for apidoc newCONSTSUB_flags
7765
7766 Creates a constant sub equivalent to Perl C<sub FOO () { 123 }> which is
7767 eligible for inlining at compile-time.
7768
7769 Currently, the only useful value for C<flags> is SVf_UTF8.
7770
7771 The newly created subroutine takes ownership of a reference to the passed in
7772 SV.
7773
7774 Passing NULL for SV creates a constant sub equivalent to C<sub BAR () {}>,
7775 which won't be called if used as a destructor, but will suppress the overhead
7776 of a call to C<AUTOLOAD>.  (This form, however, isn't eligible for inlining at
7777 compile time.)
7778
7779 =cut
7780 */
7781
7782 CV *
7783 Perl_newCONSTSUB_flags(pTHX_ HV *stash, const char *name, STRLEN len,
7784                              U32 flags, SV *sv)
7785 {
7786     dVAR;
7787     CV* cv;
7788 #ifdef USE_ITHREADS
7789     const char *const file = CopFILE(PL_curcop);
7790 #else
7791     SV *const temp_sv = CopFILESV(PL_curcop);
7792     const char *const file = temp_sv ? SvPV_nolen_const(temp_sv) : NULL;
7793 #endif
7794
7795     ENTER;
7796
7797     if (IN_PERL_RUNTIME) {
7798         /* at runtime, it's not safe to manipulate PL_curcop: it may be
7799          * an op shared between threads. Use a non-shared COP for our
7800          * dirty work */
7801          SAVEVPTR(PL_curcop);
7802          SAVECOMPILEWARNINGS();
7803          PL_compiling.cop_warnings = DUP_WARNINGS(PL_curcop->cop_warnings);
7804          PL_curcop = &PL_compiling;
7805     }
7806     SAVECOPLINE(PL_curcop);
7807     CopLINE_set(PL_curcop, PL_parser ? PL_parser->copline : NOLINE);
7808
7809     SAVEHINTS();
7810     PL_hints &= ~HINT_BLOCK_SCOPE;
7811
7812     if (stash) {
7813         SAVEGENERICSV(PL_curstash);
7814         PL_curstash = (HV *)SvREFCNT_inc_simple_NN(stash);
7815     }
7816
7817     /* Protect sv against leakage caused by fatal warnings. */
7818     if (sv) SAVEFREESV(sv);
7819
7820     /* file becomes the CvFILE. For an XS, it's usually static storage,
7821        and so doesn't get free()d.  (It's expected to be from the C pre-
7822        processor __FILE__ directive). But we need a dynamically allocated one,
7823        and we need it to get freed.  */
7824     cv = newXS_len_flags(name, len, const_sv_xsub, file ? file : "", "",
7825                          &sv, XS_DYNAMIC_FILENAME | flags);
7826     CvXSUBANY(cv).any_ptr = SvREFCNT_inc_simple(sv);
7827     CvCONST_on(cv);
7828
7829     LEAVE;
7830
7831     return cv;
7832 }
7833
7834 CV *
7835 Perl_newXS_flags(pTHX_ const char *name, XSUBADDR_t subaddr,
7836                  const char *const filename, const char *const proto,
7837                  U32 flags)
7838 {
7839     PERL_ARGS_ASSERT_NEWXS_FLAGS;
7840     return newXS_len_flags(
7841        name, name ? strlen(name) : 0, subaddr, filename, proto, NULL, flags
7842     );
7843 }
7844
7845 CV *
7846 Perl_newXS_len_flags(pTHX_ const char *name, STRLEN len,
7847                            XSUBADDR_t subaddr, const char *const filename,
7848                            const char *const proto, SV **const_svp,
7849                            U32 flags)
7850 {
7851     CV *cv;
7852
7853     PERL_ARGS_ASSERT_NEWXS_LEN_FLAGS;
7854
7855     {
7856         GV * const gv = gv_fetchpvn(
7857                             name ? name : PL_curstash ? "__ANON__" : "__ANON__::__ANON__",
7858                             name ? len : PL_curstash ? sizeof("__ANON__") - 1:
7859                                 sizeof("__ANON__::__ANON__") - 1,
7860                             GV_ADDMULTI | flags, SVt_PVCV);
7861
7862         if (!subaddr)
7863             Perl_croak(aTHX_ "panic: no address for '%s' in '%s'", name, filename);
7864
7865         if ((cv = (name ? GvCV(gv) : NULL))) {
7866             if (GvCVGEN(gv)) {
7867                 /* just a cached method */
7868                 SvREFCNT_dec(cv);
7869                 cv = NULL;
7870             }
7871             else if (CvROOT(cv) || CvXSUB(cv) || GvASSUMECV(gv)) {
7872                 /* already defined (or promised) */
7873                 /* Redundant check that allows us to avoid creating an SV
7874                    most of the time: */
7875                 if (CvCONST(cv) || ckWARN(WARN_REDEFINE)) {
7876                     report_redefined_cv(newSVpvn_flags(
7877                                          name,len,(flags&SVf_UTF8)|SVs_TEMP
7878                                         ),
7879                                         cv, const_svp);
7880                 }
7881                 SvREFCNT_dec_NN(cv);
7882                 cv = NULL;
7883             }
7884         }
7885
7886         if (cv)                         /* must reuse cv if autoloaded */
7887             cv_undef(cv);
7888         else {
7889             cv = MUTABLE_CV(newSV_type(SVt_PVCV));
7890             if (name) {
7891                 GvCV_set(gv,cv);
7892                 GvCVGEN(gv) = 0;
7893                 if (HvENAME_HEK(GvSTASH(gv)))
7894                     gv_method_changed(gv); /* newXS */
7895             }
7896         }
7897         if (!name)
7898             CvANON_on(cv);
7899         CvGV_set(cv, gv);
7900         (void)gv_fetchfile(filename);
7901         CvFILE(cv) = (char *)filename; /* NOTE: not copied, as it is expected to be
7902                                     an external constant string */
7903         assert(!CvDYNFILE(cv)); /* cv_undef should have turned it off */
7904         CvISXSUB_on(cv);
7905         CvXSUB(cv) = subaddr;
7906
7907         if (name)
7908             process_special_blocks(0, name, gv, cv);
7909     }
7910
7911     if (flags & XS_DYNAMIC_FILENAME) {
7912         CvFILE(cv) = savepv(filename);
7913         CvDYNFILE_on(cv);
7914     }
7915     sv_setpv(MUTABLE_SV(cv), proto);
7916     return cv;
7917 }
7918
7919 CV *
7920 Perl_newSTUB(pTHX_ GV *gv, bool fake)
7921 {
7922     CV *cv = MUTABLE_CV(newSV_type(SVt_PVCV));
7923     PERL_ARGS_ASSERT_NEWSTUB;
7924     assert(!GvCVu(gv));
7925     GvCV_set(gv, cv);
7926     GvCVGEN(gv) = 0;
7927     if (!fake && HvENAME_HEK(GvSTASH(gv)))
7928         gv_method_changed(gv);
7929     CvGV_set(cv, gv);
7930     CvFILE_set_from_cop(cv, PL_curcop);
7931     CvSTASH_set(cv, PL_curstash);
7932     GvMULTI_on(gv);
7933     return cv;
7934 }
7935
7936 /*
7937 =for apidoc U||newXS
7938
7939 Used by C<xsubpp> to hook up XSUBs as Perl subs.  I<filename> needs to be
7940 static storage, as it is used directly as CvFILE(), without a copy being made.
7941
7942 =cut
7943 */
7944
7945 CV *
7946 Perl_newXS(pTHX_ const char *name, XSUBADDR_t subaddr, const char *filename)
7947 {
7948     PERL_ARGS_ASSERT_NEWXS;
7949     return newXS_len_flags(
7950         name, name ? strlen(name) : 0, subaddr, filename, NULL, NULL, 0
7951     );
7952 }
7953
7954 #ifdef PERL_MAD
7955 OP *
7956 #else
7957 void
7958 #endif
7959 Perl_newFORM(pTHX_ I32 floor, OP *o, OP *block)
7960 {
7961     dVAR;
7962     CV *cv;
7963 #ifdef PERL_MAD
7964     OP* pegop = newOP(OP_NULL, 0);
7965 #endif
7966
7967     GV *gv;
7968
7969     if (PL_parser && PL_parser->error_count) {
7970         op_free(block);
7971         goto finish;
7972     }
7973
7974     gv = o
7975         ? gv_fetchsv(cSVOPo->op_sv, GV_ADD, SVt_PVFM)
7976         : gv_fetchpvs("STDOUT", GV_ADD|GV_NOTQUAL, SVt_PVFM);
7977
7978     GvMULTI_on(gv);
7979     if ((cv = GvFORM(gv))) {
7980         if (ckWARN(WARN_REDEFINE)) {
7981             const line_t oldline = CopLINE(PL_curcop);
7982             if (PL_parser && PL_parser->copline != NOLINE)
7983                 CopLINE_set(PL_curcop, PL_parser->copline);
7984             if (o) {
7985                 Perl_warner(aTHX_ packWARN(WARN_REDEFINE),
7986                             "Format %"SVf" redefined", SVfARG(cSVOPo->op_sv));
7987             } else {
7988                 /* diag_listed_as: Format %s redefined */
7989                 Perl_warner(aTHX_ packWARN(WARN_REDEFINE),
7990                             "Format STDOUT redefined");
7991             }
7992             CopLINE_set(PL_curcop, oldline);
7993         }
7994         SvREFCNT_dec(cv);
7995     }
7996     cv = PL_compcv;
7997     GvFORM(gv) = (CV *)SvREFCNT_inc_simple_NN(cv);
7998     CvGV_set(cv, gv);
7999     CvFILE_set_from_cop(cv, PL_curcop);
8000
8001
8002     pad_tidy(padtidy_FORMAT);
8003     CvROOT(cv) = newUNOP(OP_LEAVEWRITE, 0, scalarseq(block));
8004     CvROOT(cv)->op_private |= OPpREFCOUNTED;
8005     OpREFCNT_set(CvROOT(cv), 1);
8006     CvSTART(cv) = LINKLIST(CvROOT(cv));
8007     CvROOT(cv)->op_next = 0;
8008     CALL_PEEP(CvSTART(cv));
8009     finalize_optree(CvROOT(cv));
8010     cv_forget_slab(cv);
8011
8012   finish:
8013 #ifdef PERL_MAD
8014     op_getmad(o,pegop,'n');
8015     op_getmad_weak(block, pegop, 'b');
8016 #else
8017     op_free(o);
8018 #endif
8019     if (PL_parser)
8020         PL_parser->copline = NOLINE;
8021     LEAVE_SCOPE(floor);
8022 #ifdef PERL_MAD
8023     return pegop;
8024 #endif
8025 }
8026
8027 OP *
8028 Perl_newANONLIST(pTHX_ OP *o)
8029 {
8030     return convert(OP_ANONLIST, OPf_SPECIAL, o);
8031 }
8032
8033 OP *
8034 Perl_newANONHASH(pTHX_ OP *o)
8035 {
8036     return convert(OP_ANONHASH, OPf_SPECIAL, o);
8037 }
8038
8039 OP *
8040 Perl_newANONSUB(pTHX_ I32 floor, OP *proto, OP *block)
8041 {
8042     return newANONATTRSUB(floor, proto, NULL, block);
8043 }
8044
8045 OP *
8046 Perl_newANONATTRSUB(pTHX_ I32 floor, OP *proto, OP *attrs, OP *block)
8047 {
8048     return newUNOP(OP_REFGEN, 0,
8049         newSVOP(OP_ANONCODE, 0,
8050                 MUTABLE_SV(newATTRSUB(floor, 0, proto, attrs, block))));
8051 }
8052
8053 OP *
8054 Perl_oopsAV(pTHX_ OP *o)
8055 {
8056     dVAR;
8057
8058     PERL_ARGS_ASSERT_OOPSAV;
8059
8060     switch (o->op_type) {
8061     case OP_PADSV:
8062         o->op_type = OP_PADAV;
8063         o->op_ppaddr = PL_ppaddr[OP_PADAV];
8064         return ref(o, OP_RV2AV);
8065
8066     case OP_RV2SV:
8067         o->op_type = OP_RV2AV;
8068         o->op_ppaddr = PL_ppaddr[OP_RV2AV];
8069         ref(o, OP_RV2AV);
8070         break;
8071
8072     default:
8073         Perl_ck_warner_d(aTHX_ packWARN(WARN_INTERNAL), "oops: oopsAV");
8074         break;
8075     }
8076     return o;
8077 }
8078
8079 OP *
8080 Perl_oopsHV(pTHX_ OP *o)
8081 {
8082     dVAR;
8083
8084     PERL_ARGS_ASSERT_OOPSHV;
8085
8086     switch (o->op_type) {
8087     case OP_PADSV:
8088     case OP_PADAV:
8089         o->op_type = OP_PADHV;
8090         o->op_ppaddr = PL_ppaddr[OP_PADHV];
8091         return ref(o, OP_RV2HV);
8092
8093     case OP_RV2SV:
8094     case OP_RV2AV:
8095         o->op_type = OP_RV2HV;
8096         o->op_ppaddr = PL_ppaddr[OP_RV2HV];
8097         ref(o, OP_RV2HV);
8098         break;
8099
8100     default:
8101         Perl_ck_warner_d(aTHX_ packWARN(WARN_INTERNAL), "oops: oopsHV");
8102         break;
8103     }
8104     return o;
8105 }
8106
8107 OP *
8108 Perl_newAVREF(pTHX_ OP *o)
8109 {
8110     dVAR;
8111
8112     PERL_ARGS_ASSERT_NEWAVREF;
8113
8114     if (o->op_type == OP_PADANY) {
8115         o->op_type = OP_PADAV;
8116         o->op_ppaddr = PL_ppaddr[OP_PADAV];
8117         return o;
8118     }
8119     else if ((o->op_type == OP_RV2AV || o->op_type == OP_PADAV)) {
8120         Perl_ck_warner_d(aTHX_ packWARN(WARN_DEPRECATED),
8121                        "Using an array as a reference is deprecated");
8122     }
8123     return newUNOP(OP_RV2AV, 0, scalar(o));
8124 }
8125
8126 OP *
8127 Perl_newGVREF(pTHX_ I32 type, OP *o)
8128 {
8129     if (type == OP_MAPSTART || type == OP_GREPSTART || type == OP_SORT)
8130         return newUNOP(OP_NULL, 0, o);
8131     return ref(newUNOP(OP_RV2GV, OPf_REF, o), type);
8132 }
8133
8134 OP *
8135 Perl_newHVREF(pTHX_ OP *o)
8136 {
8137     dVAR;
8138
8139     PERL_ARGS_ASSERT_NEWHVREF;
8140
8141     if (o->op_type == OP_PADANY) {
8142         o->op_type = OP_PADHV;
8143         o->op_ppaddr = PL_ppaddr[OP_PADHV];
8144         return o;
8145     }
8146     else if ((o->op_type == OP_RV2HV || o->op_type == OP_PADHV)) {
8147         Perl_ck_warner_d(aTHX_ packWARN(WARN_DEPRECATED),
8148                        "Using a hash as a reference is deprecated");
8149     }
8150     return newUNOP(OP_RV2HV, 0, scalar(o));
8151 }
8152
8153 OP *
8154 Perl_newCVREF(pTHX_ I32 flags, OP *o)
8155 {
8156     if (o->op_type == OP_PADANY) {
8157         dVAR;
8158         o->op_type = OP_PADCV;
8159         o->op_ppaddr = PL_ppaddr[OP_PADCV];
8160         return o;
8161     }
8162     return newUNOP(OP_RV2CV, flags, scalar(o));
8163 }
8164
8165 OP *
8166 Perl_newSVREF(pTHX_ OP *o)
8167 {
8168     dVAR;
8169
8170     PERL_ARGS_ASSERT_NEWSVREF;
8171
8172     if (o->op_type == OP_PADANY) {
8173         o->op_type = OP_PADSV;
8174         o->op_ppaddr = PL_ppaddr[OP_PADSV];
8175         return o;
8176     }
8177     return newUNOP(OP_RV2SV, 0, scalar(o));
8178 }
8179
8180 /* Check routines. See the comments at the top of this file for details
8181  * on when these are called */
8182
8183 OP *
8184 Perl_ck_anoncode(pTHX_ OP *o)
8185 {
8186     PERL_ARGS_ASSERT_CK_ANONCODE;
8187
8188     cSVOPo->op_targ = pad_add_anon((CV*)cSVOPo->op_sv, o->op_type);
8189     if (!PL_madskills)
8190         cSVOPo->op_sv = NULL;
8191     return o;
8192 }
8193
8194 OP *
8195 Perl_ck_bitop(pTHX_ OP *o)
8196 {
8197     dVAR;
8198
8199     PERL_ARGS_ASSERT_CK_BITOP;
8200
8201     o->op_private = (U8)(PL_hints & HINT_INTEGER);
8202     if (!(o->op_flags & OPf_STACKED) /* Not an assignment */
8203             && (o->op_type == OP_BIT_OR
8204              || o->op_type == OP_BIT_AND
8205              || o->op_type == OP_BIT_XOR))
8206     {
8207         const OP * const left = cBINOPo->op_first;
8208         const OP * const right = left->op_sibling;
8209         if ((OP_IS_NUMCOMPARE(left->op_type) &&
8210                 (left->op_flags & OPf_PARENS) == 0) ||
8211             (OP_IS_NUMCOMPARE(right->op_type) &&
8212                 (right->op_flags & OPf_PARENS) == 0))
8213             Perl_ck_warner(aTHX_ packWARN(WARN_PRECEDENCE),
8214                            "Possible precedence problem on bitwise %c operator",
8215                            o->op_type == OP_BIT_OR ? '|'
8216                            : o->op_type == OP_BIT_AND ? '&' : '^'
8217                            );
8218     }
8219     return o;
8220 }
8221
8222 PERL_STATIC_INLINE bool
8223 is_dollar_bracket(pTHX_ const OP * const o)
8224 {
8225     const OP *kid;
8226     return o->op_type == OP_RV2SV && o->op_flags & OPf_KIDS
8227         && (kid = cUNOPx(o)->op_first)
8228         && kid->op_type == OP_GV
8229         && strEQ(GvNAME(cGVOPx_gv(kid)), "[");
8230 }
8231
8232 OP *
8233 Perl_ck_cmp(pTHX_ OP *o)
8234 {
8235     PERL_ARGS_ASSERT_CK_CMP;
8236     if (ckWARN(WARN_SYNTAX)) {
8237         const OP *kid = cUNOPo->op_first;
8238         if (kid && (
8239                 (
8240                    is_dollar_bracket(aTHX_ kid)
8241                 && kid->op_sibling && kid->op_sibling->op_type == OP_CONST
8242                 )
8243              || (  kid->op_type == OP_CONST
8244                 && (kid = kid->op_sibling) && is_dollar_bracket(aTHX_ kid))
8245            ))
8246             Perl_warner(aTHX_ packWARN(WARN_SYNTAX),
8247                         "$[ used in %s (did you mean $] ?)", OP_DESC(o));
8248     }
8249     return o;
8250 }
8251
8252 OP *
8253 Perl_ck_concat(pTHX_ OP *o)
8254 {
8255     const OP * const kid = cUNOPo->op_first;
8256
8257     PERL_ARGS_ASSERT_CK_CONCAT;
8258     PERL_UNUSED_CONTEXT;
8259
8260     if (kid->op_type == OP_CONCAT && !(kid->op_private & OPpTARGET_MY) &&
8261             !(kUNOP->op_first->op_flags & OPf_MOD))
8262         o->op_flags |= OPf_STACKED;
8263     return o;
8264 }
8265
8266 OP *
8267 Perl_ck_spair(pTHX_ OP *o)
8268 {
8269     dVAR;
8270
8271     PERL_ARGS_ASSERT_CK_SPAIR;
8272
8273     if (o->op_flags & OPf_KIDS) {
8274         OP* newop;
8275         OP* kid;
8276         const OPCODE type = o->op_type;
8277         o = modkids(ck_fun(o), type);
8278         kid = cUNOPo->op_first;
8279         newop = kUNOP->op_first->op_sibling;
8280         if (newop) {
8281             const OPCODE type = newop->op_type;
8282             if (newop->op_sibling || !(PL_opargs[type] & OA_RETSCALAR) ||
8283                     type == OP_PADAV || type == OP_PADHV ||
8284                     type == OP_RV2AV || type == OP_RV2HV)
8285                 return o;
8286         }
8287 #ifdef PERL_MAD
8288         op_getmad(kUNOP->op_first,newop,'K');
8289 #else
8290         op_free(kUNOP->op_first);
8291 #endif
8292         kUNOP->op_first = newop;
8293     }
8294     /* transforms OP_REFGEN into OP_SREFGEN, OP_CHOP into OP_SCHOP,
8295      * and OP_CHOMP into OP_SCHOMP */
8296     o->op_ppaddr = PL_ppaddr[++o->op_type];
8297     return ck_fun(o);
8298 }
8299
8300 OP *
8301 Perl_ck_delete(pTHX_ OP *o)
8302 {
8303     PERL_ARGS_ASSERT_CK_DELETE;
8304
8305     o = ck_fun(o);
8306     o->op_private = 0;
8307     if (o->op_flags & OPf_KIDS) {
8308         OP * const kid = cUNOPo->op_first;
8309         switch (kid->op_type) {
8310         case OP_ASLICE:
8311             o->op_flags |= OPf_SPECIAL;
8312             /* FALL THROUGH */
8313         case OP_HSLICE:
8314             o->op_private |= OPpSLICE;
8315             break;
8316         case OP_AELEM:
8317             o->op_flags |= OPf_SPECIAL;
8318             /* FALL THROUGH */
8319         case OP_HELEM:
8320             break;
8321         default:
8322             Perl_croak(aTHX_ "%s argument is not a HASH or ARRAY element or slice",
8323                   OP_DESC(o));
8324         }
8325         if (kid->op_private & OPpLVAL_INTRO)
8326             o->op_private |= OPpLVAL_INTRO;
8327         op_null(kid);
8328     }
8329     return o;
8330 }
8331
8332 OP *
8333 Perl_ck_die(pTHX_ OP *o)
8334 {
8335     PERL_ARGS_ASSERT_CK_DIE;
8336
8337 #ifdef VMS
8338     if (VMSISH_HUSHED) o->op_private |= OPpHUSH_VMSISH;
8339 #endif
8340     return ck_fun(o);
8341 }
8342
8343 OP *
8344 Perl_ck_eof(pTHX_ OP *o)
8345 {
8346     dVAR;
8347
8348     PERL_ARGS_ASSERT_CK_EOF;
8349
8350     if (o->op_flags & OPf_KIDS) {
8351         OP *kid;
8352         if (cLISTOPo->op_first->op_type == OP_STUB) {
8353             OP * const newop
8354                 = newUNOP(o->op_type, OPf_SPECIAL, newGVOP(OP_GV, 0, PL_argvgv));
8355 #ifdef PERL_MAD
8356             op_getmad(o,newop,'O');
8357 #else
8358             op_free(o);
8359 #endif
8360             o = newop;
8361         }
8362         o = ck_fun(o);
8363         kid = cLISTOPo->op_first;
8364         if (kid->op_type == OP_RV2GV)
8365             kid->op_private |= OPpALLOW_FAKE;
8366     }
8367     return o;
8368 }
8369
8370 OP *
8371 Perl_ck_eval(pTHX_ OP *o)
8372 {
8373     dVAR;
8374
8375     PERL_ARGS_ASSERT_CK_EVAL;
8376
8377     PL_hints |= HINT_BLOCK_SCOPE;
8378     if (o->op_flags & OPf_KIDS) {
8379         SVOP * const kid = (SVOP*)cUNOPo->op_first;
8380
8381         if (!kid) {
8382             o->op_flags &= ~OPf_KIDS;
8383             op_null(o);
8384         }
8385         else if (kid->op_type == OP_LINESEQ || kid->op_type == OP_STUB) {
8386             LOGOP *enter;
8387 #ifdef PERL_MAD
8388             OP* const oldo = o;
8389 #endif
8390
8391             cUNOPo->op_first = 0;
8392 #ifndef PERL_MAD
8393             op_free(o);
8394 #endif
8395
8396             NewOp(1101, enter, 1, LOGOP);
8397             enter->op_type = OP_ENTERTRY;
8398             enter->op_ppaddr = PL_ppaddr[OP_ENTERTRY];
8399             enter->op_private = 0;
8400
8401             /* establish postfix order */
8402             enter->op_next = (OP*)enter;
8403
8404             o = op_prepend_elem(OP_LINESEQ, (OP*)enter, (OP*)kid);
8405             o->op_type = OP_LEAVETRY;
8406             o->op_ppaddr = PL_ppaddr[OP_LEAVETRY];
8407             enter->op_other = o;
8408             op_getmad(oldo,o,'O');
8409             return o;
8410         }
8411         else {
8412             scalar((OP*)kid);
8413             PL_cv_has_eval = 1;
8414         }
8415     }
8416     else {
8417         const U8 priv = o->op_private;
8418 #ifdef PERL_MAD
8419         OP* const oldo = o;
8420 #else
8421         op_free(o);
8422 #endif
8423         o = newUNOP(OP_ENTEREVAL, priv <<8, newDEFSVOP());
8424         op_getmad(oldo,o,'O');
8425     }
8426     o->op_targ = (PADOFFSET)PL_hints;
8427     if (o->op_private & OPpEVAL_BYTES) o->op_targ &= ~HINT_UTF8;
8428     if ((PL_hints & HINT_LOCALIZE_HH) != 0
8429      && !(o->op_private & OPpEVAL_COPHH) && GvHV(PL_hintgv)) {
8430         /* Store a copy of %^H that pp_entereval can pick up. */
8431         OP *hhop = newSVOP(OP_HINTSEVAL, 0,
8432                            MUTABLE_SV(hv_copy_hints_hv(GvHV(PL_hintgv))));
8433         cUNOPo->op_first->op_sibling = hhop;
8434         o->op_private |= OPpEVAL_HAS_HH;
8435     }
8436     if (!(o->op_private & OPpEVAL_BYTES)
8437          && FEATURE_UNIEVAL_IS_ENABLED)
8438             o->op_private |= OPpEVAL_UNICODE;
8439     return o;
8440 }
8441
8442 OP *
8443 Perl_ck_exit(pTHX_ OP *o)
8444 {
8445     PERL_ARGS_ASSERT_CK_EXIT;
8446
8447 #ifdef VMS
8448     HV * const table = GvHV(PL_hintgv);
8449     if (table) {
8450        SV * const * const svp = hv_fetchs(table, "vmsish_exit", FALSE);
8451        if (svp && *svp && SvTRUE(*svp))
8452            o->op_private |= OPpEXIT_VMSISH;
8453     }
8454     if (VMSISH_HUSHED) o->op_private |= OPpHUSH_VMSISH;
8455 #endif
8456     return ck_fun(o);
8457 }
8458
8459 OP *
8460 Perl_ck_exec(pTHX_ OP *o)
8461 {
8462     PERL_ARGS_ASSERT_CK_EXEC;
8463
8464     if (o->op_flags & OPf_STACKED) {
8465         OP *kid;
8466         o = ck_fun(o);
8467         kid = cUNOPo->op_first->op_sibling;
8468         if (kid->op_type == OP_RV2GV)
8469             op_null(kid);
8470     }
8471     else
8472         o = listkids(o);
8473     return o;
8474 }
8475
8476 OP *
8477 Perl_ck_exists(pTHX_ OP *o)
8478 {
8479     dVAR;
8480
8481     PERL_ARGS_ASSERT_CK_EXISTS;
8482
8483     o = ck_fun(o);
8484     if (o->op_flags & OPf_KIDS) {
8485         OP * const kid = cUNOPo->op_first;
8486         if (kid->op_type == OP_ENTERSUB) {
8487             (void) ref(kid, o->op_type);
8488             if (kid->op_type != OP_RV2CV
8489                         && !(PL_parser && PL_parser->error_count))
8490                 Perl_croak(aTHX_ "%s argument is not a subroutine name",
8491                             OP_DESC(o));
8492             o->op_private |= OPpEXISTS_SUB;
8493         }
8494         else if (kid->op_type == OP_AELEM)
8495             o->op_flags |= OPf_SPECIAL;
8496         else if (kid->op_type != OP_HELEM)
8497             Perl_croak(aTHX_ "%s argument is not a HASH or ARRAY element or a subroutine",
8498                         OP_DESC(o));
8499         op_null(kid);
8500     }
8501     return o;
8502 }
8503
8504 OP *
8505 Perl_ck_rvconst(pTHX_ OP *o)
8506 {
8507     dVAR;
8508     SVOP * const kid = (SVOP*)cUNOPo->op_first;
8509
8510     PERL_ARGS_ASSERT_CK_RVCONST;
8511
8512     o->op_private |= (PL_hints & HINT_STRICT_REFS);
8513     if (o->op_type == OP_RV2CV)
8514         o->op_private &= ~1;
8515
8516     if (kid->op_type == OP_CONST) {
8517         int iscv;
8518         GV *gv;
8519         SV * const kidsv = kid->op_sv;
8520
8521         /* Is it a constant from cv_const_sv()? */
8522         if (SvROK(kidsv) && SvREADONLY(kidsv)) {
8523             SV * const rsv = SvRV(kidsv);
8524             const svtype type = SvTYPE(rsv);
8525             const char *badtype = NULL;
8526
8527             switch (o->op_type) {
8528             case OP_RV2SV:
8529                 if (type > SVt_PVMG)
8530                     badtype = "a SCALAR";
8531                 break;
8532             case OP_RV2AV:
8533                 if (type != SVt_PVAV)
8534                     badtype = "an ARRAY";
8535                 break;
8536             case OP_RV2HV:
8537                 if (type != SVt_PVHV)
8538                     badtype = "a HASH";
8539                 break;
8540             case OP_RV2CV:
8541                 if (type != SVt_PVCV)
8542                     badtype = "a CODE";
8543                 break;
8544             }
8545             if (badtype)
8546                 Perl_croak(aTHX_ "Constant is not %s reference", badtype);
8547             return o;
8548         }
8549         if ((o->op_private & HINT_STRICT_REFS) && (kid->op_private & OPpCONST_BARE)) {
8550             const char *badthing;
8551             switch (o->op_type) {
8552             case OP_RV2SV:
8553                 badthing = "a SCALAR";
8554                 break;
8555             case OP_RV2AV:
8556                 badthing = "an ARRAY";
8557                 break;
8558             case OP_RV2HV:
8559                 badthing = "a HASH";
8560                 break;
8561             default:
8562                 badthing = NULL;
8563                 break;
8564             }
8565             if (badthing)
8566                 Perl_croak(aTHX_
8567                            "Can't use bareword (\"%"SVf"\") as %s ref while \"strict refs\" in use",
8568                            SVfARG(kidsv), badthing);
8569         }
8570         /*
8571          * This is a little tricky.  We only want to add the symbol if we
8572          * didn't add it in the lexer.  Otherwise we get duplicate strict
8573          * warnings.  But if we didn't add it in the lexer, we must at
8574          * least pretend like we wanted to add it even if it existed before,
8575          * or we get possible typo warnings.  OPpCONST_ENTERED says
8576          * whether the lexer already added THIS instance of this symbol.
8577          */
8578         iscv = (o->op_type == OP_RV2CV) * 2;
8579         do {
8580             gv = gv_fetchsv(kidsv,
8581                 iscv | !(kid->op_private & OPpCONST_ENTERED),
8582                 iscv
8583                     ? SVt_PVCV
8584                     : o->op_type == OP_RV2SV
8585                         ? SVt_PV
8586                         : o->op_type == OP_RV2AV
8587                             ? SVt_PVAV
8588                             : o->op_type == OP_RV2HV
8589                                 ? SVt_PVHV
8590                                 : SVt_PVGV);
8591         } while (!gv && !(kid->op_private & OPpCONST_ENTERED) && !iscv++);
8592         if (gv) {
8593             kid->op_type = OP_GV;
8594             SvREFCNT_dec(kid->op_sv);
8595 #ifdef USE_ITHREADS
8596             /* XXX hack: dependence on sizeof(PADOP) <= sizeof(SVOP) */
8597             kPADOP->op_padix = pad_alloc(OP_GV, SVs_PADTMP);
8598             SvREFCNT_dec(PAD_SVl(kPADOP->op_padix));
8599             GvIN_PAD_on(gv);
8600             PAD_SETSV(kPADOP->op_padix, MUTABLE_SV(SvREFCNT_inc_simple_NN(gv)));
8601 #else
8602             kid->op_sv = SvREFCNT_inc_simple_NN(gv);
8603 #endif
8604             kid->op_private = 0;
8605             kid->op_ppaddr = PL_ppaddr[OP_GV];
8606             /* FAKE globs in the symbol table cause weird bugs (#77810) */
8607             SvFAKE_off(gv);
8608         }
8609     }
8610     return o;
8611 }
8612
8613 OP *
8614 Perl_ck_ftst(pTHX_ OP *o)
8615 {
8616     dVAR;
8617     const I32 type = o->op_type;
8618
8619     PERL_ARGS_ASSERT_CK_FTST;
8620
8621     if (o->op_flags & OPf_REF) {
8622         NOOP;
8623     }
8624     else if (o->op_flags & OPf_KIDS && cUNOPo->op_first->op_type != OP_STUB) {
8625         SVOP * const kid = (SVOP*)cUNOPo->op_first;
8626         const OPCODE kidtype = kid->op_type;
8627
8628         if (kidtype == OP_CONST && (kid->op_private & OPpCONST_BARE)
8629          && !(kid->op_private & OPpCONST_FOLDED)) {
8630             OP * const newop = newGVOP(type, OPf_REF,
8631                 gv_fetchsv(kid->op_sv, GV_ADD, SVt_PVIO));
8632 #ifdef PERL_MAD
8633             op_getmad(o,newop,'O');
8634 #else
8635             op_free(o);
8636 #endif
8637             return newop;
8638         }
8639         if ((PL_hints & HINT_FILETEST_ACCESS) && OP_IS_FILETEST_ACCESS(o->op_type))
8640             o->op_private |= OPpFT_ACCESS;
8641         if (PL_check[kidtype] == Perl_ck_ftst
8642                 && kidtype != OP_STAT && kidtype != OP_LSTAT) {
8643             o->op_private |= OPpFT_STACKED;
8644             kid->op_private |= OPpFT_STACKING;
8645             if (kidtype == OP_FTTTY && (
8646                    !(kid->op_private & OPpFT_STACKED)
8647                 || kid->op_private & OPpFT_AFTER_t
8648                ))
8649                 o->op_private |= OPpFT_AFTER_t;
8650         }
8651     }
8652     else {
8653 #ifdef PERL_MAD
8654         OP* const oldo = o;
8655 #else
8656         op_free(o);
8657 #endif
8658         if (type == OP_FTTTY)
8659             o = newGVOP(type, OPf_REF, PL_stdingv);
8660         else
8661             o = newUNOP(type, 0, newDEFSVOP());
8662         op_getmad(oldo,o,'O');
8663     }
8664     return o;
8665 }
8666
8667 OP *
8668 Perl_ck_fun(pTHX_ OP *o)
8669 {
8670     dVAR;
8671     const int type = o->op_type;
8672     I32 oa = PL_opargs[type] >> OASHIFT;
8673
8674     PERL_ARGS_ASSERT_CK_FUN;
8675
8676     if (o->op_flags & OPf_STACKED) {
8677         if ((oa & OA_OPTIONAL) && (oa >> 4) && !((oa >> 4) & OA_OPTIONAL))
8678             oa &= ~OA_OPTIONAL;
8679         else
8680             return no_fh_allowed(o);
8681     }
8682
8683     if (o->op_flags & OPf_KIDS) {
8684         OP **tokid = &cLISTOPo->op_first;
8685         OP *kid = cLISTOPo->op_first;
8686         OP *sibl;
8687         I32 numargs = 0;
8688         bool seen_optional = FALSE;
8689
8690         if (kid->op_type == OP_PUSHMARK ||
8691             (kid->op_type == OP_NULL && kid->op_targ == OP_PUSHMARK))
8692         {
8693             tokid = &kid->op_sibling;
8694             kid = kid->op_sibling;
8695         }
8696         if (kid && kid->op_type == OP_COREARGS) {
8697             bool optional = FALSE;
8698             while (oa) {
8699                 numargs++;
8700                 if (oa & OA_OPTIONAL) optional = TRUE;
8701                 oa = oa >> 4;
8702             }
8703             if (optional) o->op_private |= numargs;
8704             return o;
8705         }
8706
8707         while (oa) {
8708             if (oa & OA_OPTIONAL || (oa & 7) == OA_LIST) {
8709                 if (!kid && !seen_optional && PL_opargs[type] & OA_DEFGV)
8710                     *tokid = kid = newDEFSVOP();
8711                 seen_optional = TRUE;
8712             }
8713             if (!kid) break;
8714
8715             numargs++;
8716             sibl = kid->op_sibling;
8717 #ifdef PERL_MAD
8718             if (!sibl && kid->op_type == OP_STUB) {
8719                 numargs--;
8720                 break;
8721             }
8722 #endif
8723             switch (oa & 7) {
8724             case OA_SCALAR:
8725                 /* list seen where single (scalar) arg expected? */
8726                 if (numargs == 1 && !(oa >> 4)
8727                     && kid->op_type == OP_LIST && type != OP_SCALAR)
8728                 {
8729                     return too_many_arguments_pv(o,PL_op_desc[type], 0);
8730                 }
8731                 scalar(kid);
8732                 break;
8733             case OA_LIST:
8734                 if (oa < 16) {
8735                     kid = 0;
8736                     continue;
8737                 }
8738                 else
8739                     list(kid);
8740                 break;
8741             case OA_AVREF:
8742                 if ((type == OP_PUSH || type == OP_UNSHIFT)
8743                     && !kid->op_sibling)
8744                     Perl_ck_warner(aTHX_ packWARN(WARN_SYNTAX),
8745                                    "Useless use of %s with no values",
8746                                    PL_op_desc[type]);
8747
8748                 if (kid->op_type == OP_CONST &&
8749                     (kid->op_private & OPpCONST_BARE))
8750                 {
8751                     OP * const newop = newAVREF(newGVOP(OP_GV, 0,
8752                         gv_fetchsv(((SVOP*)kid)->op_sv, GV_ADD, SVt_PVAV) ));
8753                     Perl_ck_warner_d(aTHX_ packWARN(WARN_DEPRECATED),
8754                                    "Array @%"SVf" missing the @ in argument %"IVdf" of %s()",
8755                                    SVfARG(((SVOP*)kid)->op_sv), (IV)numargs, PL_op_desc[type]);
8756 #ifdef PERL_MAD
8757                     op_getmad(kid,newop,'K');
8758 #else
8759                     op_free(kid);
8760 #endif
8761                     kid = newop;
8762                     kid->op_sibling = sibl;
8763                     *tokid = kid;
8764                 }
8765                 else if (kid->op_type == OP_CONST
8766                       && (  !SvROK(cSVOPx_sv(kid))
8767                          || SvTYPE(SvRV(cSVOPx_sv(kid))) != SVt_PVAV  )
8768                         )
8769                     bad_type_pv(numargs, "array", PL_op_desc[type], 0, kid);
8770                 /* Defer checks to run-time if we have a scalar arg */
8771                 if (kid->op_type == OP_RV2AV || kid->op_type == OP_PADAV)
8772                     op_lvalue(kid, type);
8773                 else scalar(kid);
8774                 break;
8775             case OA_HVREF:
8776                 if (kid->op_type == OP_CONST &&
8777                     (kid->op_private & OPpCONST_BARE))
8778                 {
8779                     OP * const newop = newHVREF(newGVOP(OP_GV, 0,
8780                         gv_fetchsv(((SVOP*)kid)->op_sv, GV_ADD, SVt_PVHV) ));
8781                     Perl_ck_warner_d(aTHX_ packWARN(WARN_DEPRECATED),
8782                                    "Hash %%%"SVf" missing the %% in argument %"IVdf" of %s()",
8783                                    SVfARG(((SVOP*)kid)->op_sv), (IV)numargs, PL_op_desc[type]);
8784 #ifdef PERL_MAD
8785                     op_getmad(kid,newop,'K');
8786 #else
8787                     op_free(kid);
8788 #endif
8789                     kid = newop;
8790                     kid->op_sibling = sibl;
8791                     *tokid = kid;
8792                 }
8793                 else if (kid->op_type != OP_RV2HV && kid->op_type != OP_PADHV)
8794                     bad_type_pv(numargs, "hash", PL_op_desc[type], 0, kid);
8795                 op_lvalue(kid, type);
8796                 break;
8797             case OA_CVREF:
8798                 {
8799                     OP * const newop = newUNOP(OP_NULL, 0, kid);
8800                     kid->op_sibling = 0;
8801                     newop->op_next = newop;
8802                     kid = newop;
8803                     kid->op_sibling = sibl;
8804                     *tokid = kid;
8805                 }
8806                 break;
8807             case OA_FILEREF:
8808                 if (kid->op_type != OP_GV && kid->op_type != OP_RV2GV) {
8809                     if (kid->op_type == OP_CONST &&
8810                         (kid->op_private & OPpCONST_BARE))
8811                     {
8812                         OP * const newop = newGVOP(OP_GV, 0,
8813                             gv_fetchsv(((SVOP*)kid)->op_sv, GV_ADD, SVt_PVIO));
8814                         if (!(o->op_private & 1) && /* if not unop */
8815                             kid == cLISTOPo->op_last)
8816                             cLISTOPo->op_last = newop;
8817 #ifdef PERL_MAD
8818                         op_getmad(kid,newop,'K');
8819 #else
8820                         op_free(kid);
8821 #endif
8822                         kid = newop;
8823                     }
8824                     else if (kid->op_type == OP_READLINE) {
8825                         /* neophyte patrol: open(<FH>), close(<FH>) etc. */
8826                         bad_type_pv(numargs, "HANDLE", OP_DESC(o), 0, kid);
8827                     }
8828                     else {
8829                         I32 flags = OPf_SPECIAL;
8830                         I32 priv = 0;
8831                         PADOFFSET targ = 0;
8832
8833                         /* is this op a FH constructor? */
8834                         if (is_handle_constructor(o,numargs)) {
8835                             const char *name = NULL;
8836                             STRLEN len = 0;
8837                             U32 name_utf8 = 0;
8838                             bool want_dollar = TRUE;
8839
8840                             flags = 0;
8841                             /* Set a flag to tell rv2gv to vivify
8842                              * need to "prove" flag does not mean something
8843                              * else already - NI-S 1999/05/07
8844                              */
8845                             priv = OPpDEREF;
8846                             if (kid->op_type == OP_PADSV) {
8847                                 SV *const namesv
8848                                     = PAD_COMPNAME_SV(kid->op_targ);
8849                                 name = SvPV_const(namesv, len);
8850                                 name_utf8 = SvUTF8(namesv);
8851                             }
8852                             else if (kid->op_type == OP_RV2SV
8853                                      && kUNOP->op_first->op_type == OP_GV)
8854                             {
8855                                 GV * const gv = cGVOPx_gv(kUNOP->op_first);
8856                                 name = GvNAME(gv);
8857                                 len = GvNAMELEN(gv);
8858                                 name_utf8 = GvNAMEUTF8(gv) ? SVf_UTF8 : 0;
8859                             }
8860                             else if (kid->op_type == OP_AELEM
8861                                      || kid->op_type == OP_HELEM)
8862                             {
8863                                  OP *firstop;
8864                                  OP *op = ((BINOP*)kid)->op_first;
8865                                  name = NULL;
8866                                  if (op) {
8867                                       SV *tmpstr = NULL;
8868                                       const char * const a =
8869                                            kid->op_type == OP_AELEM ?
8870                                            "[]" : "{}";
8871                                       if (((op->op_type == OP_RV2AV) ||
8872                                            (op->op_type == OP_RV2HV)) &&
8873                                           (firstop = ((UNOP*)op)->op_first) &&
8874                                           (firstop->op_type == OP_GV)) {
8875                                            /* packagevar $a[] or $h{} */
8876                                            GV * const gv = cGVOPx_gv(firstop);
8877                                            if (gv)
8878                                                 tmpstr =
8879                                                      Perl_newSVpvf(aTHX_
8880                                                                    "%s%c...%c",
8881                                                                    GvNAME(gv),
8882                                                                    a[0], a[1]);
8883                                       }
8884                                       else if (op->op_type == OP_PADAV
8885                                                || op->op_type == OP_PADHV) {
8886                                            /* lexicalvar $a[] or $h{} */
8887                                            const char * const padname =
8888                                                 PAD_COMPNAME_PV(op->op_targ);
8889                                            if (padname)
8890                                                 tmpstr =
8891                                                      Perl_newSVpvf(aTHX_
8892                                                                    "%s%c...%c",
8893                                                                    padname + 1,
8894                                                                    a[0], a[1]);
8895                                       }
8896                                       if (tmpstr) {
8897                                            name = SvPV_const(tmpstr, len);
8898                                            name_utf8 = SvUTF8(tmpstr);
8899                                            sv_2mortal(tmpstr);
8900                                       }
8901                                  }
8902                                  if (!name) {
8903                                       name = "__ANONIO__";
8904                                       len = 10;
8905                                       want_dollar = FALSE;
8906                                  }
8907                                  op_lvalue(kid, type);
8908                             }
8909                             if (name) {
8910                                 SV *namesv;
8911                                 targ = pad_alloc(OP_RV2GV, SVs_PADTMP);
8912                                 namesv = PAD_SVl(targ);
8913                                 SvUPGRADE(namesv, SVt_PV);
8914                                 if (want_dollar && *name != '$')
8915                                     sv_setpvs(namesv, "$");
8916                                 sv_catpvn(namesv, name, len);
8917                                 if ( name_utf8 ) SvUTF8_on(namesv);
8918                             }
8919                         }
8920                         kid->op_sibling = 0;
8921                         kid = newUNOP(OP_RV2GV, flags, scalar(kid));
8922                         kid->op_targ = targ;
8923                         kid->op_private |= priv;
8924                     }
8925                     kid->op_sibling = sibl;
8926                     *tokid = kid;
8927                 }
8928                 scalar(kid);
8929                 break;
8930             case OA_SCALARREF:
8931                 if ((type == OP_UNDEF || type == OP_POS)
8932                     && numargs == 1 && !(oa >> 4)
8933                     && kid->op_type == OP_LIST)
8934                     return too_many_arguments_pv(o,PL_op_desc[type], 0);
8935                 op_lvalue(scalar(kid), type);
8936                 break;
8937             }
8938             oa >>= 4;
8939             tokid = &kid->op_sibling;
8940             kid = kid->op_sibling;
8941         }
8942 #ifdef PERL_MAD
8943         if (kid && kid->op_type != OP_STUB)
8944             return too_many_arguments_pv(o,OP_DESC(o), 0);
8945         o->op_private |= numargs;
8946 #else
8947         /* FIXME - should the numargs move as for the PERL_MAD case?  */
8948         o->op_private |= numargs;
8949         if (kid)
8950             return too_many_arguments_pv(o,OP_DESC(o), 0);
8951 #endif
8952         listkids(o);
8953     }
8954     else if (PL_opargs[type] & OA_DEFGV) {
8955 #ifdef PERL_MAD
8956         OP *newop = newUNOP(type, 0, newDEFSVOP());
8957         op_getmad(o,newop,'O');
8958         return newop;
8959 #else
8960         /* Ordering of these two is important to keep f_map.t passing.  */
8961         op_free(o);
8962         return newUNOP(type, 0, newDEFSVOP());
8963 #endif
8964     }
8965
8966     if (oa) {
8967         while (oa & OA_OPTIONAL)
8968             oa >>= 4;
8969         if (oa && oa != OA_LIST)
8970             return too_few_arguments_pv(o,OP_DESC(o), 0);
8971     }
8972     return o;
8973 }
8974
8975 OP *
8976 Perl_ck_glob(pTHX_ OP *o)
8977 {
8978     dVAR;
8979     GV *gv;
8980     const bool core = o->op_flags & OPf_SPECIAL;
8981
8982     PERL_ARGS_ASSERT_CK_GLOB;
8983
8984     o = ck_fun(o);
8985     if ((o->op_flags & OPf_KIDS) && !cLISTOPo->op_first->op_sibling)
8986         op_append_elem(OP_GLOB, o, newDEFSVOP()); /* glob() => glob($_) */
8987
8988     if (core) gv = NULL;
8989     else if (!((gv = gv_fetchpvs("glob", GV_NOTQUAL, SVt_PVCV))
8990           && GvCVu(gv) && GvIMPORTED_CV(gv)))
8991     {
8992         GV * const * const gvp =
8993             (GV **)hv_fetchs(PL_globalstash, "glob", FALSE);
8994         gv = gvp ? *gvp : NULL;
8995     }
8996
8997     if (gv && GvCVu(gv) && GvIMPORTED_CV(gv)) {
8998         /* convert
8999          *     glob
9000          *       \ null - const(wildcard)
9001          * into
9002          *     null
9003          *       \ enter
9004          *            \ list
9005          *                 \ mark - glob - rv2cv
9006          *                             |        \ gv(CORE::GLOBAL::glob)
9007          *                             |
9008          *                              \ null - const(wildcard)
9009          */
9010         o->op_flags |= OPf_SPECIAL;
9011         o->op_targ = pad_alloc(OP_GLOB, SVs_PADTMP);
9012         o = newLISTOP(OP_LIST, 0, o, NULL);
9013         o = newUNOP(OP_ENTERSUB, OPf_STACKED,
9014                     op_append_elem(OP_LIST, o,
9015                                 scalar(newUNOP(OP_RV2CV, 0,
9016                                                newGVOP(OP_GV, 0, gv)))));
9017         o = newUNOP(OP_NULL, 0, o);
9018         o->op_targ = OP_GLOB; /* hint at what it used to be: eg in newWHILEOP */
9019         return o;
9020     }
9021     else o->op_flags &= ~OPf_SPECIAL;
9022 #if !defined(PERL_EXTERNAL_GLOB)
9023     if (!PL_globhook) {
9024         ENTER;
9025         Perl_load_module(aTHX_ PERL_LOADMOD_NOIMPORT,
9026                                newSVpvs("File::Glob"), NULL, NULL, NULL);
9027         LEAVE;
9028     }
9029 #endif /* !PERL_EXTERNAL_GLOB */
9030     gv = (GV *)newSV(0);
9031     gv_init(gv, 0, "", 0, 0);
9032     gv_IOadd(gv);
9033     op_append_elem(OP_GLOB, o, newGVOP(OP_GV, 0, gv));
9034     SvREFCNT_dec_NN(gv); /* newGVOP increased it */
9035     scalarkids(o);
9036     return o;
9037 }
9038
9039 OP *
9040 Perl_ck_grep(pTHX_ OP *o)
9041 {
9042     dVAR;
9043     LOGOP *gwop;
9044     OP *kid;
9045     const OPCODE type = o->op_type == OP_GREPSTART ? OP_GREPWHILE : OP_MAPWHILE;
9046     PADOFFSET offset;
9047
9048     PERL_ARGS_ASSERT_CK_GREP;
9049
9050     o->op_ppaddr = PL_ppaddr[OP_GREPSTART];
9051     /* don't allocate gwop here, as we may leak it if PL_parser->error_count > 0 */
9052
9053     if (o->op_flags & OPf_STACKED) {
9054         kid = cUNOPx(cLISTOPo->op_first->op_sibling)->op_first;
9055         if (kid->op_type != OP_SCOPE && kid->op_type != OP_LEAVE)
9056             return no_fh_allowed(o);
9057         o->op_flags &= ~OPf_STACKED;
9058     }
9059     kid = cLISTOPo->op_first->op_sibling;
9060     if (type == OP_MAPWHILE)
9061         list(kid);
9062     else
9063         scalar(kid);
9064     o = ck_fun(o);
9065     if (PL_parser && PL_parser->error_count)
9066         return o;
9067     kid = cLISTOPo->op_first->op_sibling;
9068     if (kid->op_type != OP_NULL)
9069         Perl_croak(aTHX_ "panic: ck_grep, type=%u", (unsigned) kid->op_type);
9070     kid = kUNOP->op_first;
9071
9072     NewOp(1101, gwop, 1, LOGOP);
9073     gwop->op_type = type;
9074     gwop->op_ppaddr = PL_ppaddr[type];
9075     gwop->op_first = o;
9076     gwop->op_flags |= OPf_KIDS;
9077     gwop->op_other = LINKLIST(kid);
9078     kid->op_next = (OP*)gwop;
9079     offset = pad_findmy_pvs("$_", 0);
9080     if (offset == NOT_IN_PAD || PAD_COMPNAME_FLAGS_isOUR(offset)) {
9081         o->op_private = gwop->op_private = 0;
9082         gwop->op_targ = pad_alloc(type, SVs_PADTMP);
9083     }
9084     else {
9085         o->op_private = gwop->op_private = OPpGREP_LEX;
9086         gwop->op_targ = o->op_targ = offset;
9087     }
9088
9089     kid = cLISTOPo->op_first->op_sibling;
9090     for (kid = kid->op_sibling; kid; kid = kid->op_sibling)
9091         op_lvalue(kid, OP_GREPSTART);
9092
9093     return (OP*)gwop;
9094 }
9095
9096 OP *
9097 Perl_ck_index(pTHX_ OP *o)
9098 {
9099     PERL_ARGS_ASSERT_CK_INDEX;
9100
9101     if (o->op_flags & OPf_KIDS) {
9102         OP *kid = cLISTOPo->op_first->op_sibling;       /* get past pushmark */
9103         if (kid)
9104             kid = kid->op_sibling;                      /* get past "big" */
9105         if (kid && kid->op_type == OP_CONST) {
9106             const bool save_taint = TAINT_get; /* accepted unused var warning if NO_TAINT_SUPPORT */
9107             fbm_compile(((SVOP*)kid)->op_sv, 0);
9108             TAINT_set(save_taint);
9109         }
9110     }
9111     return ck_fun(o);
9112 }
9113
9114 OP *
9115 Perl_ck_lfun(pTHX_ OP *o)
9116 {
9117     const OPCODE type = o->op_type;
9118
9119     PERL_ARGS_ASSERT_CK_LFUN;
9120
9121     return modkids(ck_fun(o), type);
9122 }
9123
9124 OP *
9125 Perl_ck_defined(pTHX_ OP *o)            /* 19990527 MJD */
9126 {
9127     PERL_ARGS_ASSERT_CK_DEFINED;
9128
9129     if ((o->op_flags & OPf_KIDS)) {
9130         switch (cUNOPo->op_first->op_type) {
9131         case OP_RV2AV:
9132         case OP_PADAV:
9133         case OP_AASSIGN:                /* Is this a good idea? */
9134             Perl_ck_warner_d(aTHX_ packWARN(WARN_DEPRECATED),
9135                            "defined(@array) is deprecated");
9136             Perl_ck_warner_d(aTHX_ packWARN(WARN_DEPRECATED),
9137                            "\t(Maybe you should just omit the defined()?)\n");
9138         break;
9139         case OP_RV2HV:
9140         case OP_PADHV:
9141             Perl_ck_warner_d(aTHX_ packWARN(WARN_DEPRECATED),
9142                            "defined(%%hash) is deprecated");
9143             Perl_ck_warner_d(aTHX_ packWARN(WARN_DEPRECATED),
9144                            "\t(Maybe you should just omit the defined()?)\n");
9145             break;
9146         default:
9147             /* no warning */
9148             break;
9149         }
9150     }
9151     return ck_rfun(o);
9152 }
9153
9154 OP *
9155 Perl_ck_readline(pTHX_ OP *o)
9156 {
9157     PERL_ARGS_ASSERT_CK_READLINE;
9158
9159     if (o->op_flags & OPf_KIDS) {
9160          OP *kid = cLISTOPo->op_first;
9161          if (kid->op_type == OP_RV2GV) kid->op_private |= OPpALLOW_FAKE;
9162     }
9163     else {
9164         OP * const newop
9165             = newUNOP(OP_READLINE, 0, newGVOP(OP_GV, 0, PL_argvgv));
9166 #ifdef PERL_MAD
9167         op_getmad(o,newop,'O');
9168 #else
9169         op_free(o);
9170 #endif
9171         return newop;
9172     }
9173     return o;
9174 }
9175
9176 OP *
9177 Perl_ck_rfun(pTHX_ OP *o)
9178 {
9179     const OPCODE type = o->op_type;
9180
9181     PERL_ARGS_ASSERT_CK_RFUN;
9182
9183     return refkids(ck_fun(o), type);
9184 }
9185
9186 OP *
9187 Perl_ck_listiob(pTHX_ OP *o)
9188 {
9189     OP *kid;
9190
9191     PERL_ARGS_ASSERT_CK_LISTIOB;
9192
9193     kid = cLISTOPo->op_first;
9194     if (!kid) {
9195         o = force_list(o);
9196         kid = cLISTOPo->op_first;
9197     }
9198     if (kid->op_type == OP_PUSHMARK)
9199         kid = kid->op_sibling;
9200     if (kid && o->op_flags & OPf_STACKED)
9201         kid = kid->op_sibling;
9202     else if (kid && !kid->op_sibling) {         /* print HANDLE; */
9203         if (kid->op_type == OP_CONST && kid->op_private & OPpCONST_BARE
9204          && !(kid->op_private & OPpCONST_FOLDED)) {
9205             o->op_flags |= OPf_STACKED; /* make it a filehandle */
9206             kid = newUNOP(OP_RV2GV, OPf_REF, scalar(kid));
9207             cLISTOPo->op_first->op_sibling = kid;
9208             cLISTOPo->op_last = kid;
9209             kid = kid->op_sibling;
9210         }
9211     }
9212
9213     if (!kid)
9214         op_append_elem(o->op_type, o, newDEFSVOP());
9215
9216     if (o->op_type == OP_PRTF) return modkids(listkids(o), OP_PRTF);
9217     return listkids(o);
9218 }
9219
9220 OP *
9221 Perl_ck_smartmatch(pTHX_ OP *o)
9222 {
9223     dVAR;
9224     PERL_ARGS_ASSERT_CK_SMARTMATCH;
9225     if (0 == (o->op_flags & OPf_SPECIAL)) {
9226         OP *first  = cBINOPo->op_first;
9227         OP *second = first->op_sibling;
9228
9229         /* Implicitly take a reference to an array or hash */
9230         first->op_sibling = NULL;
9231         first = cBINOPo->op_first = ref_array_or_hash(first);
9232         second = first->op_sibling = ref_array_or_hash(second);
9233
9234         /* Implicitly take a reference to a regular expression */
9235         if (first->op_type == OP_MATCH) {
9236             first->op_type = OP_QR;
9237             first->op_ppaddr = PL_ppaddr[OP_QR];
9238         }
9239         if (second->op_type == OP_MATCH) {
9240             second->op_type = OP_QR;
9241             second->op_ppaddr = PL_ppaddr[OP_QR];
9242         }
9243     }
9244
9245     return o;
9246 }
9247
9248
9249 OP *
9250 Perl_ck_sassign(pTHX_ OP *o)
9251 {
9252     dVAR;
9253     OP * const kid = cLISTOPo->op_first;
9254
9255     PERL_ARGS_ASSERT_CK_SASSIGN;
9256
9257     /* has a disposable target? */
9258     if ((PL_opargs[kid->op_type] & OA_TARGLEX)
9259         && !(kid->op_flags & OPf_STACKED)
9260         /* Cannot steal the second time! */
9261         && !(kid->op_private & OPpTARGET_MY)
9262         /* Keep the full thing for madskills */
9263         && !PL_madskills
9264         )
9265     {
9266         OP * const kkid = kid->op_sibling;
9267
9268         /* Can just relocate the target. */
9269         if (kkid && kkid->op_type == OP_PADSV
9270             && !(kkid->op_private & OPpLVAL_INTRO))
9271         {
9272             kid->op_targ = kkid->op_targ;
9273             kkid->op_targ = 0;
9274             /* Now we do not need PADSV and SASSIGN. */
9275             kid->op_sibling = o->op_sibling;    /* NULL */
9276             cLISTOPo->op_first = NULL;
9277             op_free(o);
9278             op_free(kkid);
9279             kid->op_private |= OPpTARGET_MY;    /* Used for context settings */
9280             return kid;
9281         }
9282     }
9283     if (kid->op_sibling) {
9284         OP *kkid = kid->op_sibling;
9285         /* For state variable assignment, kkid is a list op whose op_last
9286            is a padsv. */
9287         if ((kkid->op_type == OP_PADSV ||
9288              (kkid->op_type == OP_LIST &&
9289               (kkid = cLISTOPx(kkid)->op_last)->op_type == OP_PADSV
9290              )
9291             )
9292                 && (kkid->op_private & OPpLVAL_INTRO)
9293                 && SvPAD_STATE(*av_fetch(PL_comppad_name, kkid->op_targ, FALSE))) {
9294             const PADOFFSET target = kkid->op_targ;
9295             OP *const other = newOP(OP_PADSV,
9296                                     kkid->op_flags
9297                                     | ((kkid->op_private & ~OPpLVAL_INTRO) << 8));
9298             OP *const first = newOP(OP_NULL, 0);
9299             OP *const nullop = newCONDOP(0, first, o, other);
9300             OP *const condop = first->op_next;
9301             /* hijacking PADSTALE for uninitialized state variables */
9302             SvPADSTALE_on(PAD_SVl(target));
9303
9304             condop->op_type = OP_ONCE;
9305             condop->op_ppaddr = PL_ppaddr[OP_ONCE];
9306             condop->op_targ = target;
9307             other->op_targ = target;
9308
9309             /* Because we change the type of the op here, we will skip the
9310                assignment binop->op_last = binop->op_first->op_sibling; at the
9311                end of Perl_newBINOP(). So need to do it here. */
9312             cBINOPo->op_last = cBINOPo->op_first->op_sibling;
9313
9314             return nullop;
9315         }
9316     }
9317     return o;
9318 }
9319
9320 OP *
9321 Perl_ck_match(pTHX_ OP *o)
9322 {
9323     dVAR;
9324
9325     PERL_ARGS_ASSERT_CK_MATCH;
9326
9327     if (o->op_type != OP_QR && PL_compcv) {
9328         const PADOFFSET offset = pad_findmy_pvs("$_", 0);
9329         if (offset != NOT_IN_PAD && !(PAD_COMPNAME_FLAGS_isOUR(offset))) {
9330             o->op_targ = offset;
9331             o->op_private |= OPpTARGET_MY;
9332         }
9333     }
9334     if (o->op_type == OP_MATCH || o->op_type == OP_QR)
9335         o->op_private |= OPpRUNTIME;
9336     return o;
9337 }
9338
9339 OP *
9340 Perl_ck_method(pTHX_ OP *o)
9341 {
9342     OP * const kid = cUNOPo->op_first;
9343
9344     PERL_ARGS_ASSERT_CK_METHOD;
9345
9346     if (kid->op_type == OP_CONST) {
9347         SV* sv = kSVOP->op_sv;
9348         const char * const method = SvPVX_const(sv);
9349         if (!(strchr(method, ':') || strchr(method, '\''))) {
9350             OP *cmop;
9351             if (!SvIsCOW(sv)) {
9352                 sv = newSVpvn_share(method, SvUTF8(sv) ? -(I32)SvCUR(sv) : (I32)SvCUR(sv), 0);
9353             }
9354             else {
9355                 kSVOP->op_sv = NULL;
9356             }
9357             cmop = newSVOP(OP_METHOD_NAMED, 0, sv);
9358 #ifdef PERL_MAD
9359             op_getmad(o,cmop,'O');
9360 #else
9361             op_free(o);
9362 #endif
9363             return cmop;
9364         }
9365     }
9366     return o;
9367 }
9368
9369 OP *
9370 Perl_ck_null(pTHX_ OP *o)
9371 {
9372     PERL_ARGS_ASSERT_CK_NULL;
9373     PERL_UNUSED_CONTEXT;
9374     return o;
9375 }
9376
9377 OP *
9378 Perl_ck_open(pTHX_ OP *o)
9379 {
9380     dVAR;
9381     HV * const table = GvHV(PL_hintgv);
9382
9383     PERL_ARGS_ASSERT_CK_OPEN;
9384
9385     if (table) {
9386         SV **svp = hv_fetchs(table, "open_IN", FALSE);
9387         if (svp && *svp) {
9388             STRLEN len = 0;
9389             const char *d = SvPV_const(*svp, len);
9390             const I32 mode = mode_from_discipline(d, len);
9391             if (mode & O_BINARY)
9392                 o->op_private |= OPpOPEN_IN_RAW;
9393             else if (mode & O_TEXT)
9394                 o->op_private |= OPpOPEN_IN_CRLF;
9395         }
9396
9397         svp = hv_fetchs(table, "open_OUT", FALSE);
9398         if (svp && *svp) {
9399             STRLEN len = 0;
9400             const char *d = SvPV_const(*svp, len);
9401             const I32 mode = mode_from_discipline(d, len);
9402             if (mode & O_BINARY)
9403                 o->op_private |= OPpOPEN_OUT_RAW;
9404             else if (mode & O_TEXT)
9405                 o->op_private |= OPpOPEN_OUT_CRLF;
9406         }
9407     }
9408     if (o->op_type == OP_BACKTICK) {
9409         if (!(o->op_flags & OPf_KIDS)) {
9410             OP * const newop = newUNOP(OP_BACKTICK, 0, newDEFSVOP());
9411 #ifdef PERL_MAD
9412             op_getmad(o,newop,'O');
9413 #else
9414             op_free(o);
9415 #endif
9416             return newop;
9417         }
9418         return o;
9419     }
9420     {
9421          /* In case of three-arg dup open remove strictness
9422           * from the last arg if it is a bareword. */
9423          OP * const first = cLISTOPx(o)->op_first; /* The pushmark. */
9424          OP * const last  = cLISTOPx(o)->op_last;  /* The bareword. */
9425          OP *oa;
9426          const char *mode;
9427
9428          if ((last->op_type == OP_CONST) &&             /* The bareword. */
9429              (last->op_private & OPpCONST_BARE) &&
9430              (last->op_private & OPpCONST_STRICT) &&
9431              (oa = first->op_sibling) &&                /* The fh. */
9432              (oa = oa->op_sibling) &&                   /* The mode. */
9433              (oa->op_type == OP_CONST) &&
9434              SvPOK(((SVOP*)oa)->op_sv) &&
9435              (mode = SvPVX_const(((SVOP*)oa)->op_sv)) &&
9436              mode[0] == '>' && mode[1] == '&' &&        /* A dup open. */
9437              (last == oa->op_sibling))                  /* The bareword. */
9438               last->op_private &= ~OPpCONST_STRICT;
9439     }
9440     return ck_fun(o);
9441 }
9442
9443 OP *
9444 Perl_ck_repeat(pTHX_ OP *o)
9445 {
9446     PERL_ARGS_ASSERT_CK_REPEAT;
9447
9448     if (cBINOPo->op_first->op_flags & OPf_PARENS) {
9449         o->op_private |= OPpREPEAT_DOLIST;
9450         cBINOPo->op_first = force_list(cBINOPo->op_first);
9451     }
9452     else
9453         scalar(o);
9454     return o;
9455 }
9456
9457 OP *
9458 Perl_ck_require(pTHX_ OP *o)
9459 {
9460     dVAR;
9461     GV* gv = NULL;
9462
9463     PERL_ARGS_ASSERT_CK_REQUIRE;
9464
9465     if (o->op_flags & OPf_KIDS) {       /* Shall we supply missing .pm? */
9466         SVOP * const kid = (SVOP*)cUNOPo->op_first;
9467
9468         if (kid->op_type == OP_CONST && (kid->op_private & OPpCONST_BARE)) {
9469             SV * const sv = kid->op_sv;
9470             U32 was_readonly = SvREADONLY(sv);
9471             char *s;
9472             STRLEN len;
9473             const char *end;
9474
9475             if (was_readonly) {
9476                     SvREADONLY_off(sv);
9477             }
9478             if (SvIsCOW(sv)) sv_force_normal_flags(sv, 0);
9479
9480             s = SvPVX(sv);
9481             len = SvCUR(sv);
9482             end = s + len;
9483             for (; s < end; s++) {
9484                 if (*s == ':' && s[1] == ':') {
9485                     *s = '/';
9486                     Move(s+2, s+1, end - s - 1, char);
9487                     --end;
9488                 }
9489             }
9490             SvEND_set(sv, end);
9491             sv_catpvs(sv, ".pm");
9492             SvFLAGS(sv) |= was_readonly;
9493         }
9494     }
9495
9496     if (!(o->op_flags & OPf_SPECIAL)) { /* Wasn't written as CORE::require */
9497         /* handle override, if any */
9498         gv = gv_fetchpvs("require", GV_NOTQUAL, SVt_PVCV);
9499         if (!(gv && GvCVu(gv) && GvIMPORTED_CV(gv))) {
9500             GV * const * const gvp = (GV**)hv_fetchs(PL_globalstash, "require", FALSE);
9501             gv = gvp ? *gvp : NULL;
9502         }
9503     }
9504
9505     if (gv && GvCVu(gv) && GvIMPORTED_CV(gv)) {
9506         OP *kid, *newop;
9507         if (o->op_flags & OPf_KIDS) {
9508             kid = cUNOPo->op_first;
9509             cUNOPo->op_first = NULL;
9510         }
9511         else {
9512             kid = newDEFSVOP();
9513         }
9514 #ifndef PERL_MAD
9515         op_free(o);
9516 #endif
9517         newop = newUNOP(OP_ENTERSUB, OPf_STACKED,
9518                                 op_append_elem(OP_LIST, kid,
9519                                             scalar(newUNOP(OP_RV2CV, 0,
9520                                                            newGVOP(OP_GV, 0,
9521                                                                    gv)))));
9522         op_getmad(o,newop,'O');
9523         return newop;
9524     }
9525
9526     return scalar(ck_fun(o));
9527 }
9528
9529 OP *
9530 Perl_ck_return(pTHX_ OP *o)
9531 {
9532     dVAR;
9533     OP *kid;
9534
9535     PERL_ARGS_ASSERT_CK_RETURN;
9536
9537     kid = cLISTOPo->op_first->op_sibling;
9538     if (CvLVALUE(PL_compcv)) {
9539         for (; kid; kid = kid->op_sibling)
9540             op_lvalue(kid, OP_LEAVESUBLV);
9541     }
9542
9543     return o;
9544 }
9545
9546 OP *
9547 Perl_ck_select(pTHX_ OP *o)
9548 {
9549     dVAR;
9550     OP* kid;
9551
9552     PERL_ARGS_ASSERT_CK_SELECT;
9553
9554     if (o->op_flags & OPf_KIDS) {
9555         kid = cLISTOPo->op_first->op_sibling;   /* get past pushmark */
9556         if (kid && kid->op_sibling) {
9557             o->op_type = OP_SSELECT;
9558             o->op_ppaddr = PL_ppaddr[OP_SSELECT];
9559             o = ck_fun(o);
9560             return fold_constants(op_integerize(op_std_init(o)));
9561         }
9562     }
9563     o = ck_fun(o);
9564     kid = cLISTOPo->op_first->op_sibling;    /* get past pushmark */
9565     if (kid && kid->op_type == OP_RV2GV)
9566         kid->op_private &= ~HINT_STRICT_REFS;
9567     return o;
9568 }
9569
9570 OP *
9571 Perl_ck_shift(pTHX_ OP *o)
9572 {
9573     dVAR;
9574     const I32 type = o->op_type;
9575
9576     PERL_ARGS_ASSERT_CK_SHIFT;
9577
9578     if (!(o->op_flags & OPf_KIDS)) {
9579         OP *argop;
9580
9581         if (!CvUNIQUE(PL_compcv)) {
9582             o->op_flags |= OPf_SPECIAL;
9583             return o;
9584         }
9585
9586         argop = newUNOP(OP_RV2AV, 0, scalar(newGVOP(OP_GV, 0, PL_argvgv)));
9587 #ifdef PERL_MAD
9588         {
9589             OP * const oldo = o;
9590             o = newUNOP(type, 0, scalar(argop));
9591             op_getmad(oldo,o,'O');
9592             return o;
9593         }
9594 #else
9595         op_free(o);
9596         return newUNOP(type, 0, scalar(argop));
9597 #endif
9598     }
9599     return scalar(ck_fun(o));
9600 }
9601
9602 OP *
9603 Perl_ck_sort(pTHX_ OP *o)
9604 {
9605     dVAR;
9606     OP *firstkid;
9607     HV * const hinthv = GvHV(PL_hintgv);
9608
9609     PERL_ARGS_ASSERT_CK_SORT;
9610
9611     if (hinthv) {
9612             SV ** const svp = hv_fetchs(hinthv, "sort", FALSE);
9613             if (svp) {
9614                 const I32 sorthints = (I32)SvIV(*svp);
9615                 if ((sorthints & HINT_SORT_QUICKSORT) != 0)
9616                     o->op_private |= OPpSORT_QSORT;
9617                 if ((sorthints & HINT_SORT_STABLE) != 0)
9618                     o->op_private |= OPpSORT_STABLE;
9619             }
9620     }
9621
9622     if (o->op_flags & OPf_STACKED)
9623         simplify_sort(o);
9624     firstkid = cLISTOPo->op_first->op_sibling;          /* get past pushmark */
9625     if (o->op_flags & OPf_STACKED) {                    /* may have been cleared */
9626         OP *kid = cUNOPx(firstkid)->op_first;           /* get past null */
9627
9628         if (kid->op_type == OP_SCOPE || kid->op_type == OP_LEAVE) {
9629             LINKLIST(kid);
9630             if (kid->op_type == OP_LEAVE)
9631                     op_null(kid);                       /* wipe out leave */
9632             /* Prevent execution from escaping out of the sort block. */
9633             kid->op_next = 0;
9634
9635             /* provide scalar context for comparison function/block */
9636             kid = scalar(firstkid);
9637             kid->op_next = kid;
9638             o->op_flags |= OPf_SPECIAL;
9639         }
9640
9641         firstkid = firstkid->op_sibling;
9642     }
9643
9644     /* provide list context for arguments */
9645     list(firstkid);
9646
9647     return o;
9648 }
9649
9650 STATIC void
9651 S_simplify_sort(pTHX_ OP *o)
9652 {
9653     dVAR;
9654     OP *kid = cLISTOPo->op_first->op_sibling;   /* get past pushmark */
9655     OP *k;
9656     int descending;
9657     GV *gv;
9658     const char *gvname;
9659     bool have_scopeop;
9660
9661     PERL_ARGS_ASSERT_SIMPLIFY_SORT;
9662
9663     if (!(o->op_flags & OPf_STACKED))
9664         return;
9665     GvMULTI_on(gv_fetchpvs("a", GV_ADD|GV_NOTQUAL, SVt_PV));
9666     GvMULTI_on(gv_fetchpvs("b", GV_ADD|GV_NOTQUAL, SVt_PV));
9667     kid = kUNOP->op_first;                              /* get past null */
9668     if (!(have_scopeop = kid->op_type == OP_SCOPE)
9669      && kid->op_type != OP_LEAVE)
9670         return;
9671     kid = kLISTOP->op_last;                             /* get past scope */
9672     switch(kid->op_type) {
9673         case OP_NCMP:
9674         case OP_I_NCMP:
9675         case OP_SCMP:
9676             if (!have_scopeop) goto padkids;
9677             break;
9678         default:
9679             return;
9680     }
9681     k = kid;                                            /* remember this node*/
9682     if (kBINOP->op_first->op_type != OP_RV2SV
9683      || kBINOP->op_last ->op_type != OP_RV2SV)
9684     {
9685         /*
9686            Warn about my($a) or my($b) in a sort block, *if* $a or $b is
9687            then used in a comparison.  This catches most, but not
9688            all cases.  For instance, it catches
9689                sort { my($a); $a <=> $b }
9690            but not
9691                sort { my($a); $a < $b ? -1 : $a == $b ? 0 : 1; }
9692            (although why you'd do that is anyone's guess).
9693         */
9694
9695        padkids:
9696         if (!ckWARN(WARN_SYNTAX)) return;
9697         kid = kBINOP->op_first;
9698         do {
9699             if (kid->op_type == OP_PADSV) {
9700                 SV * const name = AvARRAY(PL_comppad_name)[kid->op_targ];
9701                 if (SvCUR(name) == 2 && *SvPVX(name) == '$'
9702                  && (SvPVX(name)[1] == 'a' || SvPVX(name)[1] == 'b'))
9703                     /* diag_listed_as: "my %s" used in sort comparison */
9704                     Perl_warner(aTHX_ packWARN(WARN_SYNTAX),
9705                                      "\"%s %s\" used in sort comparison",
9706                                       SvPAD_STATE(name) ? "state" : "my",
9707                                       SvPVX(name));
9708             }
9709         } while ((kid = kid->op_sibling));
9710         return;
9711     }
9712     kid = kBINOP->op_first;                             /* get past cmp */
9713     if (kUNOP->op_first->op_type != OP_GV)
9714         return;
9715     kid = kUNOP->op_first;                              /* get past rv2sv */
9716     gv = kGVOP_gv;
9717     if (GvSTASH(gv) != PL_curstash)
9718         return;
9719     gvname = GvNAME(gv);
9720     if (*gvname == 'a' && gvname[1] == '\0')
9721         descending = 0;
9722     else if (*gvname == 'b' && gvname[1] == '\0')
9723         descending = 1;
9724     else
9725         return;
9726
9727     kid = k;                                            /* back to cmp */
9728     /* already checked above that it is rv2sv */
9729     kid = kBINOP->op_last;                              /* down to 2nd arg */
9730     if (kUNOP->op_first->op_type != OP_GV)
9731         return;
9732     kid = kUNOP->op_first;                              /* get past rv2sv */
9733     gv = kGVOP_gv;
9734     if (GvSTASH(gv) != PL_curstash)
9735         return;
9736     gvname = GvNAME(gv);
9737     if ( descending
9738          ? !(*gvname == 'a' && gvname[1] == '\0')
9739          : !(*gvname == 'b' && gvname[1] == '\0'))
9740         return;
9741     o->op_flags &= ~(OPf_STACKED | OPf_SPECIAL);
9742     if (descending)
9743         o->op_private |= OPpSORT_DESCEND;
9744     if (k->op_type == OP_NCMP)
9745         o->op_private |= OPpSORT_NUMERIC;
9746     if (k->op_type == OP_I_NCMP)
9747         o->op_private |= OPpSORT_NUMERIC | OPpSORT_INTEGER;
9748     kid = cLISTOPo->op_first->op_sibling;
9749     cLISTOPo->op_first->op_sibling = kid->op_sibling; /* bypass old block */
9750 #ifdef PERL_MAD
9751     op_getmad(kid,o,'S');                             /* then delete it */
9752 #else
9753     op_free(kid);                                     /* then delete it */
9754 #endif
9755 }
9756
9757 OP *
9758 Perl_ck_split(pTHX_ OP *o)
9759 {
9760     dVAR;
9761     OP *kid;
9762
9763     PERL_ARGS_ASSERT_CK_SPLIT;
9764
9765     if (o->op_flags & OPf_STACKED)
9766         return no_fh_allowed(o);
9767
9768     kid = cLISTOPo->op_first;
9769     if (kid->op_type != OP_NULL)
9770         Perl_croak(aTHX_ "panic: ck_split, type=%u", (unsigned) kid->op_type);
9771     kid = kid->op_sibling;
9772     op_free(cLISTOPo->op_first);
9773     if (kid)
9774         cLISTOPo->op_first = kid;
9775     else {
9776         cLISTOPo->op_first = kid = newSVOP(OP_CONST, 0, newSVpvs(" "));
9777         cLISTOPo->op_last = kid; /* There was only one element previously */
9778     }
9779
9780     if (kid->op_type != OP_MATCH || kid->op_flags & OPf_STACKED) {
9781         OP * const sibl = kid->op_sibling;
9782         kid->op_sibling = 0;
9783         kid = pmruntime( newPMOP(OP_MATCH, OPf_SPECIAL), kid, 0, 0); /* OPf_SPECIAL is used to trigger split " " behavior */
9784         if (cLISTOPo->op_first == cLISTOPo->op_last)
9785             cLISTOPo->op_last = kid;
9786         cLISTOPo->op_first = kid;
9787         kid->op_sibling = sibl;
9788     }
9789
9790     kid->op_type = OP_PUSHRE;
9791     kid->op_ppaddr = PL_ppaddr[OP_PUSHRE];
9792     scalar(kid);
9793     if (((PMOP *)kid)->op_pmflags & PMf_GLOBAL) {
9794       Perl_ck_warner(aTHX_ packWARN(WARN_REGEXP),
9795                      "Use of /g modifier is meaningless in split");
9796     }
9797
9798     if (!kid->op_sibling)
9799         op_append_elem(OP_SPLIT, o, newDEFSVOP());
9800
9801     kid = kid->op_sibling;
9802     scalar(kid);
9803
9804     if (!kid->op_sibling)
9805         op_append_elem(OP_SPLIT, o, newSVOP(OP_CONST, 0, newSViv(0)));
9806     assert(kid->op_sibling);
9807
9808     kid = kid->op_sibling;
9809     scalar(kid);
9810
9811     if (kid->op_sibling)
9812         return too_many_arguments_pv(o,OP_DESC(o), 0);
9813
9814     return o;
9815 }
9816
9817 OP *
9818 Perl_ck_join(pTHX_ OP *o)
9819 {
9820     const OP * const kid = cLISTOPo->op_first->op_sibling;
9821
9822     PERL_ARGS_ASSERT_CK_JOIN;
9823
9824     if (kid && kid->op_type == OP_MATCH) {
9825         if (ckWARN(WARN_SYNTAX)) {
9826             const REGEXP *re = PM_GETRE(kPMOP);
9827             const SV *msg = re
9828                     ? newSVpvn_flags( RX_PRECOMP_const(re), RX_PRELEN(re),
9829                                             SVs_TEMP | ( RX_UTF8(re) ? SVf_UTF8 : 0 ) )
9830                     : newSVpvs_flags( "STRING", SVs_TEMP );
9831             Perl_warner(aTHX_ packWARN(WARN_SYNTAX),
9832                         "/%"SVf"/ should probably be written as \"%"SVf"\"",
9833                         SVfARG(msg), SVfARG(msg));
9834         }
9835     }
9836     return ck_fun(o);
9837 }
9838
9839 /*
9840 =for apidoc Am|CV *|rv2cv_op_cv|OP *cvop|U32 flags
9841
9842 Examines an op, which is expected to identify a subroutine at runtime,
9843 and attempts to determine at compile time which subroutine it identifies.
9844 This is normally used during Perl compilation to determine whether
9845 a prototype can be applied to a function call.  I<cvop> is the op
9846 being considered, normally an C<rv2cv> op.  A pointer to the identified
9847 subroutine is returned, if it could be determined statically, and a null
9848 pointer is returned if it was not possible to determine statically.
9849
9850 Currently, the subroutine can be identified statically if the RV that the
9851 C<rv2cv> is to operate on is provided by a suitable C<gv> or C<const> op.
9852 A C<gv> op is suitable if the GV's CV slot is populated.  A C<const> op is
9853 suitable if the constant value must be an RV pointing to a CV.  Details of
9854 this process may change in future versions of Perl.  If the C<rv2cv> op
9855 has the C<OPpENTERSUB_AMPER> flag set then no attempt is made to identify
9856 the subroutine statically: this flag is used to suppress compile-time
9857 magic on a subroutine call, forcing it to use default runtime behaviour.
9858
9859 If I<flags> has the bit C<RV2CVOPCV_MARK_EARLY> set, then the handling
9860 of a GV reference is modified.  If a GV was examined and its CV slot was
9861 found to be empty, then the C<gv> op has the C<OPpEARLY_CV> flag set.
9862 If the op is not optimised away, and the CV slot is later populated with
9863 a subroutine having a prototype, that flag eventually triggers the warning
9864 "called too early to check prototype".
9865
9866 If I<flags> has the bit C<RV2CVOPCV_RETURN_NAME_GV> set, then instead
9867 of returning a pointer to the subroutine it returns a pointer to the
9868 GV giving the most appropriate name for the subroutine in this context.
9869 Normally this is just the C<CvGV> of the subroutine, but for an anonymous
9870 (C<CvANON>) subroutine that is referenced through a GV it will be the
9871 referencing GV.  The resulting C<GV*> is cast to C<CV*> to be returned.
9872 A null pointer is returned as usual if there is no statically-determinable
9873 subroutine.
9874
9875 =cut
9876 */
9877
9878 CV *
9879 Perl_rv2cv_op_cv(pTHX_ OP *cvop, U32 flags)
9880 {
9881     OP *rvop;
9882     CV *cv;
9883     GV *gv;
9884     PERL_ARGS_ASSERT_RV2CV_OP_CV;
9885     if (flags & ~(RV2CVOPCV_MARK_EARLY|RV2CVOPCV_RETURN_NAME_GV))
9886         Perl_croak(aTHX_ "panic: rv2cv_op_cv bad flags %x", (unsigned)flags);
9887     if (cvop->op_type != OP_RV2CV)
9888         return NULL;
9889     if (cvop->op_private & OPpENTERSUB_AMPER)
9890         return NULL;
9891     if (!(cvop->op_flags & OPf_KIDS))
9892         return NULL;
9893     rvop = cUNOPx(cvop)->op_first;
9894     switch (rvop->op_type) {
9895         case OP_GV: {
9896             gv = cGVOPx_gv(rvop);
9897             cv = GvCVu(gv);
9898             if (!cv) {
9899                 if (flags & RV2CVOPCV_MARK_EARLY)
9900                     rvop->op_private |= OPpEARLY_CV;
9901                 return NULL;
9902             }
9903         } break;
9904         case OP_CONST: {
9905             SV *rv = cSVOPx_sv(rvop);
9906             if (!SvROK(rv))
9907                 return NULL;
9908             cv = (CV*)SvRV(rv);
9909             gv = NULL;
9910         } break;
9911         case OP_PADCV: {
9912             PADNAME *name = PAD_COMPNAME(rvop->op_targ);
9913             CV *compcv = PL_compcv;
9914             PADOFFSET off = rvop->op_targ;
9915             while (PadnameOUTER(name)) {
9916                 assert(PARENT_PAD_INDEX(name));
9917                 compcv = CvOUTSIDE(PL_compcv);
9918                 name = PadlistNAMESARRAY(CvPADLIST(compcv))
9919                         [off = PARENT_PAD_INDEX(name)];
9920             }
9921             assert(!PadnameIsOUR(name));
9922             if (!PadnameIsSTATE(name)) {
9923                 MAGIC * mg = mg_find(name, PERL_MAGIC_proto);
9924                 assert(mg);
9925                 assert(mg->mg_obj);
9926                 cv = (CV *)mg->mg_obj;
9927             }
9928             else cv =
9929                     (CV *)AvARRAY(PadlistARRAY(CvPADLIST(compcv))[1])[off];
9930             gv = NULL;
9931         } break;
9932         default: {
9933             return NULL;
9934         } break;
9935     }
9936     if (SvTYPE((SV*)cv) != SVt_PVCV)
9937         return NULL;
9938     if (flags & RV2CVOPCV_RETURN_NAME_GV) {
9939         if (!CvANON(cv) || !gv)
9940             gv = CvGV(cv);
9941         return (CV*)gv;
9942     } else {
9943         return cv;
9944     }
9945 }
9946
9947 /*
9948 =for apidoc Am|OP *|ck_entersub_args_list|OP *entersubop
9949
9950 Performs the default fixup of the arguments part of an C<entersub>
9951 op tree.  This consists of applying list context to each of the
9952 argument ops.  This is the standard treatment used on a call marked
9953 with C<&>, or a method call, or a call through a subroutine reference,
9954 or any other call where the callee can't be identified at compile time,
9955 or a call where the callee has no prototype.
9956
9957 =cut
9958 */
9959
9960 OP *
9961 Perl_ck_entersub_args_list(pTHX_ OP *entersubop)
9962 {
9963     OP *aop;
9964     PERL_ARGS_ASSERT_CK_ENTERSUB_ARGS_LIST;
9965     aop = cUNOPx(entersubop)->op_first;
9966     if (!aop->op_sibling)
9967         aop = cUNOPx(aop)->op_first;
9968     for (aop = aop->op_sibling; aop->op_sibling; aop = aop->op_sibling) {
9969         if (!(PL_madskills && aop->op_type == OP_STUB)) {
9970             list(aop);
9971             op_lvalue(aop, OP_ENTERSUB);
9972         }
9973     }
9974     return entersubop;
9975 }
9976
9977 /*
9978 =for apidoc Am|OP *|ck_entersub_args_proto|OP *entersubop|GV *namegv|SV *protosv
9979
9980 Performs the fixup of the arguments part of an C<entersub> op tree
9981 based on a subroutine prototype.  This makes various modifications to
9982 the argument ops, from applying context up to inserting C<refgen> ops,
9983 and checking the number and syntactic types of arguments, as directed by
9984 the prototype.  This is the standard treatment used on a subroutine call,
9985 not marked with C<&>, where the callee can be identified at compile time
9986 and has a prototype.
9987
9988 I<protosv> supplies the subroutine prototype to be applied to the call.
9989 It may be a normal defined scalar, of which the string value will be used.
9990 Alternatively, for convenience, it may be a subroutine object (a C<CV*>
9991 that has been cast to C<SV*>) which has a prototype.  The prototype
9992 supplied, in whichever form, does not need to match the actual callee
9993 referenced by the op tree.
9994
9995 If the argument ops disagree with the prototype, for example by having
9996 an unacceptable number of arguments, a valid op tree is returned anyway.
9997 The error is reflected in the parser state, normally resulting in a single
9998 exception at the top level of parsing which covers all the compilation
9999 errors that occurred.  In the error message, the callee is referred to
10000 by the name defined by the I<namegv> parameter.
10001
10002 =cut
10003 */
10004
10005 OP *
10006 Perl_ck_entersub_args_proto(pTHX_ OP *entersubop, GV *namegv, SV *protosv)
10007 {
10008     STRLEN proto_len;
10009     const char *proto, *proto_end;
10010     OP *aop, *prev, *cvop;
10011     int optional = 0;
10012     I32 arg = 0;
10013     I32 contextclass = 0;
10014     const char *e = NULL;
10015     PERL_ARGS_ASSERT_CK_ENTERSUB_ARGS_PROTO;
10016     if (SvTYPE(protosv) == SVt_PVCV ? !SvPOK(protosv) : !SvOK(protosv))
10017         Perl_croak(aTHX_ "panic: ck_entersub_args_proto CV with no proto, "
10018                    "flags=%lx", (unsigned long) SvFLAGS(protosv));
10019     if (SvTYPE(protosv) == SVt_PVCV)
10020          proto = CvPROTO(protosv), proto_len = CvPROTOLEN(protosv);
10021     else proto = SvPV(protosv, proto_len);
10022     proto_end = proto + proto_len;
10023     aop = cUNOPx(entersubop)->op_first;
10024     if (!aop->op_sibling)
10025         aop = cUNOPx(aop)->op_first;
10026     prev = aop;
10027     aop = aop->op_sibling;
10028     for (cvop = aop; cvop->op_sibling; cvop = cvop->op_sibling) ;
10029     while (aop != cvop) {
10030         OP* o3;
10031         if (PL_madskills && aop->op_type == OP_STUB) {
10032             aop = aop->op_sibling;
10033             continue;
10034         }
10035         if (PL_madskills && aop->op_type == OP_NULL)
10036             o3 = ((UNOP*)aop)->op_first;
10037         else
10038             o3 = aop;
10039
10040         if (proto >= proto_end)
10041             return too_many_arguments_sv(entersubop, gv_ename(namegv), 0);
10042
10043         switch (*proto) {
10044             case ';':
10045                 optional = 1;
10046                 proto++;
10047                 continue;
10048             case '_':
10049                 /* _ must be at the end */
10050                 if (proto[1] && !strchr(";@%", proto[1]))
10051                     goto oops;
10052             case '$':
10053                 proto++;
10054                 arg++;
10055                 scalar(aop);
10056                 break;
10057             case '%':
10058             case '@':
10059                 list(aop);
10060                 arg++;
10061                 break;
10062             case '&':
10063                 proto++;
10064                 arg++;
10065                 if (o3->op_type != OP_REFGEN && o3->op_type != OP_UNDEF)
10066                     bad_type_sv(arg,
10067                             arg == 1 ? "block or sub {}" : "sub {}",
10068                             gv_ename(namegv), 0, o3);
10069                 break;
10070             case '*':
10071                 /* '*' allows any scalar type, including bareword */
10072                 proto++;
10073                 arg++;
10074                 if (o3->op_type == OP_RV2GV)
10075                     goto wrapref;       /* autoconvert GLOB -> GLOBref */
10076                 else if (o3->op_type == OP_CONST)
10077                     o3->op_private &= ~OPpCONST_STRICT;
10078                 else if (o3->op_type == OP_ENTERSUB) {
10079                     /* accidental subroutine, revert to bareword */
10080                     OP *gvop = ((UNOP*)o3)->op_first;
10081                     if (gvop && gvop->op_type == OP_NULL) {
10082                         gvop = ((UNOP*)gvop)->op_first;
10083                         if (gvop) {
10084                             for (; gvop->op_sibling; gvop = gvop->op_sibling)
10085                                 ;
10086                             if (gvop &&
10087                                     (gvop->op_private & OPpENTERSUB_NOPAREN) &&
10088                                     (gvop = ((UNOP*)gvop)->op_first) &&
10089                                     gvop->op_type == OP_GV)
10090                             {
10091                                 GV * const gv = cGVOPx_gv(gvop);
10092                                 OP * const sibling = aop->op_sibling;
10093                                 SV * const n = newSVpvs("");
10094 #ifdef PERL_MAD
10095                                 OP * const oldaop = aop;
10096 #else
10097                                 op_free(aop);
10098 #endif
10099                                 gv_fullname4(n, gv, "", FALSE);
10100                                 aop = newSVOP(OP_CONST, 0, n);
10101                                 op_getmad(oldaop,aop,'O');
10102                                 prev->op_sibling = aop;
10103                                 aop->op_sibling = sibling;
10104                             }
10105                         }
10106                     }
10107                 }
10108                 scalar(aop);
10109                 break;
10110             case '+':
10111                 proto++;
10112                 arg++;
10113                 if (o3->op_type == OP_RV2AV ||
10114                     o3->op_type == OP_PADAV ||
10115                     o3->op_type == OP_RV2HV ||
10116                     o3->op_type == OP_PADHV
10117                 ) {
10118                     goto wrapref;
10119                 }
10120                 scalar(aop);
10121                 break;
10122             case '[': case ']':
10123                 goto oops;
10124                 break;
10125             case '\\':
10126                 proto++;
10127                 arg++;
10128             again:
10129                 switch (*proto++) {
10130                     case '[':
10131                         if (contextclass++ == 0) {
10132                             e = strchr(proto, ']');
10133                             if (!e || e == proto)
10134                                 goto oops;
10135                         }
10136                         else
10137                             goto oops;
10138                         goto again;
10139                         break;
10140                     case ']':
10141                         if (contextclass) {
10142                             const char *p = proto;
10143                             const char *const end = proto;
10144                             contextclass = 0;
10145                             while (*--p != '[')
10146                                 /* \[$] accepts any scalar lvalue */
10147                                 if (*p == '$'
10148                                  && Perl_op_lvalue_flags(aTHX_
10149                                      scalar(o3),
10150                                      OP_READ, /* not entersub */
10151                                      OP_LVALUE_NO_CROAK
10152                                     )) goto wrapref;
10153                             bad_type_sv(arg, Perl_form(aTHX_ "one of %.*s",
10154                                         (int)(end - p), p),
10155                                     gv_ename(namegv), 0, o3);
10156                         } else
10157                             goto oops;
10158                         break;
10159                     case '*':
10160                         if (o3->op_type == OP_RV2GV)
10161                             goto wrapref;
10162                         if (!contextclass)
10163                             bad_type_sv(arg, "symbol", gv_ename(namegv), 0, o3);
10164                         break;
10165                     case '&':
10166                         if (o3->op_type == OP_ENTERSUB)
10167                             goto wrapref;
10168                         if (!contextclass)
10169                             bad_type_sv(arg, "subroutine entry", gv_ename(namegv), 0,
10170                                     o3);
10171                         break;
10172                     case '$':
10173                         if (o3->op_type == OP_RV2SV ||
10174                                 o3->op_type == OP_PADSV ||
10175                                 o3->op_type == OP_HELEM ||
10176                                 o3->op_type == OP_AELEM)
10177                             goto wrapref;
10178                         if (!contextclass) {
10179                             /* \$ accepts any scalar lvalue */
10180                             if (Perl_op_lvalue_flags(aTHX_
10181                                     scalar(o3),
10182                                     OP_READ,  /* not entersub */
10183                                     OP_LVALUE_NO_CROAK
10184                                )) goto wrapref;
10185                             bad_type_sv(arg, "scalar", gv_ename(namegv), 0, o3);
10186                         }
10187                         break;
10188                     case '@':
10189                         if (o3->op_type == OP_RV2AV ||
10190                                 o3->op_type == OP_PADAV)
10191                             goto wrapref;
10192                         if (!contextclass)
10193                             bad_type_sv(arg, "array", gv_ename(namegv), 0, o3);
10194                         break;
10195                     case '%':
10196                         if (o3->op_type == OP_RV2HV ||
10197                                 o3->op_type == OP_PADHV)
10198                             goto wrapref;
10199                         if (!contextclass)
10200                             bad_type_sv(arg, "hash", gv_ename(namegv), 0, o3);
10201                         break;
10202                     wrapref:
10203                         {
10204                             OP* const kid = aop;
10205                             OP* const sib = kid->op_sibling;
10206                             kid->op_sibling = 0;
10207                             aop = newUNOP(OP_REFGEN, 0, kid);
10208                             aop->op_sibling = sib;
10209                             prev->op_sibling = aop;
10210                         }
10211                         if (contextclass && e) {
10212                             proto = e + 1;
10213                             contextclass = 0;
10214                         }
10215                         break;
10216                     default: goto oops;
10217                 }
10218                 if (contextclass)
10219                     goto again;
10220                 break;
10221             case ' ':
10222                 proto++;
10223                 continue;
10224             default:
10225             oops: {
10226                 SV* const tmpsv = sv_newmortal();
10227                 gv_efullname3(tmpsv, namegv, NULL);
10228                 Perl_croak(aTHX_ "Malformed prototype for %"SVf": %"SVf,
10229                         SVfARG(tmpsv), SVfARG(protosv));
10230             }
10231         }
10232
10233         op_lvalue(aop, OP_ENTERSUB);
10234         prev = aop;
10235         aop = aop->op_sibling;
10236     }
10237     if (aop == cvop && *proto == '_') {
10238         /* generate an access to $_ */
10239         aop = newDEFSVOP();
10240         aop->op_sibling = prev->op_sibling;
10241         prev->op_sibling = aop; /* instead of cvop */
10242     }
10243     if (!optional && proto_end > proto &&
10244         (*proto != '@' && *proto != '%' && *proto != ';' && *proto != '_'))
10245         return too_few_arguments_sv(entersubop, gv_ename(namegv), 0);
10246     return entersubop;
10247 }
10248
10249 /*
10250 =for apidoc Am|OP *|ck_entersub_args_proto_or_list|OP *entersubop|GV *namegv|SV *protosv
10251
10252 Performs the fixup of the arguments part of an C<entersub> op tree either
10253 based on a subroutine prototype or using default list-context processing.
10254 This is the standard treatment used on a subroutine call, not marked
10255 with C<&>, where the callee can be identified at compile time.
10256
10257 I<protosv> supplies the subroutine prototype to be applied to the call,
10258 or indicates that there is no prototype.  It may be a normal scalar,
10259 in which case if it is defined then the string value will be used
10260 as a prototype, and if it is undefined then there is no prototype.
10261 Alternatively, for convenience, it may be a subroutine object (a C<CV*>
10262 that has been cast to C<SV*>), of which the prototype will be used if it
10263 has one.  The prototype (or lack thereof) supplied, in whichever form,
10264 does not need to match the actual callee referenced by the op tree.
10265
10266 If the argument ops disagree with the prototype, for example by having
10267 an unacceptable number of arguments, a valid op tree is returned anyway.
10268 The error is reflected in the parser state, normally resulting in a single
10269 exception at the top level of parsing which covers all the compilation
10270 errors that occurred.  In the error message, the callee is referred to
10271 by the name defined by the I<namegv> parameter.
10272
10273 =cut
10274 */
10275
10276 OP *
10277 Perl_ck_entersub_args_proto_or_list(pTHX_ OP *entersubop,
10278         GV *namegv, SV *protosv)
10279 {
10280     PERL_ARGS_ASSERT_CK_ENTERSUB_ARGS_PROTO_OR_LIST;
10281     if (SvTYPE(protosv) == SVt_PVCV ? SvPOK(protosv) : SvOK(protosv))
10282         return ck_entersub_args_proto(entersubop, namegv, protosv);
10283     else
10284         return ck_entersub_args_list(entersubop);
10285 }
10286
10287 OP *
10288 Perl_ck_entersub_args_core(pTHX_ OP *entersubop, GV *namegv, SV *protosv)
10289 {
10290     int opnum = SvTYPE(protosv) == SVt_PVCV ? 0 : (int)SvUV(protosv);
10291     OP *aop = cUNOPx(entersubop)->op_first;
10292
10293     PERL_ARGS_ASSERT_CK_ENTERSUB_ARGS_CORE;
10294
10295     if (!opnum) {
10296         OP *cvop;
10297         if (!aop->op_sibling)
10298             aop = cUNOPx(aop)->op_first;
10299         aop = aop->op_sibling;
10300         for (cvop = aop; cvop->op_sibling; cvop = cvop->op_sibling) ;
10301         if (PL_madskills) while (aop != cvop && aop->op_type == OP_STUB) {
10302             aop = aop->op_sibling;
10303         }
10304         if (aop != cvop)
10305             (void)too_many_arguments_pv(entersubop, GvNAME(namegv), 0);
10306
10307         op_free(entersubop);
10308         switch(GvNAME(namegv)[2]) {
10309         case 'F': return newSVOP(OP_CONST, 0,
10310                                         newSVpv(CopFILE(PL_curcop),0));
10311         case 'L': return newSVOP(
10312                            OP_CONST, 0,
10313                            Perl_newSVpvf(aTHX_
10314                              "%"IVdf, (IV)CopLINE(PL_curcop)
10315                            )
10316                          );
10317         case 'P': return newSVOP(OP_CONST, 0,
10318                                    (PL_curstash
10319                                      ? newSVhek(HvNAME_HEK(PL_curstash))
10320                                      : &PL_sv_undef
10321                                    )
10322                                 );
10323         }
10324         assert(0);
10325     }
10326     else {
10327         OP *prev, *cvop;
10328         U32 flags;
10329 #ifdef PERL_MAD
10330         bool seenarg = FALSE;
10331 #endif
10332         if (!aop->op_sibling)
10333             aop = cUNOPx(aop)->op_first;
10334
10335         prev = aop;
10336         aop = aop->op_sibling;
10337         prev->op_sibling = NULL;
10338         for (cvop = aop;
10339              cvop->op_sibling;
10340              prev=cvop, cvop = cvop->op_sibling)
10341 #ifdef PERL_MAD
10342             if (PL_madskills && cvop->op_sibling
10343              && cvop->op_type != OP_STUB) seenarg = TRUE
10344 #endif
10345             ;
10346         prev->op_sibling = NULL;
10347         flags = OPf_SPECIAL * !(cvop->op_private & OPpENTERSUB_NOPAREN);
10348         op_free(cvop);
10349         if (aop == cvop) aop = NULL;
10350         op_free(entersubop);
10351
10352         if (opnum == OP_ENTEREVAL
10353          && GvNAMELEN(namegv)==9 && strnEQ(GvNAME(namegv), "evalbytes", 9))
10354             flags |= OPpEVAL_BYTES <<8;
10355
10356         switch (PL_opargs[opnum] & OA_CLASS_MASK) {
10357         case OA_UNOP:
10358         case OA_BASEOP_OR_UNOP:
10359         case OA_FILESTATOP:
10360             return aop ? newUNOP(opnum,flags,aop) : newOP(opnum,flags);
10361         case OA_BASEOP:
10362             if (aop) {
10363 #ifdef PERL_MAD
10364                 if (!PL_madskills || seenarg)
10365 #endif
10366                     (void)too_many_arguments_pv(aop, GvNAME(namegv), 0);
10367                 op_free(aop);
10368             }
10369             return opnum == OP_RUNCV
10370                 ? newPVOP(OP_RUNCV,0,NULL)
10371                 : newOP(opnum,0);
10372         default:
10373             return convert(opnum,0,aop);
10374         }
10375     }
10376     assert(0);
10377     return entersubop;
10378 }
10379
10380 /*
10381 =for apidoc Am|void|cv_get_call_checker|CV *cv|Perl_call_checker *ckfun_p|SV **ckobj_p
10382
10383 Retrieves the function that will be used to fix up a call to I<cv>.
10384 Specifically, the function is applied to an C<entersub> op tree for a
10385 subroutine call, not marked with C<&>, where the callee can be identified
10386 at compile time as I<cv>.
10387
10388 The C-level function pointer is returned in I<*ckfun_p>, and an SV
10389 argument for it is returned in I<*ckobj_p>.  The function is intended
10390 to be called in this manner:
10391
10392     entersubop = (*ckfun_p)(aTHX_ entersubop, namegv, (*ckobj_p));
10393
10394 In this call, I<entersubop> is a pointer to the C<entersub> op,
10395 which may be replaced by the check function, and I<namegv> is a GV
10396 supplying the name that should be used by the check function to refer
10397 to the callee of the C<entersub> op if it needs to emit any diagnostics.
10398 It is permitted to apply the check function in non-standard situations,
10399 such as to a call to a different subroutine or to a method call.
10400
10401 By default, the function is
10402 L<Perl_ck_entersub_args_proto_or_list|/ck_entersub_args_proto_or_list>,
10403 and the SV parameter is I<cv> itself.  This implements standard
10404 prototype processing.  It can be changed, for a particular subroutine,
10405 by L</cv_set_call_checker>.
10406
10407 =cut
10408 */
10409
10410 void
10411 Perl_cv_get_call_checker(pTHX_ CV *cv, Perl_call_checker *ckfun_p, SV **ckobj_p)
10412 {
10413     MAGIC *callmg;
10414     PERL_ARGS_ASSERT_CV_GET_CALL_CHECKER;
10415     callmg = SvMAGICAL((SV*)cv) ? mg_find((SV*)cv, PERL_MAGIC_checkcall) : NULL;
10416     if (callmg) {
10417         *ckfun_p = DPTR2FPTR(Perl_call_checker, callmg->mg_ptr);
10418         *ckobj_p = callmg->mg_obj;
10419     } else {
10420         *ckfun_p = Perl_ck_entersub_args_proto_or_list;
10421         *ckobj_p = (SV*)cv;
10422     }
10423 }
10424
10425 /*
10426 =for apidoc Am|void|cv_set_call_checker|CV *cv|Perl_call_checker ckfun|SV *ckobj
10427
10428 Sets the function that will be used to fix up a call to I<cv>.
10429 Specifically, the function is applied to an C<entersub> op tree for a
10430 subroutine call, not marked with C<&>, where the callee can be identified
10431 at compile time as I<cv>.
10432
10433 The C-level function pointer is supplied in I<ckfun>, and an SV argument
10434 for it is supplied in I<ckobj>.  The function is intended to be called
10435 in this manner:
10436
10437     entersubop = ckfun(aTHX_ entersubop, namegv, ckobj);
10438
10439 In this call, I<entersubop> is a pointer to the C<entersub> op,
10440 which may be replaced by the check function, and I<namegv> is a GV
10441 supplying the name that should be used by the check function to refer
10442 to the callee of the C<entersub> op if it needs to emit any diagnostics.
10443 It is permitted to apply the check function in non-standard situations,
10444 such as to a call to a different subroutine or to a method call.
10445
10446 The current setting for a particular CV can be retrieved by
10447 L</cv_get_call_checker>.
10448
10449 =cut
10450 */
10451
10452 void
10453 Perl_cv_set_call_checker(pTHX_ CV *cv, Perl_call_checker ckfun, SV *ckobj)
10454 {
10455     PERL_ARGS_ASSERT_CV_SET_CALL_CHECKER;
10456     if (ckfun == Perl_ck_entersub_args_proto_or_list && ckobj == (SV*)cv) {
10457         if (SvMAGICAL((SV*)cv))
10458             mg_free_type((SV*)cv, PERL_MAGIC_checkcall);
10459     } else {
10460         MAGIC *callmg;
10461         sv_magic((SV*)cv, &PL_sv_undef, PERL_MAGIC_checkcall, NULL, 0);
10462         callmg = mg_find((SV*)cv, PERL_MAGIC_checkcall);
10463         if (callmg->mg_flags & MGf_REFCOUNTED) {
10464             SvREFCNT_dec(callmg->mg_obj);
10465             callmg->mg_flags &= ~MGf_REFCOUNTED;
10466         }
10467         callmg->mg_ptr = FPTR2DPTR(char *, ckfun);
10468         callmg->mg_obj = ckobj;
10469         if (ckobj != (SV*)cv) {
10470             SvREFCNT_inc_simple_void_NN(ckobj);
10471             callmg->mg_flags |= MGf_REFCOUNTED;
10472         }
10473         callmg->mg_flags |= MGf_COPY;
10474     }
10475 }
10476
10477 OP *
10478 Perl_ck_subr(pTHX_ OP *o)
10479 {
10480     OP *aop, *cvop;
10481     CV *cv;
10482     GV *namegv;
10483
10484     PERL_ARGS_ASSERT_CK_SUBR;
10485
10486     aop = cUNOPx(o)->op_first;
10487     if (!aop->op_sibling)
10488         aop = cUNOPx(aop)->op_first;
10489     aop = aop->op_sibling;
10490     for (cvop = aop; cvop->op_sibling; cvop = cvop->op_sibling) ;
10491     cv = rv2cv_op_cv(cvop, RV2CVOPCV_MARK_EARLY);
10492     namegv = cv ? (GV*)rv2cv_op_cv(cvop, RV2CVOPCV_RETURN_NAME_GV) : NULL;
10493
10494     o->op_private &= ~1;
10495     o->op_private |= OPpENTERSUB_HASTARG;
10496     o->op_private |= (PL_hints & HINT_STRICT_REFS);
10497     if (PERLDB_SUB && PL_curstash != PL_debstash)
10498         o->op_private |= OPpENTERSUB_DB;
10499     if (cvop->op_type == OP_RV2CV) {
10500         o->op_private |= (cvop->op_private & OPpENTERSUB_AMPER);
10501         op_null(cvop);
10502     } else if (cvop->op_type == OP_METHOD || cvop->op_type == OP_METHOD_NAMED) {
10503         if (aop->op_type == OP_CONST)
10504             aop->op_private &= ~OPpCONST_STRICT;
10505         else if (aop->op_type == OP_LIST) {
10506             OP * const sib = ((UNOP*)aop)->op_first->op_sibling;
10507             if (sib && sib->op_type == OP_CONST)
10508                 sib->op_private &= ~OPpCONST_STRICT;
10509         }
10510     }
10511
10512     if (!cv) {
10513         return ck_entersub_args_list(o);
10514     } else {
10515         Perl_call_checker ckfun;
10516         SV *ckobj;
10517         cv_get_call_checker(cv, &ckfun, &ckobj);
10518         if (!namegv) { /* expletive! */
10519             /* XXX The call checker API is public.  And it guarantees that
10520                    a GV will be provided with the right name.  So we have
10521                    to create a GV.  But it is still not correct, as its
10522                    stringification will include the package.  What we
10523                    really need is a new call checker API that accepts a
10524                    GV or string (or GV or CV). */
10525             HEK * const hek = CvNAME_HEK(cv);
10526             assert(hek);
10527             namegv = (GV *)sv_newmortal();
10528             gv_init_pvn(namegv, PL_curstash, HEK_KEY(hek), HEK_LEN(hek),
10529                         SVf_UTF8 * !!HEK_UTF8(hek));
10530         }
10531         return ckfun(aTHX_ o, namegv, ckobj);
10532     }
10533 }
10534
10535 OP *
10536 Perl_ck_svconst(pTHX_ OP *o)
10537 {
10538     PERL_ARGS_ASSERT_CK_SVCONST;
10539     PERL_UNUSED_CONTEXT;
10540     if (!SvIsCOW(cSVOPo->op_sv)) SvREADONLY_on(cSVOPo->op_sv);
10541     return o;
10542 }
10543
10544 OP *
10545 Perl_ck_trunc(pTHX_ OP *o)
10546 {
10547     PERL_ARGS_ASSERT_CK_TRUNC;
10548
10549     if (o->op_flags & OPf_KIDS) {
10550         SVOP *kid = (SVOP*)cUNOPo->op_first;
10551
10552         if (kid->op_type == OP_NULL)
10553             kid = (SVOP*)kid->op_sibling;
10554         if (kid && kid->op_type == OP_CONST &&
10555             (kid->op_private & (OPpCONST_BARE|OPpCONST_FOLDED))
10556                              == OPpCONST_BARE)
10557         {
10558             o->op_flags |= OPf_SPECIAL;
10559             kid->op_private &= ~OPpCONST_STRICT;
10560         }
10561     }
10562     return ck_fun(o);
10563 }
10564
10565 OP *
10566 Perl_ck_substr(pTHX_ OP *o)
10567 {
10568     PERL_ARGS_ASSERT_CK_SUBSTR;
10569
10570     o = ck_fun(o);
10571     if ((o->op_flags & OPf_KIDS) && (o->op_private == 4)) {
10572         OP *kid = cLISTOPo->op_first;
10573
10574         if (kid->op_type == OP_NULL)
10575             kid = kid->op_sibling;
10576         if (kid)
10577             kid->op_flags |= OPf_MOD;
10578
10579     }
10580     return o;
10581 }
10582
10583 OP *
10584 Perl_ck_tell(pTHX_ OP *o)
10585 {
10586     PERL_ARGS_ASSERT_CK_TELL;
10587     o = ck_fun(o);
10588     if (o->op_flags & OPf_KIDS) {
10589      OP *kid = cLISTOPo->op_first;
10590      if (kid->op_type == OP_NULL && kid->op_sibling) kid = kid->op_sibling;
10591      if (kid->op_type == OP_RV2GV) kid->op_private |= OPpALLOW_FAKE;
10592     }
10593     return o;
10594 }
10595
10596 OP *
10597 Perl_ck_each(pTHX_ OP *o)
10598 {
10599     dVAR;
10600     OP *kid = o->op_flags & OPf_KIDS ? cUNOPo->op_first : NULL;
10601     const unsigned orig_type  = o->op_type;
10602     const unsigned array_type = orig_type == OP_EACH ? OP_AEACH
10603                               : orig_type == OP_KEYS ? OP_AKEYS : OP_AVALUES;
10604     const unsigned ref_type   = orig_type == OP_EACH ? OP_REACH
10605                               : orig_type == OP_KEYS ? OP_RKEYS : OP_RVALUES;
10606
10607     PERL_ARGS_ASSERT_CK_EACH;
10608
10609     if (kid) {
10610         switch (kid->op_type) {
10611             case OP_PADHV:
10612             case OP_RV2HV:
10613                 break;
10614             case OP_PADAV:
10615             case OP_RV2AV:
10616                 CHANGE_TYPE(o, array_type);
10617                 break;
10618             case OP_CONST:
10619                 if (kid->op_private == OPpCONST_BARE
10620                  || !SvROK(cSVOPx_sv(kid))
10621                  || (  SvTYPE(SvRV(cSVOPx_sv(kid))) != SVt_PVAV
10622                     && SvTYPE(SvRV(cSVOPx_sv(kid))) != SVt_PVHV  )
10623                    )
10624                     /* we let ck_fun handle it */
10625                     break;
10626             default:
10627                 CHANGE_TYPE(o, ref_type);
10628                 scalar(kid);
10629         }
10630     }
10631     /* if treating as a reference, defer additional checks to runtime */
10632     return o->op_type == ref_type ? o : ck_fun(o);
10633 }
10634
10635 OP *
10636 Perl_ck_length(pTHX_ OP *o)
10637 {
10638     PERL_ARGS_ASSERT_CK_LENGTH;
10639
10640     o = ck_fun(o);
10641
10642     if (ckWARN(WARN_SYNTAX)) {
10643         const OP *kid = o->op_flags & OPf_KIDS ? cLISTOPo->op_first : NULL;
10644
10645         if (kid) {
10646             SV *name = NULL;
10647             const bool hash = kid->op_type == OP_PADHV
10648                            || kid->op_type == OP_RV2HV;
10649             switch (kid->op_type) {
10650                 case OP_PADHV:
10651                 case OP_PADAV:
10652                     name = varname(
10653                         (GV *)PL_compcv, hash ? '%' : '@', kid->op_targ,
10654                         NULL, 0, 1
10655                     );
10656                     break;
10657                 case OP_RV2HV:
10658                 case OP_RV2AV:
10659                     if (cUNOPx(kid)->op_first->op_type != OP_GV) break;
10660                     {
10661                         GV *gv = cGVOPx_gv(cUNOPx(kid)->op_first);
10662                         if (!gv) break;
10663                         name = varname(gv, hash?'%':'@', 0, NULL, 0, 1);
10664                     }
10665                     break;
10666                 default:
10667                     return o;
10668             }
10669             if (name)
10670                 Perl_warner(aTHX_ packWARN(WARN_SYNTAX),
10671                     "length() used on %"SVf" (did you mean \"scalar(%s%"SVf
10672                     ")\"?)",
10673                     name, hash ? "keys " : "", name
10674                 );
10675             else if (hash)
10676                 Perl_warner(aTHX_ packWARN(WARN_SYNTAX),
10677                     "length() used on %%hash (did you mean \"scalar(keys %%hash)\"?)");
10678             else
10679                 Perl_warner(aTHX_ packWARN(WARN_SYNTAX),
10680                     "length() used on @array (did you mean \"scalar(@array)\"?)");
10681         }
10682     }
10683
10684     return o;
10685 }
10686
10687 /* Check for in place reverse and sort assignments like "@a = reverse @a"
10688    and modify the optree to make them work inplace */
10689
10690 STATIC void
10691 S_inplace_aassign(pTHX_ OP *o) {
10692
10693     OP *modop, *modop_pushmark;
10694     OP *oright;
10695     OP *oleft, *oleft_pushmark;
10696
10697     PERL_ARGS_ASSERT_INPLACE_AASSIGN;
10698
10699     assert((o->op_flags & OPf_WANT) == OPf_WANT_VOID);
10700
10701     assert(cUNOPo->op_first->op_type == OP_NULL);
10702     modop_pushmark = cUNOPx(cUNOPo->op_first)->op_first;
10703     assert(modop_pushmark->op_type == OP_PUSHMARK);
10704     modop = modop_pushmark->op_sibling;
10705
10706     if (modop->op_type != OP_SORT && modop->op_type != OP_REVERSE)
10707         return;
10708
10709     /* no other operation except sort/reverse */
10710     if (modop->op_sibling)
10711         return;
10712
10713     assert(cUNOPx(modop)->op_first->op_type == OP_PUSHMARK);
10714     if (!(oright = cUNOPx(modop)->op_first->op_sibling)) return;
10715
10716     if (modop->op_flags & OPf_STACKED) {
10717         /* skip sort subroutine/block */
10718         assert(oright->op_type == OP_NULL);
10719         oright = oright->op_sibling;
10720     }
10721
10722     assert(cUNOPo->op_first->op_sibling->op_type == OP_NULL);
10723     oleft_pushmark = cUNOPx(cUNOPo->op_first->op_sibling)->op_first;
10724     assert(oleft_pushmark->op_type == OP_PUSHMARK);
10725     oleft = oleft_pushmark->op_sibling;
10726
10727     /* Check the lhs is an array */
10728     if (!oleft ||
10729         (oleft->op_type != OP_RV2AV && oleft->op_type != OP_PADAV)
10730         || oleft->op_sibling
10731         || (oleft->op_private & OPpLVAL_INTRO)
10732     )
10733         return;
10734
10735     /* Only one thing on the rhs */
10736     if (oright->op_sibling)
10737         return;
10738
10739     /* check the array is the same on both sides */
10740     if (oleft->op_type == OP_RV2AV) {
10741         if (oright->op_type != OP_RV2AV
10742             || !cUNOPx(oright)->op_first
10743             || cUNOPx(oright)->op_first->op_type != OP_GV
10744             || cUNOPx(oleft )->op_first->op_type != OP_GV
10745             || cGVOPx_gv(cUNOPx(oleft)->op_first) !=
10746                cGVOPx_gv(cUNOPx(oright)->op_first)
10747         )
10748             return;
10749     }
10750     else if (oright->op_type != OP_PADAV
10751         || oright->op_targ != oleft->op_targ
10752     )
10753         return;
10754
10755     /* This actually is an inplace assignment */
10756
10757     modop->op_private |= OPpSORT_INPLACE;
10758
10759     /* transfer MODishness etc from LHS arg to RHS arg */
10760     oright->op_flags = oleft->op_flags;
10761
10762     /* remove the aassign op and the lhs */
10763     op_null(o);
10764     op_null(oleft_pushmark);
10765     if (oleft->op_type == OP_RV2AV && cUNOPx(oleft)->op_first)
10766         op_null(cUNOPx(oleft)->op_first);
10767     op_null(oleft);
10768 }
10769
10770 #define MAX_DEFERRED 4
10771
10772 #define DEFER(o) \
10773   STMT_START { \
10774     if (defer_ix == (MAX_DEFERRED-1)) { \
10775         CALL_RPEEP(defer_queue[defer_base]); \
10776         defer_base = (defer_base + 1) % MAX_DEFERRED; \
10777         defer_ix--; \
10778     } \
10779     defer_queue[(defer_base + ++defer_ix) % MAX_DEFERRED] = o; \
10780   } STMT_END
10781
10782 /* A peephole optimizer.  We visit the ops in the order they're to execute.
10783  * See the comments at the top of this file for more details about when
10784  * peep() is called */
10785
10786 void
10787 Perl_rpeep(pTHX_ OP *o)
10788 {
10789     dVAR;
10790     OP* oldop = NULL;
10791     OP* oldoldop = NULL;
10792     OP* defer_queue[MAX_DEFERRED]; /* small queue of deferred branches */
10793     int defer_base = 0;
10794     int defer_ix = -1;
10795
10796     if (!o || o->op_opt)
10797         return;
10798     ENTER;
10799     SAVEOP();
10800     SAVEVPTR(PL_curcop);
10801     for (;; o = o->op_next) {
10802         if (o && o->op_opt)
10803             o = NULL;
10804         if (!o) {
10805             while (defer_ix >= 0)
10806                 CALL_RPEEP(defer_queue[(defer_base + defer_ix--) % MAX_DEFERRED]);
10807             break;
10808         }
10809
10810         /* By default, this op has now been optimised. A couple of cases below
10811            clear this again.  */
10812         o->op_opt = 1;
10813         PL_op = o;
10814         switch (o->op_type) {
10815         case OP_DBSTATE:
10816             PL_curcop = ((COP*)o);              /* for warnings */
10817             break;
10818         case OP_NEXTSTATE:
10819             PL_curcop = ((COP*)o);              /* for warnings */
10820
10821             /* Two NEXTSTATEs in a row serve no purpose. Except if they happen
10822                to carry two labels. For now, take the easier option, and skip
10823                this optimisation if the first NEXTSTATE has a label.  */
10824             if (!CopLABEL((COP*)o) && !PERLDB_NOOPT) {
10825                 OP *nextop = o->op_next;
10826                 while (nextop && nextop->op_type == OP_NULL)
10827                     nextop = nextop->op_next;
10828
10829                 if (nextop && (nextop->op_type == OP_NEXTSTATE)) {
10830                     COP *firstcop = (COP *)o;
10831                     COP *secondcop = (COP *)nextop;
10832                     /* We want the COP pointed to by o (and anything else) to
10833                        become the next COP down the line.  */
10834                     cop_free(firstcop);
10835
10836                     firstcop->op_next = secondcop->op_next;
10837
10838                     /* Now steal all its pointers, and duplicate the other
10839                        data.  */
10840                     firstcop->cop_line = secondcop->cop_line;
10841 #ifdef USE_ITHREADS
10842                     firstcop->cop_stashoff = secondcop->cop_stashoff;
10843                     firstcop->cop_file = secondcop->cop_file;
10844 #else
10845                     firstcop->cop_stash = secondcop->cop_stash;
10846                     firstcop->cop_filegv = secondcop->cop_filegv;
10847 #endif
10848                     firstcop->cop_hints = secondcop->cop_hints;
10849                     firstcop->cop_seq = secondcop->cop_seq;
10850                     firstcop->cop_warnings = secondcop->cop_warnings;
10851                     firstcop->cop_hints_hash = secondcop->cop_hints_hash;
10852
10853 #ifdef USE_ITHREADS
10854                     secondcop->cop_stashoff = 0;
10855                     secondcop->cop_file = NULL;
10856 #else
10857                     secondcop->cop_stash = NULL;
10858                     secondcop->cop_filegv = NULL;
10859 #endif
10860                     secondcop->cop_warnings = NULL;
10861                     secondcop->cop_hints_hash = NULL;
10862
10863                     /* If we use op_null(), and hence leave an ex-COP, some
10864                        warnings are misreported. For example, the compile-time
10865                        error in 'use strict; no strict refs;'  */
10866                     secondcop->op_type = OP_NULL;
10867                     secondcop->op_ppaddr = PL_ppaddr[OP_NULL];
10868                 }
10869             }
10870             break;
10871
10872         case OP_CONCAT:
10873             if (o->op_next && o->op_next->op_type == OP_STRINGIFY) {
10874                 if (o->op_next->op_private & OPpTARGET_MY) {
10875                     if (o->op_flags & OPf_STACKED) /* chained concats */
10876                         break; /* ignore_optimization */
10877                     else {
10878                         /* assert(PL_opargs[o->op_type] & OA_TARGLEX); */
10879                         o->op_targ = o->op_next->op_targ;
10880                         o->op_next->op_targ = 0;
10881                         o->op_private |= OPpTARGET_MY;
10882                     }
10883                 }
10884                 op_null(o->op_next);
10885             }
10886             break;
10887         case OP_STUB:
10888             if ((o->op_flags & OPf_WANT) != OPf_WANT_LIST) {
10889                 break; /* Scalar stub must produce undef.  List stub is noop */
10890             }
10891             goto nothin;
10892         case OP_NULL:
10893             if (o->op_targ == OP_NEXTSTATE
10894                 || o->op_targ == OP_DBSTATE)
10895             {
10896                 PL_curcop = ((COP*)o);
10897             }
10898             /* XXX: We avoid setting op_seq here to prevent later calls
10899                to rpeep() from mistakenly concluding that optimisation
10900                has already occurred. This doesn't fix the real problem,
10901                though (See 20010220.007). AMS 20010719 */
10902             /* op_seq functionality is now replaced by op_opt */
10903             o->op_opt = 0;
10904             /* FALL THROUGH */
10905         case OP_SCALAR:
10906         case OP_LINESEQ:
10907         case OP_SCOPE:
10908         nothin:
10909             if (oldop && o->op_next) {
10910                 oldop->op_next = o->op_next;
10911                 o->op_opt = 0;
10912                 continue;
10913             }
10914             break;
10915
10916         case OP_PUSHMARK:
10917
10918             /* Convert a series of PAD ops for my vars plus support into a
10919              * single padrange op. Basically
10920              *
10921              *    pushmark -> pad[ahs]v -> pad[ahs]?v -> ... -> (list) -> rest
10922              *
10923              * becomes, depending on circumstances, one of
10924              *
10925              *    padrange  ----------------------------------> (list) -> rest
10926              *    padrange  --------------------------------------------> rest
10927              *
10928              * where all the pad indexes are sequential and of the same type
10929              * (INTRO or not).
10930              * We convert the pushmark into a padrange op, then skip
10931              * any other pad ops, and possibly some trailing ops.
10932              * Note that we don't null() the skipped ops, to make it
10933              * easier for Deparse to undo this optimisation (and none of
10934              * the skipped ops are holding any resourses). It also makes
10935              * it easier for find_uninit_var(), as it can just ignore
10936              * padrange, and examine the original pad ops.
10937              */
10938         {
10939             OP *p;
10940             OP *followop = NULL; /* the op that will follow the padrange op */
10941             U8 count = 0;
10942             U8 intro = 0;
10943             PADOFFSET base = 0; /* init only to stop compiler whining */
10944             U8 gimme       = 0; /* init only to stop compiler whining */
10945             bool defav = 0;  /* seen (...) = @_ */
10946             bool reuse = 0;  /* reuse an existing padrange op */
10947
10948             /* look for a pushmark -> gv[_] -> rv2av */
10949
10950             {
10951                 GV *gv;
10952                 OP *rv2av, *q;
10953                 p = o->op_next;
10954                 if (   p->op_type == OP_GV
10955                     && (gv = cGVOPx_gv(p))
10956                     && GvNAMELEN_get(gv) == 1
10957                     && *GvNAME_get(gv) == '_'
10958                     && GvSTASH(gv) == PL_defstash
10959                     && (rv2av = p->op_next)
10960                     && rv2av->op_type == OP_RV2AV
10961                     && !(rv2av->op_flags & OPf_REF)
10962                     && !(rv2av->op_private & (OPpLVAL_INTRO|OPpMAYBE_LVSUB))
10963                     && ((rv2av->op_flags & OPf_WANT) == OPf_WANT_LIST)
10964                     && o->op_sibling == rv2av /* these two for Deparse */
10965                     && cUNOPx(rv2av)->op_first == p
10966                 ) {
10967                     q = rv2av->op_next;
10968                     if (q->op_type == OP_NULL)
10969                         q = q->op_next;
10970                     if (q->op_type == OP_PUSHMARK) {
10971                         defav = 1;
10972                         p = q;
10973                     }
10974                 }
10975             }
10976             if (!defav) {
10977                 /* To allow Deparse to pessimise this, it needs to be able
10978                  * to restore the pushmark's original op_next, which it
10979                  * will assume to be the same as op_sibling. */
10980                 if (o->op_next != o->op_sibling)
10981                     break;
10982                 p = o;
10983             }
10984
10985             /* scan for PAD ops */
10986
10987             for (p = p->op_next; p; p = p->op_next) {
10988                 if (p->op_type == OP_NULL)
10989                     continue;
10990
10991                 if ((     p->op_type != OP_PADSV
10992                        && p->op_type != OP_PADAV
10993                        && p->op_type != OP_PADHV
10994                     )
10995                       /* any private flag other than INTRO? e.g. STATE */
10996                    || (p->op_private & ~OPpLVAL_INTRO)
10997                 )
10998                     break;
10999
11000                 /* let $a[N] potentially be optimised into ALEMFAST_LEX
11001                  * instead */
11002                 if (   p->op_type == OP_PADAV
11003                     && p->op_next
11004                     && p->op_next->op_type == OP_CONST
11005                     && p->op_next->op_next
11006                     && p->op_next->op_next->op_type == OP_AELEM
11007                 )
11008                     break;
11009
11010                 /* for 1st padop, note what type it is and the range
11011                  * start; for the others, check that it's the same type
11012                  * and that the targs are contiguous */
11013                 if (count == 0) {
11014                     intro = (p->op_private & OPpLVAL_INTRO);
11015                     base = p->op_targ;
11016                     gimme = (p->op_flags & OPf_WANT);
11017                 }
11018                 else {
11019                     if ((p->op_private & OPpLVAL_INTRO) != intro)
11020                         break;
11021                     /* Note that you'd normally  expect targs to be
11022                      * contiguous in my($a,$b,$c), but that's not the case
11023                      * when external modules start doing things, e.g.
11024                      i* Function::Parameters */
11025                     if (p->op_targ != base + count)
11026                         break;
11027                     assert(p->op_targ == base + count);
11028                     /* all the padops should be in the same context */
11029                     if (gimme != (p->op_flags & OPf_WANT))
11030                         break;
11031                 }
11032
11033                 /* for AV, HV, only when we're not flattening */
11034                 if (   p->op_type != OP_PADSV
11035                     && gimme != OPf_WANT_VOID
11036                     && !(p->op_flags & OPf_REF)
11037                 )
11038                     break;
11039
11040                 if (count >= OPpPADRANGE_COUNTMASK)
11041                     break;
11042
11043                 /* there's a biggest base we can fit into a
11044                  * SAVEt_CLEARPADRANGE in pp_padrange */
11045                 if (intro && base >
11046                         (UV_MAX >> (OPpPADRANGE_COUNTSHIFT+SAVE_TIGHT_SHIFT)))
11047                     break;
11048
11049                 /* Success! We've got another valid pad op to optimise away */
11050                 count++;
11051                 followop = p->op_next;
11052             }
11053
11054             if (count < 1)
11055                 break;
11056
11057             /* pp_padrange in specifically compile-time void context
11058              * skips pushing a mark and lexicals; in all other contexts
11059              * (including unknown till runtime) it pushes a mark and the
11060              * lexicals. We must be very careful then, that the ops we
11061              * optimise away would have exactly the same effect as the
11062              * padrange.
11063              * In particular in void context, we can only optimise to
11064              * a padrange if see see the complete sequence
11065              *     pushmark, pad*v, ...., list, nextstate
11066              * which has the net effect of of leaving the stack empty
11067              * (for now we leave the nextstate in the execution chain, for
11068              * its other side-effects).
11069              */
11070             assert(followop);
11071             if (gimme == OPf_WANT_VOID) {
11072                 if (followop->op_type == OP_LIST
11073                         && gimme == (followop->op_flags & OPf_WANT)
11074                         && (   followop->op_next->op_type == OP_NEXTSTATE
11075                             || followop->op_next->op_type == OP_DBSTATE))
11076                 {
11077                     followop = followop->op_next; /* skip OP_LIST */
11078
11079                     /* consolidate two successive my(...);'s */
11080
11081                     if (   oldoldop
11082                         && oldoldop->op_type == OP_PADRANGE
11083                         && (oldoldop->op_flags & OPf_WANT) == OPf_WANT_VOID
11084                         && (oldoldop->op_private & OPpLVAL_INTRO) == intro
11085                         && !(oldoldop->op_flags & OPf_SPECIAL)
11086                     ) {
11087                         U8 old_count;
11088                         assert(oldoldop->op_next == oldop);
11089                         assert(   oldop->op_type == OP_NEXTSTATE
11090                                || oldop->op_type == OP_DBSTATE);
11091                         assert(oldop->op_next == o);
11092
11093                         old_count
11094                             = (oldoldop->op_private & OPpPADRANGE_COUNTMASK);
11095                         assert(oldoldop->op_targ + old_count == base);
11096
11097                         if (old_count < OPpPADRANGE_COUNTMASK - count) {
11098                             base = oldoldop->op_targ;
11099                             count += old_count;
11100                             reuse = 1;
11101                         }
11102                     }
11103
11104                     /* if there's any immediately following singleton
11105                      * my var's; then swallow them and the associated
11106                      * nextstates; i.e.
11107                      *    my ($a,$b); my $c; my $d;
11108                      * is treated as
11109                      *    my ($a,$b,$c,$d);
11110                      */
11111
11112                     while (    ((p = followop->op_next))
11113                             && (  p->op_type == OP_PADSV
11114                                || p->op_type == OP_PADAV
11115                                || p->op_type == OP_PADHV)
11116                             && (p->op_flags & OPf_WANT) == OPf_WANT_VOID
11117                             && (p->op_private & OPpLVAL_INTRO) == intro
11118                             && p->op_next
11119                             && (   p->op_next->op_type == OP_NEXTSTATE
11120                                 || p->op_next->op_type == OP_DBSTATE)
11121                             && count < OPpPADRANGE_COUNTMASK
11122                     ) {
11123                         assert(base + count == p->op_targ);
11124                         count++;
11125                         followop = p->op_next;
11126                     }
11127                 }
11128                 else
11129                     break;
11130             }
11131
11132             if (reuse) {
11133                 assert(oldoldop->op_type == OP_PADRANGE);
11134                 oldoldop->op_next = followop;
11135                 oldoldop->op_private = (intro | count);
11136                 o = oldoldop;
11137                 oldop = NULL;
11138                 oldoldop = NULL;
11139             }
11140             else {
11141                 /* Convert the pushmark into a padrange.
11142                  * To make Deparse easier, we guarantee that a padrange was
11143                  * *always* formerly a pushmark */
11144                 assert(o->op_type == OP_PUSHMARK);
11145                 o->op_next = followop;
11146                 o->op_type = OP_PADRANGE;
11147                 o->op_ppaddr = PL_ppaddr[OP_PADRANGE];
11148                 o->op_targ = base;
11149                 /* bit 7: INTRO; bit 6..0: count */
11150                 o->op_private = (intro | count);
11151                 o->op_flags = ((o->op_flags & ~(OPf_WANT|OPf_SPECIAL))
11152                                     | gimme | (defav ? OPf_SPECIAL : 0));
11153             }
11154             break;
11155         }
11156
11157         case OP_PADAV:
11158         case OP_GV:
11159             if (o->op_type == OP_PADAV || o->op_next->op_type == OP_RV2AV) {
11160                 OP* const pop = (o->op_type == OP_PADAV) ?
11161                             o->op_next : o->op_next->op_next;
11162                 IV i;
11163                 if (pop && pop->op_type == OP_CONST &&
11164                     ((PL_op = pop->op_next)) &&
11165                     pop->op_next->op_type == OP_AELEM &&
11166                     !(pop->op_next->op_private &
11167                       (OPpLVAL_INTRO|OPpLVAL_DEFER|OPpDEREF|OPpMAYBE_LVSUB)) &&
11168                     (i = SvIV(((SVOP*)pop)->op_sv)) <= 255 && i >= 0)
11169                 {
11170                     GV *gv;
11171                     if (cSVOPx(pop)->op_private & OPpCONST_STRICT)
11172                         no_bareword_allowed(pop);
11173                     if (o->op_type == OP_GV)
11174                         op_null(o->op_next);
11175                     op_null(pop->op_next);
11176                     op_null(pop);
11177                     o->op_flags |= pop->op_next->op_flags & OPf_MOD;
11178                     o->op_next = pop->op_next->op_next;
11179                     o->op_ppaddr = PL_ppaddr[OP_AELEMFAST];
11180                     o->op_private = (U8)i;
11181                     if (o->op_type == OP_GV) {
11182                         gv = cGVOPo_gv;
11183                         GvAVn(gv);
11184                         o->op_type = OP_AELEMFAST;
11185                     }
11186                     else
11187                         o->op_type = OP_AELEMFAST_LEX;
11188                 }
11189                 break;
11190             }
11191
11192             if (o->op_next->op_type == OP_RV2SV) {
11193                 if (!(o->op_next->op_private & OPpDEREF)) {
11194                     op_null(o->op_next);
11195                     o->op_private |= o->op_next->op_private & (OPpLVAL_INTRO
11196                                                                | OPpOUR_INTRO);
11197                     o->op_next = o->op_next->op_next;
11198                     o->op_type = OP_GVSV;
11199                     o->op_ppaddr = PL_ppaddr[OP_GVSV];
11200                 }
11201             }
11202             else if (o->op_next->op_type == OP_READLINE
11203                     && o->op_next->op_next->op_type == OP_CONCAT
11204                     && (o->op_next->op_next->op_flags & OPf_STACKED))
11205             {
11206                 /* Turn "$a .= <FH>" into an OP_RCATLINE. AMS 20010917 */
11207                 o->op_type   = OP_RCATLINE;
11208                 o->op_flags |= OPf_STACKED;
11209                 o->op_ppaddr = PL_ppaddr[OP_RCATLINE];
11210                 op_null(o->op_next->op_next);
11211                 op_null(o->op_next);
11212             }
11213
11214             break;
11215
11216         {
11217             OP *fop;
11218             OP *sop;
11219
11220 #define HV_OR_SCALARHV(op)                                   \
11221     (  (op)->op_type == OP_PADHV || (op)->op_type == OP_RV2HV \
11222        ? (op)                                                  \
11223        : (op)->op_type == OP_SCALAR && (op)->op_flags & OPf_KIDS \
11224        && (  cUNOPx(op)->op_first->op_type == OP_PADHV          \
11225           || cUNOPx(op)->op_first->op_type == OP_RV2HV)          \
11226          ? cUNOPx(op)->op_first                                   \
11227          : NULL)
11228
11229         case OP_NOT:
11230             if ((fop = HV_OR_SCALARHV(cUNOP->op_first)))
11231                 fop->op_private |= OPpTRUEBOOL;
11232             break;
11233
11234         case OP_AND:
11235         case OP_OR:
11236         case OP_DOR:
11237             fop = cLOGOP->op_first;
11238             sop = fop->op_sibling;
11239             while (cLOGOP->op_other->op_type == OP_NULL)
11240                 cLOGOP->op_other = cLOGOP->op_other->op_next;
11241             while (o->op_next && (   o->op_type == o->op_next->op_type
11242                                   || o->op_next->op_type == OP_NULL))
11243                 o->op_next = o->op_next->op_next;
11244             DEFER(cLOGOP->op_other);
11245
11246             o->op_opt = 1;
11247             fop = HV_OR_SCALARHV(fop);
11248             if (sop) sop = HV_OR_SCALARHV(sop);
11249             if (fop || sop
11250             ){
11251                 OP * nop = o;
11252                 OP * lop = o;
11253                 if (!((nop->op_flags & OPf_WANT) == OPf_WANT_VOID)) {
11254                     while (nop && nop->op_next) {
11255                         switch (nop->op_next->op_type) {
11256                             case OP_NOT:
11257                             case OP_AND:
11258                             case OP_OR:
11259                             case OP_DOR:
11260                                 lop = nop = nop->op_next;
11261                                 break;
11262                             case OP_NULL:
11263                                 nop = nop->op_next;
11264                                 break;
11265                             default:
11266                                 nop = NULL;
11267                                 break;
11268                         }
11269                     }
11270                 }
11271                 if (fop) {
11272                     if (  (lop->op_flags & OPf_WANT) == OPf_WANT_VOID
11273                       || o->op_type == OP_AND  )
11274                         fop->op_private |= OPpTRUEBOOL;
11275                     else if (!(lop->op_flags & OPf_WANT))
11276                         fop->op_private |= OPpMAYBE_TRUEBOOL;
11277                 }
11278                 if (  (lop->op_flags & OPf_WANT) == OPf_WANT_VOID
11279                    && sop)
11280                     sop->op_private |= OPpTRUEBOOL;
11281             }
11282
11283
11284             break;
11285
11286         case OP_COND_EXPR:
11287             if ((fop = HV_OR_SCALARHV(cLOGOP->op_first)))
11288                 fop->op_private |= OPpTRUEBOOL;
11289 #undef HV_OR_SCALARHV
11290             /* GERONIMO! */
11291         }
11292
11293         case OP_MAPWHILE:
11294         case OP_GREPWHILE:
11295         case OP_ANDASSIGN:
11296         case OP_ORASSIGN:
11297         case OP_DORASSIGN:
11298         case OP_RANGE:
11299         case OP_ONCE:
11300             while (cLOGOP->op_other->op_type == OP_NULL)
11301                 cLOGOP->op_other = cLOGOP->op_other->op_next;
11302             DEFER(cLOGOP->op_other);
11303             break;
11304
11305         case OP_ENTERLOOP:
11306         case OP_ENTERITER:
11307             while (cLOOP->op_redoop->op_type == OP_NULL)
11308                 cLOOP->op_redoop = cLOOP->op_redoop->op_next;
11309             while (cLOOP->op_nextop->op_type == OP_NULL)
11310                 cLOOP->op_nextop = cLOOP->op_nextop->op_next;
11311             while (cLOOP->op_lastop->op_type == OP_NULL)
11312                 cLOOP->op_lastop = cLOOP->op_lastop->op_next;
11313             /* a while(1) loop doesn't have an op_next that escapes the
11314              * loop, so we have to explicitly follow the op_lastop to
11315              * process the rest of the code */
11316             DEFER(cLOOP->op_lastop);
11317             break;
11318
11319         case OP_SUBST:
11320             assert(!(cPMOP->op_pmflags & PMf_ONCE));
11321             while (cPMOP->op_pmstashstartu.op_pmreplstart &&
11322                    cPMOP->op_pmstashstartu.op_pmreplstart->op_type == OP_NULL)
11323                 cPMOP->op_pmstashstartu.op_pmreplstart
11324                     = cPMOP->op_pmstashstartu.op_pmreplstart->op_next;
11325             DEFER(cPMOP->op_pmstashstartu.op_pmreplstart);
11326             break;
11327
11328         case OP_SORT: {
11329             OP *oright;
11330
11331             if (o->op_flags & OPf_STACKED) {
11332                 OP * const kid =
11333                     cUNOPx(cLISTOP->op_first->op_sibling)->op_first;
11334                 if (kid->op_type == OP_SCOPE
11335                  || (kid->op_type == OP_NULL && kid->op_targ == OP_LEAVE))
11336                     DEFER(kLISTOP->op_first);
11337             }
11338
11339             /* check that RHS of sort is a single plain array */
11340             oright = cUNOPo->op_first;
11341             if (!oright || oright->op_type != OP_PUSHMARK)
11342                 break;
11343
11344             if (o->op_private & OPpSORT_INPLACE)
11345                 break;
11346
11347             /* reverse sort ... can be optimised.  */
11348             if (!cUNOPo->op_sibling) {
11349                 /* Nothing follows us on the list. */
11350                 OP * const reverse = o->op_next;
11351
11352                 if (reverse->op_type == OP_REVERSE &&
11353                     (reverse->op_flags & OPf_WANT) == OPf_WANT_LIST) {
11354                     OP * const pushmark = cUNOPx(reverse)->op_first;
11355                     if (pushmark && (pushmark->op_type == OP_PUSHMARK)
11356                         && (cUNOPx(pushmark)->op_sibling == o)) {
11357                         /* reverse -> pushmark -> sort */
11358                         o->op_private |= OPpSORT_REVERSE;
11359                         op_null(reverse);
11360                         pushmark->op_next = oright->op_next;
11361                         op_null(oright);
11362                     }
11363                 }
11364             }
11365
11366             break;
11367         }
11368
11369         case OP_REVERSE: {
11370             OP *ourmark, *theirmark, *ourlast, *iter, *expushmark, *rv2av;
11371             OP *gvop = NULL;
11372             LISTOP *enter, *exlist;
11373
11374             if (o->op_private & OPpSORT_INPLACE)
11375                 break;
11376
11377             enter = (LISTOP *) o->op_next;
11378             if (!enter)
11379                 break;
11380             if (enter->op_type == OP_NULL) {
11381                 enter = (LISTOP *) enter->op_next;
11382                 if (!enter)
11383                     break;
11384             }
11385             /* for $a (...) will have OP_GV then OP_RV2GV here.
11386                for (...) just has an OP_GV.  */
11387             if (enter->op_type == OP_GV) {
11388                 gvop = (OP *) enter;
11389                 enter = (LISTOP *) enter->op_next;
11390                 if (!enter)
11391                     break;
11392                 if (enter->op_type == OP_RV2GV) {
11393                   enter = (LISTOP *) enter->op_next;
11394                   if (!enter)
11395                     break;
11396                 }
11397             }
11398
11399             if (enter->op_type != OP_ENTERITER)
11400                 break;
11401
11402             iter = enter->op_next;
11403             if (!iter || iter->op_type != OP_ITER)
11404                 break;
11405
11406             expushmark = enter->op_first;
11407             if (!expushmark || expushmark->op_type != OP_NULL
11408                 || expushmark->op_targ != OP_PUSHMARK)
11409                 break;
11410
11411             exlist = (LISTOP *) expushmark->op_sibling;
11412             if (!exlist || exlist->op_type != OP_NULL
11413                 || exlist->op_targ != OP_LIST)
11414                 break;
11415
11416             if (exlist->op_last != o) {
11417                 /* Mmm. Was expecting to point back to this op.  */
11418                 break;
11419             }
11420             theirmark = exlist->op_first;
11421             if (!theirmark || theirmark->op_type != OP_PUSHMARK)
11422                 break;
11423
11424             if (theirmark->op_sibling != o) {
11425                 /* There's something between the mark and the reverse, eg
11426                    for (1, reverse (...))
11427                    so no go.  */
11428                 break;
11429             }
11430
11431             ourmark = ((LISTOP *)o)->op_first;
11432             if (!ourmark || ourmark->op_type != OP_PUSHMARK)
11433                 break;
11434
11435             ourlast = ((LISTOP *)o)->op_last;
11436             if (!ourlast || ourlast->op_next != o)
11437                 break;
11438
11439             rv2av = ourmark->op_sibling;
11440             if (rv2av && rv2av->op_type == OP_RV2AV && rv2av->op_sibling == 0
11441                 && rv2av->op_flags == (OPf_WANT_LIST | OPf_KIDS)
11442                 && enter->op_flags == (OPf_WANT_LIST | OPf_KIDS)) {
11443                 /* We're just reversing a single array.  */
11444                 rv2av->op_flags = OPf_WANT_SCALAR | OPf_KIDS | OPf_REF;
11445                 enter->op_flags |= OPf_STACKED;
11446             }
11447
11448             /* We don't have control over who points to theirmark, so sacrifice
11449                ours.  */
11450             theirmark->op_next = ourmark->op_next;
11451             theirmark->op_flags = ourmark->op_flags;
11452             ourlast->op_next = gvop ? gvop : (OP *) enter;
11453             op_null(ourmark);
11454             op_null(o);
11455             enter->op_private |= OPpITER_REVERSED;
11456             iter->op_private |= OPpITER_REVERSED;
11457
11458             break;
11459         }
11460
11461         case OP_QR:
11462         case OP_MATCH:
11463             if (!(cPMOP->op_pmflags & PMf_ONCE)) {
11464                 assert (!cPMOP->op_pmstashstartu.op_pmreplstart);
11465             }
11466             break;
11467
11468         case OP_RUNCV:
11469             if (!(o->op_private & OPpOFFBYONE) && !CvCLONE(PL_compcv)) {
11470                 SV *sv;
11471                 if (CvEVAL(PL_compcv)) sv = &PL_sv_undef;
11472                 else {
11473                     sv = newRV((SV *)PL_compcv);
11474                     sv_rvweaken(sv);
11475                     SvREADONLY_on(sv);
11476                 }
11477                 o->op_type = OP_CONST;
11478                 o->op_ppaddr = PL_ppaddr[OP_CONST];
11479                 o->op_flags |= OPf_SPECIAL;
11480                 cSVOPo->op_sv = sv;
11481             }
11482             break;
11483
11484         case OP_SASSIGN:
11485             if (OP_GIMME(o,0) == G_VOID) {
11486                 OP *right = cBINOP->op_first;
11487                 if (right) {
11488                     OP *left = right->op_sibling;
11489                     if (left->op_type == OP_SUBSTR
11490                          && (left->op_private & 7) < 4) {
11491                         op_null(o);
11492                         cBINOP->op_first = left;
11493                         right->op_sibling =
11494                             cBINOPx(left)->op_first->op_sibling;
11495                         cBINOPx(left)->op_first->op_sibling = right;
11496                         left->op_private |= OPpSUBSTR_REPL_FIRST;
11497                         left->op_flags =
11498                             (o->op_flags & ~OPf_WANT) | OPf_WANT_VOID;
11499                     }
11500                 }
11501             }
11502             break;
11503
11504         case OP_CUSTOM: {
11505             Perl_cpeep_t cpeep =
11506                 XopENTRY(Perl_custom_op_xop(aTHX_ o), xop_peep);
11507             if (cpeep)
11508                 cpeep(aTHX_ o, oldop);
11509             break;
11510         }
11511
11512         }
11513         oldoldop = oldop;
11514         oldop = o;
11515     }
11516     LEAVE;
11517 }
11518
11519 void
11520 Perl_peep(pTHX_ OP *o)
11521 {
11522     CALL_RPEEP(o);
11523 }
11524
11525 /*
11526 =head1 Custom Operators
11527
11528 =for apidoc Ao||custom_op_xop
11529 Return the XOP structure for a given custom op. This function should be
11530 considered internal to OP_NAME and the other access macros: use them instead.
11531
11532 =cut
11533 */
11534
11535 const XOP *
11536 Perl_custom_op_xop(pTHX_ const OP *o)
11537 {
11538     SV *keysv;
11539     HE *he = NULL;
11540     XOP *xop;
11541
11542     static const XOP xop_null = { 0, 0, 0, 0, 0 };
11543
11544     PERL_ARGS_ASSERT_CUSTOM_OP_XOP;
11545     assert(o->op_type == OP_CUSTOM);
11546
11547     /* This is wrong. It assumes a function pointer can be cast to IV,
11548      * which isn't guaranteed, but this is what the old custom OP code
11549      * did. In principle it should be safer to Copy the bytes of the
11550      * pointer into a PV: since the new interface is hidden behind
11551      * functions, this can be changed later if necessary.  */
11552     /* Change custom_op_xop if this ever happens */
11553     keysv = sv_2mortal(newSViv(PTR2IV(o->op_ppaddr)));
11554
11555     if (PL_custom_ops)
11556         he = hv_fetch_ent(PL_custom_ops, keysv, 0, 0);
11557
11558     /* assume noone will have just registered a desc */
11559     if (!he && PL_custom_op_names &&
11560         (he = hv_fetch_ent(PL_custom_op_names, keysv, 0, 0))
11561     ) {
11562         const char *pv;
11563         STRLEN l;
11564
11565         /* XXX does all this need to be shared mem? */
11566         Newxz(xop, 1, XOP);
11567         pv = SvPV(HeVAL(he), l);
11568         XopENTRY_set(xop, xop_name, savepvn(pv, l));
11569         if (PL_custom_op_descs &&
11570             (he = hv_fetch_ent(PL_custom_op_descs, keysv, 0, 0))
11571         ) {
11572             pv = SvPV(HeVAL(he), l);
11573             XopENTRY_set(xop, xop_desc, savepvn(pv, l));
11574         }
11575         Perl_custom_op_register(aTHX_ o->op_ppaddr, xop);
11576         return xop;
11577     }
11578
11579     if (!he) return &xop_null;
11580
11581     xop = INT2PTR(XOP *, SvIV(HeVAL(he)));
11582     return xop;
11583 }
11584
11585 /*
11586 =for apidoc Ao||custom_op_register
11587 Register a custom op. See L<perlguts/"Custom Operators">.
11588
11589 =cut
11590 */
11591
11592 void
11593 Perl_custom_op_register(pTHX_ Perl_ppaddr_t ppaddr, const XOP *xop)
11594 {
11595     SV *keysv;
11596
11597     PERL_ARGS_ASSERT_CUSTOM_OP_REGISTER;
11598
11599     /* see the comment in custom_op_xop */
11600     keysv = sv_2mortal(newSViv(PTR2IV(ppaddr)));
11601
11602     if (!PL_custom_ops)
11603         PL_custom_ops = newHV();
11604
11605     if (!hv_store_ent(PL_custom_ops, keysv, newSViv(PTR2IV(xop)), 0))
11606         Perl_croak(aTHX_ "panic: can't register custom OP %s", xop->xop_name);
11607 }
11608
11609 /*
11610 =head1 Functions in file op.c
11611
11612 =for apidoc core_prototype
11613 This function assigns the prototype of the named core function to C<sv>, or
11614 to a new mortal SV if C<sv> is NULL.  It returns the modified C<sv>, or
11615 NULL if the core function has no prototype.  C<code> is a code as returned
11616 by C<keyword()>.  It must not be equal to 0 or -KEY_CORE.
11617
11618 =cut
11619 */
11620
11621 SV *
11622 Perl_core_prototype(pTHX_ SV *sv, const char *name, const int code,
11623                           int * const opnum)
11624 {
11625     int i = 0, n = 0, seen_question = 0, defgv = 0;
11626     I32 oa;
11627 #define MAX_ARGS_OP ((sizeof(I32) - 1) * 2)
11628     char str[ MAX_ARGS_OP * 2 + 2 ]; /* One ';', one '\0' */
11629     bool nullret = FALSE;
11630
11631     PERL_ARGS_ASSERT_CORE_PROTOTYPE;
11632
11633     assert (code && code != -KEY_CORE);
11634
11635     if (!sv) sv = sv_newmortal();
11636
11637 #define retsetpvs(x,y) sv_setpvs(sv, x); if(opnum) *opnum=(y); return sv
11638
11639     switch (code < 0 ? -code : code) {
11640     case KEY_and   : case KEY_chop: case KEY_chomp:
11641     case KEY_cmp   : case KEY_defined: case KEY_delete: case KEY_exec  :
11642     case KEY_exists: case KEY_eq     : case KEY_ge    : case KEY_goto  :
11643     case KEY_grep  : case KEY_gt     : case KEY_last  : case KEY_le    :
11644     case KEY_lt    : case KEY_map    : case KEY_ne    : case KEY_next  :
11645     case KEY_or    : case KEY_print  : case KEY_printf: case KEY_qr    :
11646     case KEY_redo  : case KEY_require: case KEY_return: case KEY_say   :
11647     case KEY_select: case KEY_sort   : case KEY_split : case KEY_system:
11648     case KEY_x     : case KEY_xor    :
11649         if (!opnum) return NULL; nullret = TRUE; goto findopnum;
11650     case KEY_glob:    retsetpvs("_;", OP_GLOB);
11651     case KEY_keys:    retsetpvs("+", OP_KEYS);
11652     case KEY_values:  retsetpvs("+", OP_VALUES);
11653     case KEY_each:    retsetpvs("+", OP_EACH);
11654     case KEY_push:    retsetpvs("+@", OP_PUSH);
11655     case KEY_unshift: retsetpvs("+@", OP_UNSHIFT);
11656     case KEY_pop:     retsetpvs(";+", OP_POP);
11657     case KEY_shift:   retsetpvs(";+", OP_SHIFT);
11658     case KEY_pos:     retsetpvs(";\\[$*]", OP_POS);
11659     case KEY_splice:
11660         retsetpvs("+;$$@", OP_SPLICE);
11661     case KEY___FILE__: case KEY___LINE__: case KEY___PACKAGE__:
11662         retsetpvs("", 0);
11663     case KEY_evalbytes:
11664         name = "entereval"; break;
11665     case KEY_readpipe:
11666         name = "backtick";
11667     }
11668
11669 #undef retsetpvs
11670
11671   findopnum:
11672     while (i < MAXO) {  /* The slow way. */
11673         if (strEQ(name, PL_op_name[i])
11674             || strEQ(name, PL_op_desc[i]))
11675         {
11676             if (nullret) { assert(opnum); *opnum = i; return NULL; }
11677             goto found;
11678         }
11679         i++;
11680     }
11681     return NULL;
11682   found:
11683     defgv = PL_opargs[i] & OA_DEFGV;
11684     oa = PL_opargs[i] >> OASHIFT;
11685     while (oa) {
11686         if (oa & OA_OPTIONAL && !seen_question && (
11687               !defgv || (oa & (OA_OPTIONAL - 1)) == OA_FILEREF
11688         )) {
11689             seen_question = 1;
11690             str[n++] = ';';
11691         }
11692         if ((oa & (OA_OPTIONAL - 1)) >= OA_AVREF
11693             && (oa & (OA_OPTIONAL - 1)) <= OA_SCALARREF
11694             /* But globs are already references (kinda) */
11695             && (oa & (OA_OPTIONAL - 1)) != OA_FILEREF
11696         ) {
11697             str[n++] = '\\';
11698         }
11699         if ((oa & (OA_OPTIONAL - 1)) == OA_SCALARREF
11700          && !scalar_mod_type(NULL, i)) {
11701             str[n++] = '[';
11702             str[n++] = '$';
11703             str[n++] = '@';
11704             str[n++] = '%';
11705             if (i == OP_LOCK || i == OP_UNDEF) str[n++] = '&';
11706             str[n++] = '*';
11707             str[n++] = ']';
11708         }
11709         else str[n++] = ("?$@@%&*$")[oa & (OA_OPTIONAL - 1)];
11710         if (oa & OA_OPTIONAL && defgv && str[n-1] == '$') {
11711             str[n-1] = '_'; defgv = 0;
11712         }
11713         oa = oa >> 4;
11714     }
11715     if (code == -KEY_not || code == -KEY_getprotobynumber) str[n++] = ';';
11716     str[n++] = '\0';
11717     sv_setpvn(sv, str, n - 1);
11718     if (opnum) *opnum = i;
11719     return sv;
11720 }
11721
11722 OP *
11723 Perl_coresub_op(pTHX_ SV * const coreargssv, const int code,
11724                       const int opnum)
11725 {
11726     OP * const argop = newSVOP(OP_COREARGS,0,coreargssv);
11727     OP *o;
11728
11729     PERL_ARGS_ASSERT_CORESUB_OP;
11730
11731     switch(opnum) {
11732     case 0:
11733         return op_append_elem(OP_LINESEQ,
11734                        argop,
11735                        newSLICEOP(0,
11736                                   newSVOP(OP_CONST, 0, newSViv(-code % 3)),
11737                                   newOP(OP_CALLER,0)
11738                        )
11739                );
11740     case OP_SELECT: /* which represents OP_SSELECT as well */
11741         if (code)
11742             return newCONDOP(
11743                          0,
11744                          newBINOP(OP_GT, 0,
11745                                   newAVREF(newGVOP(OP_GV, 0, PL_defgv)),
11746                                   newSVOP(OP_CONST, 0, newSVuv(1))
11747                                  ),
11748                          coresub_op(newSVuv((UV)OP_SSELECT), 0,
11749                                     OP_SSELECT),
11750                          coresub_op(coreargssv, 0, OP_SELECT)
11751                    );
11752         /* FALL THROUGH */
11753     default:
11754         switch (PL_opargs[opnum] & OA_CLASS_MASK) {
11755         case OA_BASEOP:
11756             return op_append_elem(
11757                         OP_LINESEQ, argop,
11758                         newOP(opnum,
11759                               opnum == OP_WANTARRAY || opnum == OP_RUNCV
11760                                 ? OPpOFFBYONE << 8 : 0)
11761                    );
11762         case OA_BASEOP_OR_UNOP:
11763             if (opnum == OP_ENTEREVAL) {
11764                 o = newUNOP(OP_ENTEREVAL,OPpEVAL_COPHH<<8,argop);
11765                 if (code == -KEY_evalbytes) o->op_private |= OPpEVAL_BYTES;
11766             }
11767             else o = newUNOP(opnum,0,argop);
11768             if (opnum == OP_CALLER) o->op_private |= OPpOFFBYONE;
11769             else {
11770           onearg:
11771               if (is_handle_constructor(o, 1))
11772                 argop->op_private |= OPpCOREARGS_DEREF1;
11773               if (scalar_mod_type(NULL, opnum))
11774                 argop->op_private |= OPpCOREARGS_SCALARMOD;
11775             }
11776             return o;
11777         default:
11778             o = convert(opnum,OPf_SPECIAL*(opnum == OP_GLOB),argop);
11779             if (is_handle_constructor(o, 2))
11780                 argop->op_private |= OPpCOREARGS_DEREF2;
11781             if (opnum == OP_SUBSTR) {
11782                 o->op_private |= OPpMAYBE_LVSUB;
11783                 return o;
11784             }
11785             else goto onearg;
11786         }
11787     }
11788 }
11789
11790 void
11791 Perl_report_redefined_cv(pTHX_ const SV *name, const CV *old_cv,
11792                                SV * const *new_const_svp)
11793 {
11794     const char *hvname;
11795     bool is_const = !!CvCONST(old_cv);
11796     SV *old_const_sv = is_const ? cv_const_sv(old_cv) : NULL;
11797
11798     PERL_ARGS_ASSERT_REPORT_REDEFINED_CV;
11799
11800     if (is_const && new_const_svp && old_const_sv == *new_const_svp)
11801         return;
11802         /* They are 2 constant subroutines generated from
11803            the same constant. This probably means that
11804            they are really the "same" proxy subroutine
11805            instantiated in 2 places. Most likely this is
11806            when a constant is exported twice.  Don't warn.
11807         */
11808     if (
11809         (ckWARN(WARN_REDEFINE)
11810          && !(
11811                 CvGV(old_cv) && GvSTASH(CvGV(old_cv))
11812              && HvNAMELEN(GvSTASH(CvGV(old_cv))) == 7
11813              && (hvname = HvNAME(GvSTASH(CvGV(old_cv))),
11814                  strEQ(hvname, "autouse"))
11815              )
11816         )
11817      || (is_const
11818          && ckWARN_d(WARN_REDEFINE)
11819          && (!new_const_svp || sv_cmp(old_const_sv, *new_const_svp))
11820         )
11821     )
11822         Perl_warner(aTHX_ packWARN(WARN_REDEFINE),
11823                           is_const
11824                             ? "Constant subroutine %"SVf" redefined"
11825                             : "Subroutine %"SVf" redefined",
11826                           name);
11827 }
11828
11829 /*
11830 =head1 Hook manipulation
11831
11832 These functions provide convenient and thread-safe means of manipulating
11833 hook variables.
11834
11835 =cut
11836 */
11837
11838 /*
11839 =for apidoc Am|void|wrap_op_checker|Optype opcode|Perl_check_t new_checker|Perl_check_t *old_checker_p
11840
11841 Puts a C function into the chain of check functions for a specified op
11842 type.  This is the preferred way to manipulate the L</PL_check> array.
11843 I<opcode> specifies which type of op is to be affected.  I<new_checker>
11844 is a pointer to the C function that is to be added to that opcode's
11845 check chain, and I<old_checker_p> points to the storage location where a
11846 pointer to the next function in the chain will be stored.  The value of
11847 I<new_pointer> is written into the L</PL_check> array, while the value
11848 previously stored there is written to I<*old_checker_p>.
11849
11850 L</PL_check> is global to an entire process, and a module wishing to
11851 hook op checking may find itself invoked more than once per process,
11852 typically in different threads.  To handle that situation, this function
11853 is idempotent.  The location I<*old_checker_p> must initially (once
11854 per process) contain a null pointer.  A C variable of static duration
11855 (declared at file scope, typically also marked C<static> to give
11856 it internal linkage) will be implicitly initialised appropriately,
11857 if it does not have an explicit initialiser.  This function will only
11858 actually modify the check chain if it finds I<*old_checker_p> to be null.
11859 This function is also thread safe on the small scale.  It uses appropriate
11860 locking to avoid race conditions in accessing L</PL_check>.
11861
11862 When this function is called, the function referenced by I<new_checker>
11863 must be ready to be called, except for I<*old_checker_p> being unfilled.
11864 In a threading situation, I<new_checker> may be called immediately,
11865 even before this function has returned.  I<*old_checker_p> will always
11866 be appropriately set before I<new_checker> is called.  If I<new_checker>
11867 decides not to do anything special with an op that it is given (which
11868 is the usual case for most uses of op check hooking), it must chain the
11869 check function referenced by I<*old_checker_p>.
11870
11871 If you want to influence compilation of calls to a specific subroutine,
11872 then use L</cv_set_call_checker> rather than hooking checking of all
11873 C<entersub> ops.
11874
11875 =cut
11876 */
11877
11878 void
11879 Perl_wrap_op_checker(pTHX_ Optype opcode,
11880     Perl_check_t new_checker, Perl_check_t *old_checker_p)
11881 {
11882     dVAR;
11883
11884     PERL_ARGS_ASSERT_WRAP_OP_CHECKER;
11885     if (*old_checker_p) return;
11886     OP_CHECK_MUTEX_LOCK;
11887     if (!*old_checker_p) {
11888         *old_checker_p = PL_check[opcode];
11889         PL_check[opcode] = new_checker;
11890     }
11891     OP_CHECK_MUTEX_UNLOCK;
11892 }
11893
11894 #include "XSUB.h"
11895
11896 /* Efficient sub that returns a constant scalar value. */
11897 static void
11898 const_sv_xsub(pTHX_ CV* cv)
11899 {
11900     dVAR;
11901     dXSARGS;
11902     SV *const sv = MUTABLE_SV(XSANY.any_ptr);
11903     if (items != 0) {
11904         NOOP;
11905 #if 0
11906         /* diag_listed_as: SKIPME */
11907         Perl_croak(aTHX_ "usage: %s::%s()",
11908                    HvNAME_get(GvSTASH(CvGV(cv))), GvNAME(CvGV(cv)));
11909 #endif
11910     }
11911     if (!sv) {
11912         XSRETURN(0);
11913     }
11914     EXTEND(sp, 1);
11915     ST(0) = sv;
11916     XSRETURN(1);
11917 }
11918
11919 /*
11920  * Local variables:
11921  * c-indentation-style: bsd
11922  * c-basic-offset: 4
11923  * indent-tabs-mode: nil
11924  * End:
11925  *
11926  * ex: set ts=8 sts=4 sw=4 et:
11927  */