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
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.
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
19 * [p.23 of _The Lord of the Rings_, I/i: "A Long-Expected Party"]
22 /* This file contains the functions that create, manipulate and optimize
23 * the OP structures that hold a compiled perl program.
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
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):
38 * newBINOP(OP_ADD, flags,
40 * newBINOP(OP_MULTIPLY, flags, newSVREF($b), newSVREF($c))
43 * Note that during the build of miniperl, a temporary copy of this file
44 * is made, called opmini.c.
48 Perl's compiler is essentially a 3-pass compiler with interleaved phases:
52 An execution-order pass
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
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.
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.
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.
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.
104 #include "keywords.h"
106 #define CALL_PEEP(o) PL_peepp(aTHX_ o)
107 #define CALL_RPEEP(o) PL_rpeepp(aTHX_ o)
108 #define CALL_OPFREEHOOK(o) if (PL_opfreehook) PL_opfreehook(aTHX_ o)
110 #if defined(PL_OP_SLAB_ALLOC)
112 #ifdef PERL_DEBUG_READONLY_OPS
113 # define PERL_SLAB_SIZE 4096
114 # include <sys/mman.h>
117 #ifndef PERL_SLAB_SIZE
118 #define PERL_SLAB_SIZE 2048
122 Perl_Slab_Alloc(pTHX_ size_t sz)
126 * To make incrementing use count easy PL_OpSlab is an I32 *
127 * To make inserting the link to slab PL_OpPtr is I32 **
128 * So compute size in units of sizeof(I32 *) as that is how Pl_OpPtr increments
129 * Add an overhead for pointer to slab and round up as a number of pointers
131 sz = (sz + 2*sizeof(I32 *) -1)/sizeof(I32 *);
132 if ((PL_OpSpace -= sz) < 0) {
133 #ifdef PERL_DEBUG_READONLY_OPS
134 /* We need to allocate chunk by chunk so that we can control the VM
136 PL_OpPtr = (I32**) mmap(0, PERL_SLAB_SIZE*sizeof(I32*), PROT_READ|PROT_WRITE,
137 MAP_ANON|MAP_PRIVATE, -1, 0);
139 DEBUG_m(PerlIO_printf(Perl_debug_log, "mapped %lu at %p\n",
140 (unsigned long) PERL_SLAB_SIZE*sizeof(I32*),
142 if(PL_OpPtr == MAP_FAILED) {
143 perror("mmap failed");
148 PL_OpPtr = (I32 **) PerlMemShared_calloc(PERL_SLAB_SIZE,sizeof(I32*));
153 /* We reserve the 0'th I32 sized chunk as a use count */
154 PL_OpSlab = (I32 *) PL_OpPtr;
155 /* Reduce size by the use count word, and by the size we need.
156 * Latter is to mimic the '-=' in the if() above
158 PL_OpSpace = PERL_SLAB_SIZE - (sizeof(I32)+sizeof(I32 **)-1)/sizeof(I32 **) - sz;
159 /* Allocation pointer starts at the top.
160 Theory: because we build leaves before trunk allocating at end
161 means that at run time access is cache friendly upward
163 PL_OpPtr += PERL_SLAB_SIZE;
165 #ifdef PERL_DEBUG_READONLY_OPS
166 /* We remember this slab. */
167 /* This implementation isn't efficient, but it is simple. */
168 PL_slabs = (I32**) realloc(PL_slabs, sizeof(I32**) * (PL_slab_count + 1));
169 PL_slabs[PL_slab_count++] = PL_OpSlab;
170 DEBUG_m(PerlIO_printf(Perl_debug_log, "Allocate %p\n", PL_OpSlab));
173 assert( PL_OpSpace >= 0 );
174 /* Move the allocation pointer down */
176 assert( PL_OpPtr > (I32 **) PL_OpSlab );
177 *PL_OpPtr = PL_OpSlab; /* Note which slab it belongs to */
178 (*PL_OpSlab)++; /* Increment use count of slab */
179 assert( PL_OpPtr+sz <= ((I32 **) PL_OpSlab + PERL_SLAB_SIZE) );
180 assert( *PL_OpSlab > 0 );
181 return (void *)(PL_OpPtr + 1);
184 #ifdef PERL_DEBUG_READONLY_OPS
186 Perl_pending_Slabs_to_ro(pTHX) {
187 /* Turn all the allocated op slabs read only. */
188 U32 count = PL_slab_count;
189 I32 **const slabs = PL_slabs;
191 /* Reset the array of pending OP slabs, as we're about to turn this lot
192 read only. Also, do it ahead of the loop in case the warn triggers,
193 and a warn handler has an eval */
198 /* Force a new slab for any further allocation. */
202 void *const start = slabs[count];
203 const size_t size = PERL_SLAB_SIZE* sizeof(I32*);
204 if(mprotect(start, size, PROT_READ)) {
205 Perl_warn(aTHX_ "mprotect for %p %lu failed with %d",
206 start, (unsigned long) size, errno);
214 S_Slab_to_rw(pTHX_ void *op)
216 I32 * const * const ptr = (I32 **) op;
217 I32 * const slab = ptr[-1];
219 PERL_ARGS_ASSERT_SLAB_TO_RW;
221 assert( ptr-1 > (I32 **) slab );
222 assert( ptr < ( (I32 **) slab + PERL_SLAB_SIZE) );
224 if(mprotect(slab, PERL_SLAB_SIZE*sizeof(I32*), PROT_READ|PROT_WRITE)) {
225 Perl_warn(aTHX_ "mprotect RW for %p %lu failed with %d",
226 slab, (unsigned long) PERL_SLAB_SIZE*sizeof(I32*), errno);
231 Perl_op_refcnt_inc(pTHX_ OP *o)
242 Perl_op_refcnt_dec(pTHX_ OP *o)
244 PERL_ARGS_ASSERT_OP_REFCNT_DEC;
249 # define Slab_to_rw(op)
253 Perl_Slab_Free(pTHX_ void *op)
255 I32 * const * const ptr = (I32 **) op;
256 I32 * const slab = ptr[-1];
257 PERL_ARGS_ASSERT_SLAB_FREE;
258 assert( ptr-1 > (I32 **) slab );
259 assert( ptr < ( (I32 **) slab + PERL_SLAB_SIZE) );
262 if (--(*slab) == 0) {
264 # define PerlMemShared PerlMem
267 #ifdef PERL_DEBUG_READONLY_OPS
268 U32 count = PL_slab_count;
269 /* Need to remove this slab from our list of slabs */
272 if (PL_slabs[count] == slab) {
274 /* Found it. Move the entry at the end to overwrite it. */
275 DEBUG_m(PerlIO_printf(Perl_debug_log,
276 "Deallocate %p by moving %p from %lu to %lu\n",
278 PL_slabs[PL_slab_count - 1],
279 PL_slab_count, count));
280 PL_slabs[count] = PL_slabs[--PL_slab_count];
281 /* Could realloc smaller at this point, but probably not
283 if(munmap(slab, PERL_SLAB_SIZE*sizeof(I32*))) {
284 perror("munmap failed");
292 PerlMemShared_free(slab);
294 if (slab == PL_OpSlab) {
301 * In the following definition, the ", (OP*)0" is just to make the compiler
302 * think the expression is of the right type: croak actually does a Siglongjmp.
304 #define CHECKOP(type,o) \
305 ((PL_op_mask && PL_op_mask[type]) \
306 ? ( op_free((OP*)o), \
307 Perl_croak(aTHX_ "'%s' trapped by operation mask", PL_op_desc[type]), \
309 : PL_check[type](aTHX_ (OP*)o))
311 #define RETURN_UNLIMITED_NUMBER (PERL_INT_MAX / 2)
313 #define CHANGE_TYPE(o,type) \
315 o->op_type = (OPCODE)type; \
316 o->op_ppaddr = PL_ppaddr[type]; \
320 S_gv_ename(pTHX_ GV *gv)
322 SV* const tmpsv = sv_newmortal();
324 PERL_ARGS_ASSERT_GV_ENAME;
326 gv_efullname3(tmpsv, gv, NULL);
327 return SvPV_nolen_const(tmpsv);
331 S_no_fh_allowed(pTHX_ OP *o)
333 PERL_ARGS_ASSERT_NO_FH_ALLOWED;
335 yyerror(Perl_form(aTHX_ "Missing comma after first argument to %s function",
341 S_too_few_arguments(pTHX_ OP *o, const char *name)
343 PERL_ARGS_ASSERT_TOO_FEW_ARGUMENTS;
345 yyerror(Perl_form(aTHX_ "Not enough arguments for %s", name));
350 S_too_many_arguments(pTHX_ OP *o, const char *name)
352 PERL_ARGS_ASSERT_TOO_MANY_ARGUMENTS;
354 yyerror(Perl_form(aTHX_ "Too many arguments for %s", name));
359 S_bad_type(pTHX_ I32 n, const char *t, const char *name, const OP *kid)
361 PERL_ARGS_ASSERT_BAD_TYPE;
363 yyerror(Perl_form(aTHX_ "Type of arg %d to %s must be %s (not %s)",
364 (int)n, name, t, OP_DESC(kid)));
368 S_no_bareword_allowed(pTHX_ const OP *o)
370 PERL_ARGS_ASSERT_NO_BAREWORD_ALLOWED;
373 return; /* various ok barewords are hidden in extra OP_NULL */
374 qerror(Perl_mess(aTHX_
375 "Bareword \"%"SVf"\" not allowed while \"strict subs\" in use",
379 /* "register" allocation */
382 Perl_allocmy(pTHX_ const char *const name, const STRLEN len, const U32 flags)
386 const bool is_our = (PL_parser->in_my == KEY_our);
388 PERL_ARGS_ASSERT_ALLOCMY;
391 Perl_croak(aTHX_ "panic: allocmy illegal flag bits 0x%" UVxf,
394 /* Until we're using the length for real, cross check that we're being
396 assert(strlen(name) == len);
398 /* complain about "my $<special_var>" etc etc */
402 (USE_UTF8_IN_NAMES && UTF8_IS_START(name[1])) ||
403 (name[1] == '_' && (*name == '$' || len > 2))))
405 /* name[2] is true if strlen(name) > 2 */
406 if (!isPRINT(name[1]) || strchr("\t\n\r\f", name[1])) {
407 yyerror(Perl_form(aTHX_ "Can't use global %c^%c%.*s in \"%s\"",
408 name[0], toCTRL(name[1]), (int)(len - 2), name + 2,
409 PL_parser->in_my == KEY_state ? "state" : "my"));
411 yyerror(Perl_form(aTHX_ "Can't use global %.*s in \"%s\"", (int) len, name,
412 PL_parser->in_my == KEY_state ? "state" : "my"));
416 /* allocate a spare slot and store the name in that slot */
418 off = pad_add_name(name, len,
419 is_our ? padadd_OUR :
420 PL_parser->in_my == KEY_state ? padadd_STATE : 0,
421 PL_parser->in_my_stash,
423 /* $_ is always in main::, even with our */
424 ? (PL_curstash && !strEQ(name,"$_") ? PL_curstash : PL_defstash)
428 /* anon sub prototypes contains state vars should always be cloned,
429 * otherwise the state var would be shared between anon subs */
431 if (PL_parser->in_my == KEY_state && CvANON(PL_compcv))
432 CvCLONE_on(PL_compcv);
437 /* free the body of an op without examining its contents.
438 * Always use this rather than FreeOp directly */
441 S_op_destroy(pTHX_ OP *o)
443 if (o->op_latefree) {
451 # define forget_pmop(a,b) S_forget_pmop(aTHX_ a,b)
453 # define forget_pmop(a,b) S_forget_pmop(aTHX_ a)
459 Perl_op_free(pTHX_ OP *o)
466 if (o->op_latefreed) {
473 if (o->op_private & OPpREFCOUNTED) {
484 refcnt = OpREFCNT_dec(o);
487 /* Need to find and remove any pattern match ops from the list
488 we maintain for reset(). */
489 find_and_forget_pmops(o);
499 /* Call the op_free hook if it has been set. Do it now so that it's called
500 * at the right time for refcounted ops, but still before all of the kids
504 if (o->op_flags & OPf_KIDS) {
505 register OP *kid, *nextkid;
506 for (kid = cUNOPo->op_first; kid; kid = nextkid) {
507 nextkid = kid->op_sibling; /* Get before next freeing kid */
512 #ifdef PERL_DEBUG_READONLY_OPS
516 /* COP* is not cleared by op_clear() so that we may track line
517 * numbers etc even after null() */
518 if (type == OP_NEXTSTATE || type == OP_DBSTATE
519 || (type == OP_NULL /* the COP might have been null'ed */
520 && ((OPCODE)o->op_targ == OP_NEXTSTATE
521 || (OPCODE)o->op_targ == OP_DBSTATE))) {
526 type = (OPCODE)o->op_targ;
529 if (o->op_latefree) {
535 #ifdef DEBUG_LEAKING_SCALARS
542 Perl_op_clear(pTHX_ OP *o)
547 PERL_ARGS_ASSERT_OP_CLEAR;
550 /* if (o->op_madprop && o->op_madprop->mad_next)
552 /* FIXME for MAD - if I uncomment these two lines t/op/pack.t fails with
553 "modification of a read only value" for a reason I can't fathom why.
554 It's the "" stringification of $_, where $_ was set to '' in a foreach
555 loop, but it defies simplification into a small test case.
556 However, commenting them out has caused ext/List/Util/t/weak.t to fail
559 mad_free(o->op_madprop);
565 switch (o->op_type) {
566 case OP_NULL: /* Was holding old type, if any. */
567 if (PL_madskills && o->op_targ != OP_NULL) {
568 o->op_type = (Optype)o->op_targ;
573 case OP_ENTEREVAL: /* Was holding hints. */
577 if (!(o->op_flags & OPf_REF)
578 || (PL_check[o->op_type] != Perl_ck_ftst))
584 if (! (o->op_type == OP_AELEMFAST && o->op_flags & OPf_SPECIAL)) {
585 /* not an OP_PADAV replacement */
586 GV *gv = (o->op_type == OP_GV || o->op_type == OP_GVSV)
591 /* It's possible during global destruction that the GV is freed
592 before the optree. Whilst the SvREFCNT_inc is happy to bump from
593 0 to 1 on a freed SV, the corresponding SvREFCNT_dec from 1 to 0
594 will trigger an assertion failure, because the entry to sv_clear
595 checks that the scalar is not already freed. A check of for
596 !SvIS_FREED(gv) turns out to be invalid, because during global
597 destruction the reference count can be forced down to zero
598 (with SVf_BREAK set). In which case raising to 1 and then
599 dropping to 0 triggers cleanup before it should happen. I
600 *think* that this might actually be a general, systematic,
601 weakness of the whole idea of SVf_BREAK, in that code *is*
602 allowed to raise and lower references during global destruction,
603 so any *valid* code that happens to do this during global
604 destruction might well trigger premature cleanup. */
605 bool still_valid = gv && SvREFCNT(gv);
608 SvREFCNT_inc_simple_void(gv);
610 if (cPADOPo->op_padix > 0) {
611 /* No GvIN_PAD_off(cGVOPo_gv) here, because other references
612 * may still exist on the pad */
613 pad_swipe(cPADOPo->op_padix, TRUE);
614 cPADOPo->op_padix = 0;
617 SvREFCNT_dec(cSVOPo->op_sv);
618 cSVOPo->op_sv = NULL;
621 int try_downgrade = SvREFCNT(gv) == 2;
624 gv_try_downgrade(gv);
628 case OP_METHOD_NAMED:
631 SvREFCNT_dec(cSVOPo->op_sv);
632 cSVOPo->op_sv = NULL;
635 Even if op_clear does a pad_free for the target of the op,
636 pad_free doesn't actually remove the sv that exists in the pad;
637 instead it lives on. This results in that it could be reused as
638 a target later on when the pad was reallocated.
641 pad_swipe(o->op_targ,1);
650 if (o->op_flags & (OPf_SPECIAL|OPf_STACKED|OPf_KIDS))
655 if (o->op_private & (OPpTRANS_FROM_UTF|OPpTRANS_TO_UTF)) {
657 if (cPADOPo->op_padix > 0) {
658 pad_swipe(cPADOPo->op_padix, TRUE);
659 cPADOPo->op_padix = 0;
662 SvREFCNT_dec(cSVOPo->op_sv);
663 cSVOPo->op_sv = NULL;
667 PerlMemShared_free(cPVOPo->op_pv);
668 cPVOPo->op_pv = NULL;
672 op_free(cPMOPo->op_pmreplrootu.op_pmreplroot);
676 if (cPMOPo->op_pmreplrootu.op_pmtargetoff) {
677 /* No GvIN_PAD_off here, because other references may still
678 * exist on the pad */
679 pad_swipe(cPMOPo->op_pmreplrootu.op_pmtargetoff, TRUE);
682 SvREFCNT_dec(MUTABLE_SV(cPMOPo->op_pmreplrootu.op_pmtargetgv));
688 forget_pmop(cPMOPo, 1);
689 cPMOPo->op_pmreplrootu.op_pmreplroot = NULL;
690 /* we use the same protection as the "SAFE" version of the PM_ macros
691 * here since sv_clean_all might release some PMOPs
692 * after PL_regex_padav has been cleared
693 * and the clearing of PL_regex_padav needs to
694 * happen before sv_clean_all
697 if(PL_regex_pad) { /* We could be in destruction */
698 const IV offset = (cPMOPo)->op_pmoffset;
699 ReREFCNT_dec(PM_GETRE(cPMOPo));
700 PL_regex_pad[offset] = &PL_sv_undef;
701 sv_catpvn_nomg(PL_regex_pad[0], (const char *)&offset,
705 ReREFCNT_dec(PM_GETRE(cPMOPo));
706 PM_SETRE(cPMOPo, NULL);
712 if (o->op_targ > 0) {
713 pad_free(o->op_targ);
719 S_cop_free(pTHX_ COP* cop)
721 PERL_ARGS_ASSERT_COP_FREE;
725 if (! specialWARN(cop->cop_warnings))
726 PerlMemShared_free(cop->cop_warnings);
727 cophh_free(CopHINTHASH_get(cop));
731 S_forget_pmop(pTHX_ PMOP *const o
737 HV * const pmstash = PmopSTASH(o);
739 PERL_ARGS_ASSERT_FORGET_PMOP;
741 if (pmstash && !SvIS_FREED(pmstash)) {
742 MAGIC * const mg = mg_find((const SV *)pmstash, PERL_MAGIC_symtab);
744 PMOP **const array = (PMOP**) mg->mg_ptr;
745 U32 count = mg->mg_len / sizeof(PMOP**);
750 /* Found it. Move the entry at the end to overwrite it. */
751 array[i] = array[--count];
752 mg->mg_len = count * sizeof(PMOP**);
753 /* Could realloc smaller at this point always, but probably
754 not worth it. Probably worth free()ing if we're the
757 Safefree(mg->mg_ptr);
774 S_find_and_forget_pmops(pTHX_ OP *o)
776 PERL_ARGS_ASSERT_FIND_AND_FORGET_PMOPS;
778 if (o->op_flags & OPf_KIDS) {
779 OP *kid = cUNOPo->op_first;
781 switch (kid->op_type) {
786 forget_pmop((PMOP*)kid, 0);
788 find_and_forget_pmops(kid);
789 kid = kid->op_sibling;
795 Perl_op_null(pTHX_ OP *o)
799 PERL_ARGS_ASSERT_OP_NULL;
801 if (o->op_type == OP_NULL)
805 o->op_targ = o->op_type;
806 o->op_type = OP_NULL;
807 o->op_ppaddr = PL_ppaddr[OP_NULL];
811 Perl_op_refcnt_lock(pTHX)
819 Perl_op_refcnt_unlock(pTHX)
826 /* Contextualizers */
829 =for apidoc Am|OP *|op_contextualize|OP *o|I32 context
831 Applies a syntactic context to an op tree representing an expression.
832 I<o> is the op tree, and I<context> must be C<G_SCALAR>, C<G_ARRAY>,
833 or C<G_VOID> to specify the context to apply. The modified op tree
840 Perl_op_contextualize(pTHX_ OP *o, I32 context)
842 PERL_ARGS_ASSERT_OP_CONTEXTUALIZE;
844 case G_SCALAR: return scalar(o);
845 case G_ARRAY: return list(o);
846 case G_VOID: return scalarvoid(o);
848 Perl_croak(aTHX_ "panic: op_contextualize bad context");
854 =head1 Optree Manipulation Functions
856 =for apidoc Am|OP*|op_linklist|OP *o
857 This function is the implementation of the L</LINKLIST> macro. It should
858 not be called directly.
864 Perl_op_linklist(pTHX_ OP *o)
868 PERL_ARGS_ASSERT_OP_LINKLIST;
873 /* establish postfix order */
874 first = cUNOPo->op_first;
877 o->op_next = LINKLIST(first);
880 if (kid->op_sibling) {
881 kid->op_next = LINKLIST(kid->op_sibling);
882 kid = kid->op_sibling;
896 S_scalarkids(pTHX_ OP *o)
898 if (o && o->op_flags & OPf_KIDS) {
900 for (kid = cLISTOPo->op_first; kid; kid = kid->op_sibling)
907 S_scalarboolean(pTHX_ OP *o)
911 PERL_ARGS_ASSERT_SCALARBOOLEAN;
913 if (o->op_type == OP_SASSIGN && cBINOPo->op_first->op_type == OP_CONST
914 && !(cBINOPo->op_first->op_flags & OPf_SPECIAL)) {
915 if (ckWARN(WARN_SYNTAX)) {
916 const line_t oldline = CopLINE(PL_curcop);
918 if (PL_parser && PL_parser->copline != NOLINE)
919 CopLINE_set(PL_curcop, PL_parser->copline);
920 Perl_warner(aTHX_ packWARN(WARN_SYNTAX), "Found = in conditional, should be ==");
921 CopLINE_set(PL_curcop, oldline);
928 Perl_scalar(pTHX_ OP *o)
933 /* assumes no premature commitment */
934 if (!o || (PL_parser && PL_parser->error_count)
935 || (o->op_flags & OPf_WANT)
936 || o->op_type == OP_RETURN)
941 o->op_flags = (o->op_flags & ~OPf_WANT) | OPf_WANT_SCALAR;
943 switch (o->op_type) {
945 scalar(cBINOPo->op_first);
950 for (kid = cUNOPo->op_first->op_sibling; kid; kid = kid->op_sibling)
960 if (o->op_flags & OPf_KIDS) {
961 for (kid = cUNOPo->op_first; kid; kid = kid->op_sibling)
967 kid = cLISTOPo->op_first;
969 kid = kid->op_sibling;
972 OP *sib = kid->op_sibling;
973 if (sib && kid->op_type != OP_LEAVEWHEN) {
974 if (sib->op_type == OP_BREAK && sib->op_flags & OPf_SPECIAL) {
984 PL_curcop = &PL_compiling;
989 kid = cLISTOPo->op_first;
992 Perl_ck_warner(aTHX_ packWARN(WARN_VOID), "Useless use of sort in scalar context");
999 Perl_scalarvoid(pTHX_ OP *o)
1003 const char* useless = NULL;
1007 PERL_ARGS_ASSERT_SCALARVOID;
1009 /* trailing mad null ops don't count as "there" for void processing */
1011 o->op_type != OP_NULL &&
1013 o->op_sibling->op_type == OP_NULL)
1016 for (sib = o->op_sibling;
1017 sib && sib->op_type == OP_NULL;
1018 sib = sib->op_sibling) ;
1024 if (o->op_type == OP_NEXTSTATE
1025 || o->op_type == OP_DBSTATE
1026 || (o->op_type == OP_NULL && (o->op_targ == OP_NEXTSTATE
1027 || o->op_targ == OP_DBSTATE)))
1028 PL_curcop = (COP*)o; /* for warning below */
1030 /* assumes no premature commitment */
1031 want = o->op_flags & OPf_WANT;
1032 if ((want && want != OPf_WANT_SCALAR)
1033 || (PL_parser && PL_parser->error_count)
1034 || o->op_type == OP_RETURN || o->op_type == OP_REQUIRE || o->op_type == OP_LEAVEWHEN)
1039 if ((o->op_private & OPpTARGET_MY)
1040 && (PL_opargs[o->op_type] & OA_TARGLEX))/* OPp share the meaning */
1042 return scalar(o); /* As if inside SASSIGN */
1045 o->op_flags = (o->op_flags & ~OPf_WANT) | OPf_WANT_VOID;
1047 switch (o->op_type) {
1049 if (!(PL_opargs[o->op_type] & OA_FOLDCONST))
1053 if (o->op_flags & OPf_STACKED)
1057 if (o->op_private == 4)
1100 case OP_GETSOCKNAME:
1101 case OP_GETPEERNAME:
1106 case OP_GETPRIORITY:
1130 if (!(o->op_private & (OPpLVAL_INTRO|OPpOUR_INTRO)))
1131 /* Otherwise it's "Useless use of grep iterator" */
1132 useless = OP_DESC(o);
1136 kid = cLISTOPo->op_first;
1137 if (kid && kid->op_type == OP_PUSHRE
1139 && !((PMOP*)kid)->op_pmreplrootu.op_pmtargetoff)
1141 && !((PMOP*)kid)->op_pmreplrootu.op_pmtargetgv)
1143 useless = OP_DESC(o);
1147 kid = cUNOPo->op_first;
1148 if (kid->op_type != OP_MATCH && kid->op_type != OP_SUBST &&
1149 kid->op_type != OP_TRANS && kid->op_type != OP_TRANSR) {
1152 useless = "negative pattern binding (!~)";
1156 if (cPMOPo->op_pmflags & PMf_NONDESTRUCT)
1157 useless = "non-destructive substitution (s///r)";
1161 useless = "non-destructive transliteration (tr///r)";
1168 if (!(o->op_private & (OPpLVAL_INTRO|OPpOUR_INTRO)) &&
1169 (!o->op_sibling || o->op_sibling->op_type != OP_READLINE))
1170 useless = "a variable";
1175 if (cSVOPo->op_private & OPpCONST_STRICT)
1176 no_bareword_allowed(o);
1178 if (ckWARN(WARN_VOID)) {
1180 SV* msv = sv_2mortal(Perl_newSVpvf(aTHX_
1181 "a constant (%"SVf")", sv));
1182 useless = SvPV_nolen(msv);
1185 useless = "a constant (undef)";
1186 if (o->op_private & OPpCONST_ARYBASE)
1188 /* don't warn on optimised away booleans, eg
1189 * use constant Foo, 5; Foo || print; */
1190 if (cSVOPo->op_private & OPpCONST_SHORTCIRCUIT)
1192 /* the constants 0 and 1 are permitted as they are
1193 conventionally used as dummies in constructs like
1194 1 while some_condition_with_side_effects; */
1195 else if (SvNIOK(sv) && (SvNV(sv) == 0.0 || SvNV(sv) == 1.0))
1197 else if (SvPOK(sv)) {
1198 /* perl4's way of mixing documentation and code
1199 (before the invention of POD) was based on a
1200 trick to mix nroff and perl code. The trick was
1201 built upon these three nroff macros being used in
1202 void context. The pink camel has the details in
1203 the script wrapman near page 319. */
1204 const char * const maybe_macro = SvPVX_const(sv);
1205 if (strnEQ(maybe_macro, "di", 2) ||
1206 strnEQ(maybe_macro, "ds", 2) ||
1207 strnEQ(maybe_macro, "ig", 2))
1212 op_null(o); /* don't execute or even remember it */
1216 o->op_type = OP_PREINC; /* pre-increment is faster */
1217 o->op_ppaddr = PL_ppaddr[OP_PREINC];
1221 o->op_type = OP_PREDEC; /* pre-decrement is faster */
1222 o->op_ppaddr = PL_ppaddr[OP_PREDEC];
1226 o->op_type = OP_I_PREINC; /* pre-increment is faster */
1227 o->op_ppaddr = PL_ppaddr[OP_I_PREINC];
1231 o->op_type = OP_I_PREDEC; /* pre-decrement is faster */
1232 o->op_ppaddr = PL_ppaddr[OP_I_PREDEC];
1237 kid = cLOGOPo->op_first;
1238 if (kid->op_type == OP_NOT
1239 && (kid->op_flags & OPf_KIDS)
1241 if (o->op_type == OP_AND) {
1243 o->op_ppaddr = PL_ppaddr[OP_OR];
1245 o->op_type = OP_AND;
1246 o->op_ppaddr = PL_ppaddr[OP_AND];
1255 for (kid = cUNOPo->op_first->op_sibling; kid; kid = kid->op_sibling)
1260 if (o->op_flags & OPf_STACKED)
1267 if (!(o->op_flags & OPf_KIDS))
1278 for (kid = cLISTOPo->op_first; kid; kid = kid->op_sibling)
1288 Perl_ck_warner(aTHX_ packWARN(WARN_VOID), "Useless use of %s in void context", useless);
1293 S_listkids(pTHX_ OP *o)
1295 if (o && o->op_flags & OPf_KIDS) {
1297 for (kid = cLISTOPo->op_first; kid; kid = kid->op_sibling)
1304 Perl_list(pTHX_ OP *o)
1309 /* assumes no premature commitment */
1310 if (!o || (o->op_flags & OPf_WANT)
1311 || (PL_parser && PL_parser->error_count)
1312 || o->op_type == OP_RETURN)
1317 if ((o->op_private & OPpTARGET_MY)
1318 && (PL_opargs[o->op_type] & OA_TARGLEX))/* OPp share the meaning */
1320 return o; /* As if inside SASSIGN */
1323 o->op_flags = (o->op_flags & ~OPf_WANT) | OPf_WANT_LIST;
1325 switch (o->op_type) {
1328 list(cBINOPo->op_first);
1333 for (kid = cUNOPo->op_first->op_sibling; kid; kid = kid->op_sibling)
1341 if (!(o->op_flags & OPf_KIDS))
1343 if (!o->op_next && cUNOPo->op_first->op_type == OP_FLOP) {
1344 list(cBINOPo->op_first);
1345 return gen_constant_list(o);
1352 kid = cLISTOPo->op_first;
1354 kid = kid->op_sibling;
1357 OP *sib = kid->op_sibling;
1358 if (sib && kid->op_type != OP_LEAVEWHEN) {
1359 if (sib->op_type == OP_BREAK && sib->op_flags & OPf_SPECIAL) {
1369 PL_curcop = &PL_compiling;
1373 kid = cLISTOPo->op_first;
1380 S_scalarseq(pTHX_ OP *o)
1384 const OPCODE type = o->op_type;
1386 if (type == OP_LINESEQ || type == OP_SCOPE ||
1387 type == OP_LEAVE || type == OP_LEAVETRY)
1390 for (kid = cLISTOPo->op_first; kid; kid = kid->op_sibling) {
1391 if (kid->op_sibling) {
1395 PL_curcop = &PL_compiling;
1397 o->op_flags &= ~OPf_PARENS;
1398 if (PL_hints & HINT_BLOCK_SCOPE)
1399 o->op_flags |= OPf_PARENS;
1402 o = newOP(OP_STUB, 0);
1407 S_modkids(pTHX_ OP *o, I32 type)
1409 if (o && o->op_flags & OPf_KIDS) {
1411 for (kid = cLISTOPo->op_first; kid; kid = kid->op_sibling)
1412 op_lvalue(kid, type);
1418 =for apidoc Amx|OP *|op_lvalue|OP *o|I32 type
1420 Propagate lvalue ("modifiable") context to an op and its children.
1421 I<type> represents the context type, roughly based on the type of op that
1422 would do the modifying, although C<local()> is represented by OP_NULL,
1423 because it has no op type of its own (it is signalled by a flag on
1426 This function detects things that can't be modified, such as C<$x+1>, and
1427 generates errors for them. For example, C<$x+1 = 2> would cause it to be
1428 called with an op of type OP_ADD and a C<type> argument of OP_SASSIGN.
1430 It also flags things that need to behave specially in an lvalue context,
1431 such as C<$$x = 5> which might have to vivify a reference in C<$x>.
1437 Perl_op_lvalue(pTHX_ OP *o, I32 type)
1441 /* -1 = error on localize, 0 = ignore localize, 1 = ok to localize */
1444 if (!o || (PL_parser && PL_parser->error_count))
1447 if ((o->op_private & OPpTARGET_MY)
1448 && (PL_opargs[o->op_type] & OA_TARGLEX))/* OPp share the meaning */
1453 switch (o->op_type) {
1459 if (!(o->op_private & OPpCONST_ARYBASE))
1462 if (PL_eval_start && PL_eval_start->op_type == OP_CONST) {
1463 CopARYBASE_set(&PL_compiling,
1464 (I32)SvIV(cSVOPx(PL_eval_start)->op_sv));
1468 SAVECOPARYBASE(&PL_compiling);
1469 CopARYBASE_set(&PL_compiling, 0);
1471 else if (type == OP_REFGEN)
1474 Perl_croak(aTHX_ "That use of $[ is unsupported");
1477 if ((o->op_flags & OPf_PARENS) || PL_madskills)
1481 if ((type == OP_UNDEF || type == OP_REFGEN) &&
1482 !(o->op_flags & OPf_STACKED)) {
1483 o->op_type = OP_RV2CV; /* entersub => rv2cv */
1484 /* The default is to set op_private to the number of children,
1485 which for a UNOP such as RV2CV is always 1. And w're using
1486 the bit for a flag in RV2CV, so we need it clear. */
1487 o->op_private &= ~1;
1488 o->op_ppaddr = PL_ppaddr[OP_RV2CV];
1489 assert(cUNOPo->op_first->op_type == OP_NULL);
1490 op_null(((LISTOP*)cUNOPo->op_first)->op_first);/* disable pushmark */
1493 else if (o->op_private & OPpENTERSUB_NOMOD)
1495 else { /* lvalue subroutine call */
1496 o->op_private |= OPpLVAL_INTRO;
1497 PL_modcount = RETURN_UNLIMITED_NUMBER;
1498 if (type == OP_GREPSTART || type == OP_ENTERSUB || type == OP_REFGEN) {
1499 /* Backward compatibility mode: */
1500 o->op_private |= OPpENTERSUB_INARGS;
1503 else { /* Compile-time error message: */
1504 OP *kid = cUNOPo->op_first;
1508 if (kid->op_type != OP_PUSHMARK) {
1509 if (kid->op_type != OP_NULL || kid->op_targ != OP_LIST)
1511 "panic: unexpected lvalue entersub "
1512 "args: type/targ %ld:%"UVuf,
1513 (long)kid->op_type, (UV)kid->op_targ);
1514 kid = kLISTOP->op_first;
1516 while (kid->op_sibling)
1517 kid = kid->op_sibling;
1518 if (!(kid->op_type == OP_NULL && kid->op_targ == OP_RV2CV)) {
1520 if (kid->op_type == OP_METHOD_NAMED
1521 || kid->op_type == OP_METHOD)
1525 NewOp(1101, newop, 1, UNOP);
1526 newop->op_type = OP_RV2CV;
1527 newop->op_ppaddr = PL_ppaddr[OP_RV2CV];
1528 newop->op_first = NULL;
1529 newop->op_next = (OP*)newop;
1530 kid->op_sibling = (OP*)newop;
1531 newop->op_private |= OPpLVAL_INTRO;
1532 newop->op_private &= ~1;
1536 if (kid->op_type != OP_RV2CV)
1538 "panic: unexpected lvalue entersub "
1539 "entry via type/targ %ld:%"UVuf,
1540 (long)kid->op_type, (UV)kid->op_targ);
1541 kid->op_private |= OPpLVAL_INTRO;
1542 break; /* Postpone until runtime */
1546 kid = kUNOP->op_first;
1547 if (kid->op_type == OP_NULL && kid->op_targ == OP_RV2SV)
1548 kid = kUNOP->op_first;
1549 if (kid->op_type == OP_NULL)
1551 "Unexpected constant lvalue entersub "
1552 "entry via type/targ %ld:%"UVuf,
1553 (long)kid->op_type, (UV)kid->op_targ);
1554 if (kid->op_type != OP_GV) {
1555 /* Restore RV2CV to check lvalueness */
1557 if (kid->op_next && kid->op_next != kid) { /* Happens? */
1558 okid->op_next = kid->op_next;
1559 kid->op_next = okid;
1562 okid->op_next = NULL;
1563 okid->op_type = OP_RV2CV;
1565 okid->op_ppaddr = PL_ppaddr[OP_RV2CV];
1566 okid->op_private |= OPpLVAL_INTRO;
1567 okid->op_private &= ~1;
1571 cv = GvCV(kGVOP_gv);
1581 /* grep, foreach, subcalls, refgen */
1582 if (type == OP_GREPSTART || type == OP_ENTERSUB || type == OP_REFGEN)
1584 yyerror(Perl_form(aTHX_ "Can't modify %s in %s",
1585 (o->op_type == OP_NULL && (o->op_flags & OPf_SPECIAL)
1587 : (o->op_type == OP_ENTERSUB
1588 ? "non-lvalue subroutine call"
1590 type ? PL_op_desc[type] : "local"));
1604 case OP_RIGHT_SHIFT:
1613 if (!(o->op_flags & OPf_STACKED))
1620 for (kid = cUNOPo->op_first->op_sibling; kid; kid = kid->op_sibling)
1621 op_lvalue(kid, type);
1626 if (type == OP_REFGEN && o->op_flags & OPf_PARENS) {
1627 PL_modcount = RETURN_UNLIMITED_NUMBER;
1628 return o; /* Treat \(@foo) like ordinary list. */
1632 if (scalar_mod_type(o, type))
1634 ref(cUNOPo->op_first, o->op_type);
1638 if (type == OP_LEAVESUBLV)
1639 o->op_private |= OPpMAYBE_LVSUB;
1645 PL_modcount = RETURN_UNLIMITED_NUMBER;
1648 PL_hints |= HINT_BLOCK_SCOPE;
1649 if (type == OP_LEAVESUBLV)
1650 o->op_private |= OPpMAYBE_LVSUB;
1654 ref(cUNOPo->op_first, o->op_type);
1658 PL_hints |= HINT_BLOCK_SCOPE;
1673 PL_modcount = RETURN_UNLIMITED_NUMBER;
1674 if (type == OP_REFGEN && o->op_flags & OPf_PARENS)
1675 return o; /* Treat \(@foo) like ordinary list. */
1676 if (scalar_mod_type(o, type))
1678 if (type == OP_LEAVESUBLV)
1679 o->op_private |= OPpMAYBE_LVSUB;
1683 if (!type) /* local() */
1684 Perl_croak(aTHX_ "Can't localize lexical variable %s",
1685 PAD_COMPNAME_PV(o->op_targ));
1693 if (type != OP_SASSIGN)
1697 if (o->op_private == 4) /* don't allow 4 arg substr as lvalue */
1702 if (type == OP_LEAVESUBLV)
1703 o->op_private |= OPpMAYBE_LVSUB;
1705 pad_free(o->op_targ);
1706 o->op_targ = pad_alloc(o->op_type, SVs_PADMY);
1707 assert(SvTYPE(PAD_SV(o->op_targ)) == SVt_NULL);
1708 if (o->op_flags & OPf_KIDS)
1709 op_lvalue(cBINOPo->op_first->op_sibling, type);
1714 ref(cBINOPo->op_first, o->op_type);
1715 if (type == OP_ENTERSUB &&
1716 !(o->op_private & (OPpLVAL_INTRO | OPpDEREF)))
1717 o->op_private |= OPpLVAL_DEFER;
1718 if (type == OP_LEAVESUBLV)
1719 o->op_private |= OPpMAYBE_LVSUB;
1729 if (o->op_flags & OPf_KIDS)
1730 op_lvalue(cLISTOPo->op_last, type);
1735 if (o->op_flags & OPf_SPECIAL) /* do BLOCK */
1737 else if (!(o->op_flags & OPf_KIDS))
1739 if (o->op_targ != OP_LIST) {
1740 op_lvalue(cBINOPo->op_first, type);
1746 for (kid = cLISTOPo->op_first; kid; kid = kid->op_sibling)
1747 op_lvalue(kid, type);
1751 if (type != OP_LEAVESUBLV)
1753 break; /* op_lvalue()ing was handled by ck_return() */
1756 /* [20011101.069] File test operators interpret OPf_REF to mean that
1757 their argument is a filehandle; thus \stat(".") should not set
1759 if (type == OP_REFGEN &&
1760 PL_check[o->op_type] == Perl_ck_ftst)
1763 if (type != OP_LEAVESUBLV)
1764 o->op_flags |= OPf_MOD;
1766 if (type == OP_AASSIGN || type == OP_SASSIGN)
1767 o->op_flags |= OPf_SPECIAL|OPf_REF;
1768 else if (!type) { /* local() */
1771 o->op_private |= OPpLVAL_INTRO;
1772 o->op_flags &= ~OPf_SPECIAL;
1773 PL_hints |= HINT_BLOCK_SCOPE;
1778 Perl_ck_warner(aTHX_ packWARN(WARN_SYNTAX),
1779 "Useless localization of %s", OP_DESC(o));
1782 else if (type != OP_GREPSTART && type != OP_ENTERSUB
1783 && type != OP_LEAVESUBLV)
1784 o->op_flags |= OPf_REF;
1788 /* Do not use this. It will be removed after 5.14. */
1790 Perl_mod(pTHX_ OP *o, I32 type)
1792 return op_lvalue(o,type);
1797 S_scalar_mod_type(const OP *o, I32 type)
1799 PERL_ARGS_ASSERT_SCALAR_MOD_TYPE;
1803 if (o->op_type == OP_RV2GV)
1827 case OP_RIGHT_SHIFT:
1848 S_is_handle_constructor(const OP *o, I32 numargs)
1850 PERL_ARGS_ASSERT_IS_HANDLE_CONSTRUCTOR;
1852 switch (o->op_type) {
1860 case OP_SELECT: /* XXX c.f. SelectSaver.pm */
1873 S_refkids(pTHX_ OP *o, I32 type)
1875 if (o && o->op_flags & OPf_KIDS) {
1877 for (kid = cLISTOPo->op_first; kid; kid = kid->op_sibling)
1884 Perl_doref(pTHX_ OP *o, I32 type, bool set_op_ref)
1889 PERL_ARGS_ASSERT_DOREF;
1891 if (!o || (PL_parser && PL_parser->error_count))
1894 switch (o->op_type) {
1896 if ((type == OP_EXISTS || type == OP_DEFINED || type == OP_LOCK) &&
1897 !(o->op_flags & OPf_STACKED)) {
1898 o->op_type = OP_RV2CV; /* entersub => rv2cv */
1899 o->op_ppaddr = PL_ppaddr[OP_RV2CV];
1900 assert(cUNOPo->op_first->op_type == OP_NULL);
1901 op_null(((LISTOP*)cUNOPo->op_first)->op_first); /* disable pushmark */
1902 o->op_flags |= OPf_SPECIAL;
1903 o->op_private &= ~1;
1908 for (kid = cUNOPo->op_first->op_sibling; kid; kid = kid->op_sibling)
1909 doref(kid, type, set_op_ref);
1912 if (type == OP_DEFINED)
1913 o->op_flags |= OPf_SPECIAL; /* don't create GV */
1914 doref(cUNOPo->op_first, o->op_type, set_op_ref);
1917 if (type == OP_RV2SV || type == OP_RV2AV || type == OP_RV2HV) {
1918 o->op_private |= (type == OP_RV2AV ? OPpDEREF_AV
1919 : type == OP_RV2HV ? OPpDEREF_HV
1921 o->op_flags |= OPf_MOD;
1928 o->op_flags |= OPf_REF;
1931 if (type == OP_DEFINED)
1932 o->op_flags |= OPf_SPECIAL; /* don't create GV */
1933 doref(cUNOPo->op_first, o->op_type, set_op_ref);
1939 o->op_flags |= OPf_REF;
1944 if (!(o->op_flags & OPf_KIDS))
1946 doref(cBINOPo->op_first, type, set_op_ref);
1950 doref(cBINOPo->op_first, o->op_type, set_op_ref);
1951 if (type == OP_RV2SV || type == OP_RV2AV || type == OP_RV2HV) {
1952 o->op_private |= (type == OP_RV2AV ? OPpDEREF_AV
1953 : type == OP_RV2HV ? OPpDEREF_HV
1955 o->op_flags |= OPf_MOD;
1965 if (!(o->op_flags & OPf_KIDS))
1967 doref(cLISTOPo->op_last, type, set_op_ref);
1977 S_dup_attrlist(pTHX_ OP *o)
1982 PERL_ARGS_ASSERT_DUP_ATTRLIST;
1984 /* An attrlist is either a simple OP_CONST or an OP_LIST with kids,
1985 * where the first kid is OP_PUSHMARK and the remaining ones
1986 * are OP_CONST. We need to push the OP_CONST values.
1988 if (o->op_type == OP_CONST)
1989 rop = newSVOP(OP_CONST, o->op_flags, SvREFCNT_inc_NN(cSVOPo->op_sv));
1991 else if (o->op_type == OP_NULL)
1995 assert((o->op_type == OP_LIST) && (o->op_flags & OPf_KIDS));
1997 for (o = cLISTOPo->op_first; o; o=o->op_sibling) {
1998 if (o->op_type == OP_CONST)
1999 rop = op_append_elem(OP_LIST, rop,
2000 newSVOP(OP_CONST, o->op_flags,
2001 SvREFCNT_inc_NN(cSVOPo->op_sv)));
2008 S_apply_attrs(pTHX_ HV *stash, SV *target, OP *attrs, bool for_my)
2013 PERL_ARGS_ASSERT_APPLY_ATTRS;
2015 /* fake up C<use attributes $pkg,$rv,@attrs> */
2016 ENTER; /* need to protect against side-effects of 'use' */
2017 stashsv = stash ? newSVhek(HvNAME_HEK(stash)) : &PL_sv_no;
2019 #define ATTRSMODULE "attributes"
2020 #define ATTRSMODULE_PM "attributes.pm"
2023 /* Don't force the C<use> if we don't need it. */
2024 SV * const * const svp = hv_fetchs(GvHVn(PL_incgv), ATTRSMODULE_PM, FALSE);
2025 if (svp && *svp != &PL_sv_undef)
2026 NOOP; /* already in %INC */
2028 Perl_load_module(aTHX_ PERL_LOADMOD_NOIMPORT,
2029 newSVpvs(ATTRSMODULE), NULL);
2032 Perl_load_module(aTHX_ PERL_LOADMOD_IMPORT_OPS,
2033 newSVpvs(ATTRSMODULE),
2035 op_prepend_elem(OP_LIST,
2036 newSVOP(OP_CONST, 0, stashsv),
2037 op_prepend_elem(OP_LIST,
2038 newSVOP(OP_CONST, 0,
2040 dup_attrlist(attrs))));
2046 S_apply_attrs_my(pTHX_ HV *stash, OP *target, OP *attrs, OP **imopsp)
2049 OP *pack, *imop, *arg;
2052 PERL_ARGS_ASSERT_APPLY_ATTRS_MY;
2057 assert(target->op_type == OP_PADSV ||
2058 target->op_type == OP_PADHV ||
2059 target->op_type == OP_PADAV);
2061 /* Ensure that attributes.pm is loaded. */
2062 apply_attrs(stash, PAD_SV(target->op_targ), attrs, TRUE);
2064 /* Need package name for method call. */
2065 pack = newSVOP(OP_CONST, 0, newSVpvs(ATTRSMODULE));
2067 /* Build up the real arg-list. */
2068 stashsv = stash ? newSVhek(HvNAME_HEK(stash)) : &PL_sv_no;
2070 arg = newOP(OP_PADSV, 0);
2071 arg->op_targ = target->op_targ;
2072 arg = op_prepend_elem(OP_LIST,
2073 newSVOP(OP_CONST, 0, stashsv),
2074 op_prepend_elem(OP_LIST,
2075 newUNOP(OP_REFGEN, 0,
2076 op_lvalue(arg, OP_REFGEN)),
2077 dup_attrlist(attrs)));
2079 /* Fake up a method call to import */
2080 meth = newSVpvs_share("import");
2081 imop = convert(OP_ENTERSUB, OPf_STACKED|OPf_SPECIAL|OPf_WANT_VOID,
2082 op_append_elem(OP_LIST,
2083 op_prepend_elem(OP_LIST, pack, list(arg)),
2084 newSVOP(OP_METHOD_NAMED, 0, meth)));
2085 imop->op_private |= OPpENTERSUB_NOMOD;
2087 /* Combine the ops. */
2088 *imopsp = op_append_elem(OP_LIST, *imopsp, imop);
2092 =notfor apidoc apply_attrs_string
2094 Attempts to apply a list of attributes specified by the C<attrstr> and
2095 C<len> arguments to the subroutine identified by the C<cv> argument which
2096 is expected to be associated with the package identified by the C<stashpv>
2097 argument (see L<attributes>). It gets this wrong, though, in that it
2098 does not correctly identify the boundaries of the individual attribute
2099 specifications within C<attrstr>. This is not really intended for the
2100 public API, but has to be listed here for systems such as AIX which
2101 need an explicit export list for symbols. (It's called from XS code
2102 in support of the C<ATTRS:> keyword from F<xsubpp>.) Patches to fix it
2103 to respect attribute syntax properly would be welcome.
2109 Perl_apply_attrs_string(pTHX_ const char *stashpv, CV *cv,
2110 const char *attrstr, STRLEN len)
2114 PERL_ARGS_ASSERT_APPLY_ATTRS_STRING;
2117 len = strlen(attrstr);
2121 for (; isSPACE(*attrstr) && len; --len, ++attrstr) ;
2123 const char * const sstr = attrstr;
2124 for (; !isSPACE(*attrstr) && len; --len, ++attrstr) ;
2125 attrs = op_append_elem(OP_LIST, attrs,
2126 newSVOP(OP_CONST, 0,
2127 newSVpvn(sstr, attrstr-sstr)));
2131 Perl_load_module(aTHX_ PERL_LOADMOD_IMPORT_OPS,
2132 newSVpvs(ATTRSMODULE),
2133 NULL, op_prepend_elem(OP_LIST,
2134 newSVOP(OP_CONST, 0, newSVpv(stashpv,0)),
2135 op_prepend_elem(OP_LIST,
2136 newSVOP(OP_CONST, 0,
2137 newRV(MUTABLE_SV(cv))),
2142 S_my_kid(pTHX_ OP *o, OP *attrs, OP **imopsp)
2146 const bool stately = PL_parser && PL_parser->in_my == KEY_state;
2148 PERL_ARGS_ASSERT_MY_KID;
2150 if (!o || (PL_parser && PL_parser->error_count))
2154 if (PL_madskills && type == OP_NULL && o->op_flags & OPf_KIDS) {
2155 (void)my_kid(cUNOPo->op_first, attrs, imopsp);
2159 if (type == OP_LIST) {
2161 for (kid = cLISTOPo->op_first; kid; kid = kid->op_sibling)
2162 my_kid(kid, attrs, imopsp);
2163 } else if (type == OP_UNDEF
2169 } else if (type == OP_RV2SV || /* "our" declaration */
2171 type == OP_RV2HV) { /* XXX does this let anything illegal in? */
2172 if (cUNOPo->op_first->op_type != OP_GV) { /* MJD 20011224 */
2173 yyerror(Perl_form(aTHX_ "Can't declare %s in \"%s\"",
2175 PL_parser->in_my == KEY_our
2177 : PL_parser->in_my == KEY_state ? "state" : "my"));
2179 GV * const gv = cGVOPx_gv(cUNOPo->op_first);
2180 PL_parser->in_my = FALSE;
2181 PL_parser->in_my_stash = NULL;
2182 apply_attrs(GvSTASH(gv),
2183 (type == OP_RV2SV ? GvSV(gv) :
2184 type == OP_RV2AV ? MUTABLE_SV(GvAV(gv)) :
2185 type == OP_RV2HV ? MUTABLE_SV(GvHV(gv)) : MUTABLE_SV(gv)),
2188 o->op_private |= OPpOUR_INTRO;
2191 else if (type != OP_PADSV &&
2194 type != OP_PUSHMARK)
2196 yyerror(Perl_form(aTHX_ "Can't declare %s in \"%s\"",
2198 PL_parser->in_my == KEY_our
2200 : PL_parser->in_my == KEY_state ? "state" : "my"));
2203 else if (attrs && type != OP_PUSHMARK) {
2206 PL_parser->in_my = FALSE;
2207 PL_parser->in_my_stash = NULL;
2209 /* check for C<my Dog $spot> when deciding package */
2210 stash = PAD_COMPNAME_TYPE(o->op_targ);
2212 stash = PL_curstash;
2213 apply_attrs_my(stash, o, attrs, imopsp);
2215 o->op_flags |= OPf_MOD;
2216 o->op_private |= OPpLVAL_INTRO;
2218 o->op_private |= OPpPAD_STATE;
2223 Perl_my_attrs(pTHX_ OP *o, OP *attrs)
2227 int maybe_scalar = 0;
2229 PERL_ARGS_ASSERT_MY_ATTRS;
2231 /* [perl #17376]: this appears to be premature, and results in code such as
2232 C< our(%x); > executing in list mode rather than void mode */
2234 if (o->op_flags & OPf_PARENS)
2244 o = my_kid(o, attrs, &rops);
2246 if (maybe_scalar && o->op_type == OP_PADSV) {
2247 o = scalar(op_append_list(OP_LIST, rops, o));
2248 o->op_private |= OPpLVAL_INTRO;
2251 o = op_append_list(OP_LIST, o, rops);
2253 PL_parser->in_my = FALSE;
2254 PL_parser->in_my_stash = NULL;
2259 Perl_sawparens(pTHX_ OP *o)
2261 PERL_UNUSED_CONTEXT;
2263 o->op_flags |= OPf_PARENS;
2268 Perl_bind_match(pTHX_ I32 type, OP *left, OP *right)
2272 const OPCODE ltype = left->op_type;
2273 const OPCODE rtype = right->op_type;
2275 PERL_ARGS_ASSERT_BIND_MATCH;
2277 if ( (ltype == OP_RV2AV || ltype == OP_RV2HV || ltype == OP_PADAV
2278 || ltype == OP_PADHV) && ckWARN(WARN_MISC))
2280 const char * const desc
2282 rtype == OP_SUBST || rtype == OP_TRANS
2283 || rtype == OP_TRANSR
2285 ? (int)rtype : OP_MATCH];
2286 const char * const sample = ((ltype == OP_RV2AV || ltype == OP_PADAV)
2287 ? "@array" : "%hash");
2288 Perl_warner(aTHX_ packWARN(WARN_MISC),
2289 "Applying %s to %s will act on scalar(%s)",
2290 desc, sample, sample);
2293 if (rtype == OP_CONST &&
2294 cSVOPx(right)->op_private & OPpCONST_BARE &&
2295 cSVOPx(right)->op_private & OPpCONST_STRICT)
2297 no_bareword_allowed(right);
2300 /* !~ doesn't make sense with /r, so error on it for now */
2301 if (rtype == OP_SUBST && (cPMOPx(right)->op_pmflags & PMf_NONDESTRUCT) &&
2303 yyerror("Using !~ with s///r doesn't make sense");
2304 if (rtype == OP_TRANSR && type == OP_NOT)
2305 yyerror("Using !~ with tr///r doesn't make sense");
2307 ismatchop = (rtype == OP_MATCH ||
2308 rtype == OP_SUBST ||
2309 rtype == OP_TRANS || rtype == OP_TRANSR)
2310 && !(right->op_flags & OPf_SPECIAL);
2311 if (ismatchop && right->op_private & OPpTARGET_MY) {
2313 right->op_private &= ~OPpTARGET_MY;
2315 if (!(right->op_flags & OPf_STACKED) && ismatchop) {
2318 right->op_flags |= OPf_STACKED;
2319 if (rtype != OP_MATCH && rtype != OP_TRANSR &&
2320 ! (rtype == OP_TRANS &&
2321 right->op_private & OPpTRANS_IDENTICAL) &&
2322 ! (rtype == OP_SUBST &&
2323 (cPMOPx(right)->op_pmflags & PMf_NONDESTRUCT)))
2324 newleft = op_lvalue(left, rtype);
2327 if (right->op_type == OP_TRANS || right->op_type == OP_TRANSR)
2328 o = newBINOP(OP_NULL, OPf_STACKED, scalar(newleft), right);
2330 o = op_prepend_elem(rtype, scalar(newleft), right);
2332 return newUNOP(OP_NOT, 0, scalar(o));
2336 return bind_match(type, left,
2337 pmruntime(newPMOP(OP_MATCH, 0), right, 0));
2341 Perl_invert(pTHX_ OP *o)
2345 return newUNOP(OP_NOT, OPf_SPECIAL, scalar(o));
2349 =for apidoc Amx|OP *|op_scope|OP *o
2351 Wraps up an op tree with some additional ops so that at runtime a dynamic
2352 scope will be created. The original ops run in the new dynamic scope,
2353 and then, provided that they exit normally, the scope will be unwound.
2354 The additional ops used to create and unwind the dynamic scope will
2355 normally be an C<enter>/C<leave> pair, but a C<scope> op may be used
2356 instead if the ops are simple enough to not need the full dynamic scope
2363 Perl_op_scope(pTHX_ OP *o)
2367 if (o->op_flags & OPf_PARENS || PERLDB_NOOPT || PL_tainting) {
2368 o = op_prepend_elem(OP_LINESEQ, newOP(OP_ENTER, 0), o);
2369 o->op_type = OP_LEAVE;
2370 o->op_ppaddr = PL_ppaddr[OP_LEAVE];
2372 else if (o->op_type == OP_LINESEQ) {
2374 o->op_type = OP_SCOPE;
2375 o->op_ppaddr = PL_ppaddr[OP_SCOPE];
2376 kid = ((LISTOP*)o)->op_first;
2377 if (kid->op_type == OP_NEXTSTATE || kid->op_type == OP_DBSTATE) {
2380 /* The following deals with things like 'do {1 for 1}' */
2381 kid = kid->op_sibling;
2383 (kid->op_type == OP_NEXTSTATE || kid->op_type == OP_DBSTATE))
2388 o = newLISTOP(OP_SCOPE, 0, o, NULL);
2394 Perl_block_start(pTHX_ int full)
2397 const int retval = PL_savestack_ix;
2399 pad_block_start(full);
2401 PL_hints &= ~HINT_BLOCK_SCOPE;
2402 SAVECOMPILEWARNINGS();
2403 PL_compiling.cop_warnings = DUP_WARNINGS(PL_compiling.cop_warnings);
2405 CALL_BLOCK_HOOKS(bhk_start, full);
2411 Perl_block_end(pTHX_ I32 floor, OP *seq)
2414 const int needblockscope = PL_hints & HINT_BLOCK_SCOPE;
2415 OP* retval = scalarseq(seq);
2417 CALL_BLOCK_HOOKS(bhk_pre_end, &retval);
2420 CopHINTS_set(&PL_compiling, PL_hints);
2422 PL_hints |= HINT_BLOCK_SCOPE; /* propagate out */
2425 CALL_BLOCK_HOOKS(bhk_post_end, &retval);
2431 =head1 Compile-time scope hooks
2433 =for apidoc Aox||blockhook_register
2435 Register a set of hooks to be called when the Perl lexical scope changes
2436 at compile time. See L<perlguts/"Compile-time scope hooks">.
2442 Perl_blockhook_register(pTHX_ BHK *hk)
2444 PERL_ARGS_ASSERT_BLOCKHOOK_REGISTER;
2446 Perl_av_create_and_push(aTHX_ &PL_blockhooks, newSViv(PTR2IV(hk)));
2453 const PADOFFSET offset = Perl_pad_findmy(aTHX_ STR_WITH_LEN("$_"), 0);
2454 if (offset == NOT_IN_PAD || PAD_COMPNAME_FLAGS_isOUR(offset)) {
2455 return newSVREF(newGVOP(OP_GV, 0, PL_defgv));
2458 OP * const o = newOP(OP_PADSV, 0);
2459 o->op_targ = offset;
2465 Perl_newPROG(pTHX_ OP *o)
2469 PERL_ARGS_ASSERT_NEWPROG;
2474 PL_eval_root = newUNOP(OP_LEAVEEVAL,
2475 ((PL_in_eval & EVAL_KEEPERR)
2476 ? OPf_SPECIAL : 0), o);
2477 /* don't use LINKLIST, since PL_eval_root might indirect through
2478 * a rather expensive function call and LINKLIST evaluates its
2479 * argument more than once */
2480 PL_eval_start = op_linklist(PL_eval_root);
2481 PL_eval_root->op_private |= OPpREFCOUNTED;
2482 OpREFCNT_set(PL_eval_root, 1);
2483 PL_eval_root->op_next = 0;
2484 CALL_PEEP(PL_eval_start);
2487 if (o->op_type == OP_STUB) {
2488 PL_comppad_name = 0;
2490 S_op_destroy(aTHX_ o);
2493 PL_main_root = op_scope(sawparens(scalarvoid(o)));
2494 PL_curcop = &PL_compiling;
2495 PL_main_start = LINKLIST(PL_main_root);
2496 PL_main_root->op_private |= OPpREFCOUNTED;
2497 OpREFCNT_set(PL_main_root, 1);
2498 PL_main_root->op_next = 0;
2499 CALL_PEEP(PL_main_start);
2502 /* Register with debugger */
2504 CV * const cv = get_cvs("DB::postponed", 0);
2508 XPUSHs(MUTABLE_SV(CopFILEGV(&PL_compiling)));
2510 call_sv(MUTABLE_SV(cv), G_DISCARD);
2517 Perl_localize(pTHX_ OP *o, I32 lex)
2521 PERL_ARGS_ASSERT_LOCALIZE;
2523 if (o->op_flags & OPf_PARENS)
2524 /* [perl #17376]: this appears to be premature, and results in code such as
2525 C< our(%x); > executing in list mode rather than void mode */
2532 if ( PL_parser->bufptr > PL_parser->oldbufptr
2533 && PL_parser->bufptr[-1] == ','
2534 && ckWARN(WARN_PARENTHESIS))
2536 char *s = PL_parser->bufptr;
2539 /* some heuristics to detect a potential error */
2540 while (*s && (strchr(", \t\n", *s)))
2544 if (*s && strchr("@$%*", *s) && *++s
2545 && (isALNUM(*s) || UTF8_IS_CONTINUED(*s))) {
2548 while (*s && (isALNUM(*s) || UTF8_IS_CONTINUED(*s)))
2550 while (*s && (strchr(", \t\n", *s)))
2556 if (sigil && (*s == ';' || *s == '=')) {
2557 Perl_warner(aTHX_ packWARN(WARN_PARENTHESIS),
2558 "Parentheses missing around \"%s\" list",
2560 ? (PL_parser->in_my == KEY_our
2562 : PL_parser->in_my == KEY_state
2572 o = op_lvalue(o, OP_NULL); /* a bit kludgey */
2573 PL_parser->in_my = FALSE;
2574 PL_parser->in_my_stash = NULL;
2579 Perl_jmaybe(pTHX_ OP *o)
2581 PERL_ARGS_ASSERT_JMAYBE;
2583 if (o->op_type == OP_LIST) {
2585 = newSVREF(newGVOP(OP_GV, 0, gv_fetchpvs(";", GV_ADD|GV_NOTQUAL, SVt_PV)));
2586 o = convert(OP_JOIN, 0, op_prepend_elem(OP_LIST, o2, o));
2592 S_fold_constants(pTHX_ register OP *o)
2595 register OP * VOL curop;
2597 VOL I32 type = o->op_type;
2602 SV * const oldwarnhook = PL_warnhook;
2603 SV * const olddiehook = PL_diehook;
2607 PERL_ARGS_ASSERT_FOLD_CONSTANTS;
2609 if (PL_opargs[type] & OA_RETSCALAR)
2611 if (PL_opargs[type] & OA_TARGET && !o->op_targ)
2612 o->op_targ = pad_alloc(type, SVs_PADTMP);
2614 /* integerize op, unless it happens to be C<-foo>.
2615 * XXX should pp_i_negate() do magic string negation instead? */
2616 if ((PL_opargs[type] & OA_OTHERINT) && (PL_hints & HINT_INTEGER)
2617 && !(type == OP_NEGATE && cUNOPo->op_first->op_type == OP_CONST
2618 && (cUNOPo->op_first->op_private & OPpCONST_BARE)))
2620 o->op_ppaddr = PL_ppaddr[type = ++(o->op_type)];
2623 if (!(PL_opargs[type] & OA_FOLDCONST))
2628 /* XXX might want a ck_negate() for this */
2629 cUNOPo->op_first->op_private &= ~OPpCONST_STRICT;
2641 /* XXX what about the numeric ops? */
2642 if (PL_hints & HINT_LOCALE)
2647 if (PL_parser && PL_parser->error_count)
2648 goto nope; /* Don't try to run w/ errors */
2650 for (curop = LINKLIST(o); curop != o; curop = LINKLIST(curop)) {
2651 const OPCODE type = curop->op_type;
2652 if ((type != OP_CONST || (curop->op_private & OPpCONST_BARE)) &&
2654 type != OP_SCALAR &&
2656 type != OP_PUSHMARK)
2662 curop = LINKLIST(o);
2663 old_next = o->op_next;
2667 oldscope = PL_scopestack_ix;
2668 create_eval_scope(G_FAKINGEVAL);
2670 /* Verify that we don't need to save it: */
2671 assert(PL_curcop == &PL_compiling);
2672 StructCopy(&PL_compiling, ¬_compiling, COP);
2673 PL_curcop = ¬_compiling;
2674 /* The above ensures that we run with all the correct hints of the
2675 currently compiling COP, but that IN_PERL_RUNTIME is not true. */
2676 assert(IN_PERL_RUNTIME);
2677 PL_warnhook = PERL_WARNHOOK_FATAL;
2684 sv = *(PL_stack_sp--);
2685 if (o->op_targ && sv == PAD_SV(o->op_targ)) /* grab pad temp? */
2686 pad_swipe(o->op_targ, FALSE);
2687 else if (SvTEMP(sv)) { /* grab mortal temp? */
2688 SvREFCNT_inc_simple_void(sv);
2693 /* Something tried to die. Abandon constant folding. */
2694 /* Pretend the error never happened. */
2696 o->op_next = old_next;
2700 /* Don't expect 1 (setjmp failed) or 2 (something called my_exit) */
2701 PL_warnhook = oldwarnhook;
2702 PL_diehook = olddiehook;
2703 /* XXX note that this croak may fail as we've already blown away
2704 * the stack - eg any nested evals */
2705 Perl_croak(aTHX_ "panic: fold_constants JMPENV_PUSH returned %d", ret);
2708 PL_warnhook = oldwarnhook;
2709 PL_diehook = olddiehook;
2710 PL_curcop = &PL_compiling;
2712 if (PL_scopestack_ix > oldscope)
2713 delete_eval_scope();
2722 if (type == OP_RV2GV)
2723 newop = newGVOP(OP_GV, 0, MUTABLE_GV(sv));
2725 newop = newSVOP(OP_CONST, 0, MUTABLE_SV(sv));
2726 op_getmad(o,newop,'f');
2734 S_gen_constant_list(pTHX_ register OP *o)
2738 const I32 oldtmps_floor = PL_tmps_floor;
2741 if (PL_parser && PL_parser->error_count)
2742 return o; /* Don't attempt to run with errors */
2744 PL_op = curop = LINKLIST(o);
2747 Perl_pp_pushmark(aTHX);
2750 assert (!(curop->op_flags & OPf_SPECIAL));
2751 assert(curop->op_type == OP_RANGE);
2752 Perl_pp_anonlist(aTHX);
2753 PL_tmps_floor = oldtmps_floor;
2755 o->op_type = OP_RV2AV;
2756 o->op_ppaddr = PL_ppaddr[OP_RV2AV];
2757 o->op_flags &= ~OPf_REF; /* treat \(1..2) like an ordinary list */
2758 o->op_flags |= OPf_PARENS; /* and flatten \(1..2,3) */
2759 o->op_opt = 0; /* needs to be revisited in rpeep() */
2760 curop = ((UNOP*)o)->op_first;
2761 ((UNOP*)o)->op_first = newSVOP(OP_CONST, 0, SvREFCNT_inc_NN(*PL_stack_sp--));
2763 op_getmad(curop,o,'O');
2772 Perl_convert(pTHX_ I32 type, I32 flags, OP *o)
2775 if (!o || o->op_type != OP_LIST)
2776 o = newLISTOP(OP_LIST, 0, o, NULL);
2778 o->op_flags &= ~OPf_WANT;
2780 if (!(PL_opargs[type] & OA_MARK))
2781 op_null(cLISTOPo->op_first);
2783 o->op_type = (OPCODE)type;
2784 o->op_ppaddr = PL_ppaddr[type];
2785 o->op_flags |= flags;
2787 o = CHECKOP(type, o);
2788 if (o->op_type != (unsigned)type)
2791 return fold_constants(o);
2795 =head1 Optree Manipulation Functions
2798 /* List constructors */
2801 =for apidoc Am|OP *|op_append_elem|I32 optype|OP *first|OP *last
2803 Append an item to the list of ops contained directly within a list-type
2804 op, returning the lengthened list. I<first> is the list-type op,
2805 and I<last> is the op to append to the list. I<optype> specifies the
2806 intended opcode for the list. If I<first> is not already a list of the
2807 right type, it will be upgraded into one. If either I<first> or I<last>
2808 is null, the other is returned unchanged.
2814 Perl_op_append_elem(pTHX_ I32 type, OP *first, OP *last)
2822 if (first->op_type != (unsigned)type
2823 || (type == OP_LIST && (first->op_flags & OPf_PARENS)))
2825 return newLISTOP(type, 0, first, last);
2828 if (first->op_flags & OPf_KIDS)
2829 ((LISTOP*)first)->op_last->op_sibling = last;
2831 first->op_flags |= OPf_KIDS;
2832 ((LISTOP*)first)->op_first = last;
2834 ((LISTOP*)first)->op_last = last;
2839 =for apidoc Am|OP *|op_append_list|I32 optype|OP *first|OP *last
2841 Concatenate the lists of ops contained directly within two list-type ops,
2842 returning the combined list. I<first> and I<last> are the list-type ops
2843 to concatenate. I<optype> specifies the intended opcode for the list.
2844 If either I<first> or I<last> is not already a list of the right type,
2845 it will be upgraded into one. If either I<first> or I<last> is null,
2846 the other is returned unchanged.
2852 Perl_op_append_list(pTHX_ I32 type, OP *first, OP *last)
2860 if (first->op_type != (unsigned)type)
2861 return op_prepend_elem(type, first, last);
2863 if (last->op_type != (unsigned)type)
2864 return op_append_elem(type, first, last);
2866 ((LISTOP*)first)->op_last->op_sibling = ((LISTOP*)last)->op_first;
2867 ((LISTOP*)first)->op_last = ((LISTOP*)last)->op_last;
2868 first->op_flags |= (last->op_flags & OPf_KIDS);
2871 if (((LISTOP*)last)->op_first && first->op_madprop) {
2872 MADPROP *mp = ((LISTOP*)last)->op_first->op_madprop;
2874 while (mp->mad_next)
2876 mp->mad_next = first->op_madprop;
2879 ((LISTOP*)last)->op_first->op_madprop = first->op_madprop;
2882 first->op_madprop = last->op_madprop;
2883 last->op_madprop = 0;
2886 S_op_destroy(aTHX_ last);
2892 =for apidoc Am|OP *|op_prepend_elem|I32 optype|OP *first|OP *last
2894 Prepend an item to the list of ops contained directly within a list-type
2895 op, returning the lengthened list. I<first> is the op to prepend to the
2896 list, and I<last> is the list-type op. I<optype> specifies the intended
2897 opcode for the list. If I<last> is not already a list of the right type,
2898 it will be upgraded into one. If either I<first> or I<last> is null,
2899 the other is returned unchanged.
2905 Perl_op_prepend_elem(pTHX_ I32 type, OP *first, OP *last)
2913 if (last->op_type == (unsigned)type) {
2914 if (type == OP_LIST) { /* already a PUSHMARK there */
2915 first->op_sibling = ((LISTOP*)last)->op_first->op_sibling;
2916 ((LISTOP*)last)->op_first->op_sibling = first;
2917 if (!(first->op_flags & OPf_PARENS))
2918 last->op_flags &= ~OPf_PARENS;
2921 if (!(last->op_flags & OPf_KIDS)) {
2922 ((LISTOP*)last)->op_last = first;
2923 last->op_flags |= OPf_KIDS;
2925 first->op_sibling = ((LISTOP*)last)->op_first;
2926 ((LISTOP*)last)->op_first = first;
2928 last->op_flags |= OPf_KIDS;
2932 return newLISTOP(type, 0, first, last);
2940 Perl_newTOKEN(pTHX_ I32 optype, YYSTYPE lval, MADPROP* madprop)
2943 Newxz(tk, 1, TOKEN);
2944 tk->tk_type = (OPCODE)optype;
2945 tk->tk_type = 12345;
2947 tk->tk_mad = madprop;
2952 Perl_token_free(pTHX_ TOKEN* tk)
2954 PERL_ARGS_ASSERT_TOKEN_FREE;
2956 if (tk->tk_type != 12345)
2958 mad_free(tk->tk_mad);
2963 Perl_token_getmad(pTHX_ TOKEN* tk, OP* o, char slot)
2968 PERL_ARGS_ASSERT_TOKEN_GETMAD;
2970 if (tk->tk_type != 12345) {
2971 Perl_warner(aTHX_ packWARN(WARN_MISC),
2972 "Invalid TOKEN object ignored");
2979 /* faked up qw list? */
2981 tm->mad_type == MAD_SV &&
2982 SvPVX((SV *)tm->mad_val)[0] == 'q')
2989 /* pretend constant fold didn't happen? */
2990 if (mp->mad_key == 'f' &&
2991 (o->op_type == OP_CONST ||
2992 o->op_type == OP_GV) )
2994 token_getmad(tk,(OP*)mp->mad_val,slot);
3008 if (mp->mad_key == 'X')
3009 mp->mad_key = slot; /* just change the first one */
3019 Perl_op_getmad_weak(pTHX_ OP* from, OP* o, char slot)
3028 /* pretend constant fold didn't happen? */
3029 if (mp->mad_key == 'f' &&
3030 (o->op_type == OP_CONST ||
3031 o->op_type == OP_GV) )
3033 op_getmad(from,(OP*)mp->mad_val,slot);
3040 mp->mad_next = newMADPROP(slot,MAD_OP,from,0);
3043 o->op_madprop = newMADPROP(slot,MAD_OP,from,0);
3049 Perl_op_getmad(pTHX_ OP* from, OP* o, char slot)
3058 /* pretend constant fold didn't happen? */
3059 if (mp->mad_key == 'f' &&
3060 (o->op_type == OP_CONST ||
3061 o->op_type == OP_GV) )
3063 op_getmad(from,(OP*)mp->mad_val,slot);
3070 mp->mad_next = newMADPROP(slot,MAD_OP,from,1);
3073 o->op_madprop = newMADPROP(slot,MAD_OP,from,1);
3077 PerlIO_printf(PerlIO_stderr(),
3078 "DESTROYING op = %0"UVxf"\n", PTR2UV(from));
3084 Perl_prepend_madprops(pTHX_ MADPROP* mp, OP* o, char slot)
3102 Perl_append_madprops(pTHX_ MADPROP* tm, OP* o, char slot)
3106 addmad(tm, &(o->op_madprop), slot);
3110 Perl_addmad(pTHX_ MADPROP* tm, MADPROP** root, char slot)
3131 Perl_newMADsv(pTHX_ char key, SV* sv)
3133 PERL_ARGS_ASSERT_NEWMADSV;
3135 return newMADPROP(key, MAD_SV, sv, 0);
3139 Perl_newMADPROP(pTHX_ char key, char type, void* val, I32 vlen)
3142 Newxz(mp, 1, MADPROP);
3145 mp->mad_vlen = vlen;
3146 mp->mad_type = type;
3148 /* PerlIO_printf(PerlIO_stderr(), "NEW mp = %0x\n", mp); */
3153 Perl_mad_free(pTHX_ MADPROP* mp)
3155 /* PerlIO_printf(PerlIO_stderr(), "FREE mp = %0x\n", mp); */
3159 mad_free(mp->mad_next);
3160 /* if (PL_parser && PL_parser->lex_state != LEX_NOTPARSING && mp->mad_vlen)
3161 PerlIO_printf(PerlIO_stderr(), "DESTROYING '%c'=<%s>\n", mp->mad_key & 255, mp->mad_val); */
3162 switch (mp->mad_type) {
3166 Safefree((char*)mp->mad_val);
3169 if (mp->mad_vlen) /* vlen holds "strong/weak" boolean */
3170 op_free((OP*)mp->mad_val);
3173 sv_free(MUTABLE_SV(mp->mad_val));
3176 PerlIO_printf(PerlIO_stderr(), "Unrecognized mad\n");
3185 =head1 Optree construction
3187 =for apidoc Am|OP *|newNULLLIST
3189 Constructs, checks, and returns a new C<stub> op, which represents an
3190 empty list expression.
3196 Perl_newNULLLIST(pTHX)
3198 return newOP(OP_STUB, 0);
3202 S_force_list(pTHX_ OP *o)
3204 if (!o || o->op_type != OP_LIST)
3205 o = newLISTOP(OP_LIST, 0, o, NULL);
3211 =for apidoc Am|OP *|newLISTOP|I32 type|I32 flags|OP *first|OP *last
3213 Constructs, checks, and returns an op of any list type. I<type> is
3214 the opcode. I<flags> gives the eight bits of C<op_flags>, except that
3215 C<OPf_KIDS> will be set automatically if required. I<first> and I<last>
3216 supply up to two ops to be direct children of the list op; they are
3217 consumed by this function and become part of the constructed op tree.
3223 Perl_newLISTOP(pTHX_ I32 type, I32 flags, OP *first, OP *last)
3228 assert((PL_opargs[type] & OA_CLASS_MASK) == OA_LISTOP);
3230 NewOp(1101, listop, 1, LISTOP);
3232 listop->op_type = (OPCODE)type;
3233 listop->op_ppaddr = PL_ppaddr[type];
3236 listop->op_flags = (U8)flags;
3240 else if (!first && last)
3243 first->op_sibling = last;
3244 listop->op_first = first;
3245 listop->op_last = last;
3246 if (type == OP_LIST) {
3247 OP* const pushop = newOP(OP_PUSHMARK, 0);
3248 pushop->op_sibling = first;
3249 listop->op_first = pushop;
3250 listop->op_flags |= OPf_KIDS;
3252 listop->op_last = pushop;
3255 return CHECKOP(type, listop);
3259 =for apidoc Am|OP *|newOP|I32 type|I32 flags
3261 Constructs, checks, and returns an op of any base type (any type that
3262 has no extra fields). I<type> is the opcode. I<flags> gives the
3263 eight bits of C<op_flags>, and, shifted up eight bits, the eight bits
3270 Perl_newOP(pTHX_ I32 type, I32 flags)
3275 assert((PL_opargs[type] & OA_CLASS_MASK) == OA_BASEOP
3276 || (PL_opargs[type] & OA_CLASS_MASK) == OA_BASEOP_OR_UNOP
3277 || (PL_opargs[type] & OA_CLASS_MASK) == OA_FILESTATOP
3278 || (PL_opargs[type] & OA_CLASS_MASK) == OA_LOOPEXOP);
3280 NewOp(1101, o, 1, OP);
3281 o->op_type = (OPCODE)type;
3282 o->op_ppaddr = PL_ppaddr[type];
3283 o->op_flags = (U8)flags;
3285 o->op_latefreed = 0;
3289 o->op_private = (U8)(0 | (flags >> 8));
3290 if (PL_opargs[type] & OA_RETSCALAR)
3292 if (PL_opargs[type] & OA_TARGET)
3293 o->op_targ = pad_alloc(type, SVs_PADTMP);
3294 return CHECKOP(type, o);
3298 =for apidoc Am|OP *|newUNOP|I32 type|I32 flags|OP *first
3300 Constructs, checks, and returns an op of any unary type. I<type> is
3301 the opcode. I<flags> gives the eight bits of C<op_flags>, except that
3302 C<OPf_KIDS> will be set automatically if required, and, shifted up eight
3303 bits, the eight bits of C<op_private>, except that the bit with value 1
3304 is automatically set. I<first> supplies an optional op to be the direct
3305 child of the unary op; it is consumed by this function and become part
3306 of the constructed op tree.
3312 Perl_newUNOP(pTHX_ I32 type, I32 flags, OP *first)
3317 assert((PL_opargs[type] & OA_CLASS_MASK) == OA_UNOP
3318 || (PL_opargs[type] & OA_CLASS_MASK) == OA_BASEOP_OR_UNOP
3319 || (PL_opargs[type] & OA_CLASS_MASK) == OA_FILESTATOP
3320 || (PL_opargs[type] & OA_CLASS_MASK) == OA_LOOPEXOP
3321 || type == OP_SASSIGN
3322 || type == OP_ENTERTRY
3323 || type == OP_NULL );
3326 first = newOP(OP_STUB, 0);
3327 if (PL_opargs[type] & OA_MARK)
3328 first = force_list(first);
3330 NewOp(1101, unop, 1, UNOP);
3331 unop->op_type = (OPCODE)type;
3332 unop->op_ppaddr = PL_ppaddr[type];
3333 unop->op_first = first;
3334 unop->op_flags = (U8)(flags | OPf_KIDS);
3335 unop->op_private = (U8)(1 | (flags >> 8));
3336 unop = (UNOP*) CHECKOP(type, unop);
3340 return fold_constants((OP *) unop);
3344 =for apidoc Am|OP *|newBINOP|I32 type|I32 flags|OP *first|OP *last
3346 Constructs, checks, and returns an op of any binary type. I<type>
3347 is the opcode. I<flags> gives the eight bits of C<op_flags>, except
3348 that C<OPf_KIDS> will be set automatically, and, shifted up eight bits,
3349 the eight bits of C<op_private>, except that the bit with value 1 or
3350 2 is automatically set as required. I<first> and I<last> supply up to
3351 two ops to be the direct children of the binary op; they are consumed
3352 by this function and become part of the constructed op tree.
3358 Perl_newBINOP(pTHX_ I32 type, I32 flags, OP *first, OP *last)
3363 assert((PL_opargs[type] & OA_CLASS_MASK) == OA_BINOP
3364 || type == OP_SASSIGN || type == OP_NULL );
3366 NewOp(1101, binop, 1, BINOP);
3369 first = newOP(OP_NULL, 0);
3371 binop->op_type = (OPCODE)type;
3372 binop->op_ppaddr = PL_ppaddr[type];
3373 binop->op_first = first;
3374 binop->op_flags = (U8)(flags | OPf_KIDS);
3377 binop->op_private = (U8)(1 | (flags >> 8));
3380 binop->op_private = (U8)(2 | (flags >> 8));
3381 first->op_sibling = last;
3384 binop = (BINOP*)CHECKOP(type, binop);
3385 if (binop->op_next || binop->op_type != (OPCODE)type)
3388 binop->op_last = binop->op_first->op_sibling;
3390 return fold_constants((OP *)binop);
3393 static int uvcompare(const void *a, const void *b)
3394 __attribute__nonnull__(1)
3395 __attribute__nonnull__(2)
3396 __attribute__pure__;
3397 static int uvcompare(const void *a, const void *b)
3399 if (*((const UV *)a) < (*(const UV *)b))
3401 if (*((const UV *)a) > (*(const UV *)b))
3403 if (*((const UV *)a+1) < (*(const UV *)b+1))
3405 if (*((const UV *)a+1) > (*(const UV *)b+1))
3411 S_pmtrans(pTHX_ OP *o, OP *expr, OP *repl)
3414 SV * const tstr = ((SVOP*)expr)->op_sv;
3417 (repl->op_type == OP_NULL)
3418 ? ((SVOP*)((LISTOP*)repl)->op_first)->op_sv :
3420 ((SVOP*)repl)->op_sv;
3423 const U8 *t = (U8*)SvPV_const(tstr, tlen);
3424 const U8 *r = (U8*)SvPV_const(rstr, rlen);
3428 register short *tbl;
3430 const I32 complement = o->op_private & OPpTRANS_COMPLEMENT;
3431 const I32 squash = o->op_private & OPpTRANS_SQUASH;
3432 I32 del = o->op_private & OPpTRANS_DELETE;
3435 PERL_ARGS_ASSERT_PMTRANS;
3437 PL_hints |= HINT_BLOCK_SCOPE;
3440 o->op_private |= OPpTRANS_FROM_UTF;
3443 o->op_private |= OPpTRANS_TO_UTF;
3445 if (o->op_private & (OPpTRANS_FROM_UTF|OPpTRANS_TO_UTF)) {
3446 SV* const listsv = newSVpvs("# comment\n");
3448 const U8* tend = t + tlen;
3449 const U8* rend = r + rlen;
3463 const I32 from_utf = o->op_private & OPpTRANS_FROM_UTF;
3464 const I32 to_utf = o->op_private & OPpTRANS_TO_UTF;
3467 const U32 flags = UTF8_ALLOW_DEFAULT;
3471 t = tsave = bytes_to_utf8(t, &len);
3474 if (!to_utf && rlen) {
3476 r = rsave = bytes_to_utf8(r, &len);
3480 /* There are several snags with this code on EBCDIC:
3481 1. 0xFF is a legal UTF-EBCDIC byte (there are no illegal bytes).
3482 2. scan_const() in toke.c has encoded chars in native encoding which makes
3483 ranges at least in EBCDIC 0..255 range the bottom odd.
3487 U8 tmpbuf[UTF8_MAXBYTES+1];
3490 Newx(cp, 2*tlen, UV);
3492 transv = newSVpvs("");
3494 cp[2*i] = utf8n_to_uvuni(t, tend-t, &ulen, flags);
3496 if (t < tend && NATIVE_TO_UTF(*t) == 0xff) {
3498 cp[2*i+1] = utf8n_to_uvuni(t, tend-t, &ulen, flags);
3502 cp[2*i+1] = cp[2*i];
3506 qsort(cp, i, 2*sizeof(UV), uvcompare);
3507 for (j = 0; j < i; j++) {
3509 diff = val - nextmin;
3511 t = uvuni_to_utf8(tmpbuf,nextmin);
3512 sv_catpvn(transv, (char*)tmpbuf, t - tmpbuf);
3514 U8 range_mark = UTF_TO_NATIVE(0xff);
3515 t = uvuni_to_utf8(tmpbuf, val - 1);
3516 sv_catpvn(transv, (char *)&range_mark, 1);
3517 sv_catpvn(transv, (char*)tmpbuf, t - tmpbuf);
3524 t = uvuni_to_utf8(tmpbuf,nextmin);
3525 sv_catpvn(transv, (char*)tmpbuf, t - tmpbuf);
3527 U8 range_mark = UTF_TO_NATIVE(0xff);
3528 sv_catpvn(transv, (char *)&range_mark, 1);
3530 t = uvuni_to_utf8_flags(tmpbuf, 0x7fffffff,
3531 UNICODE_ALLOW_SUPER);
3532 sv_catpvn(transv, (char*)tmpbuf, t - tmpbuf);
3533 t = (const U8*)SvPVX_const(transv);
3534 tlen = SvCUR(transv);
3538 else if (!rlen && !del) {
3539 r = t; rlen = tlen; rend = tend;
3542 if ((!rlen && !del) || t == r ||
3543 (tlen == rlen && memEQ((char *)t, (char *)r, tlen)))
3545 o->op_private |= OPpTRANS_IDENTICAL;
3549 while (t < tend || tfirst <= tlast) {
3550 /* see if we need more "t" chars */
3551 if (tfirst > tlast) {
3552 tfirst = (I32)utf8n_to_uvuni(t, tend - t, &ulen, flags);
3554 if (t < tend && NATIVE_TO_UTF(*t) == 0xff) { /* illegal utf8 val indicates range */
3556 tlast = (I32)utf8n_to_uvuni(t, tend - t, &ulen, flags);
3563 /* now see if we need more "r" chars */
3564 if (rfirst > rlast) {
3566 rfirst = (I32)utf8n_to_uvuni(r, rend - r, &ulen, flags);
3568 if (r < rend && NATIVE_TO_UTF(*r) == 0xff) { /* illegal utf8 val indicates range */
3570 rlast = (I32)utf8n_to_uvuni(r, rend - r, &ulen, flags);
3579 rfirst = rlast = 0xffffffff;
3583 /* now see which range will peter our first, if either. */
3584 tdiff = tlast - tfirst;
3585 rdiff = rlast - rfirst;
3592 if (rfirst == 0xffffffff) {
3593 diff = tdiff; /* oops, pretend rdiff is infinite */
3595 Perl_sv_catpvf(aTHX_ listsv, "%04lx\t%04lx\tXXXX\n",
3596 (long)tfirst, (long)tlast);
3598 Perl_sv_catpvf(aTHX_ listsv, "%04lx\t\tXXXX\n", (long)tfirst);
3602 Perl_sv_catpvf(aTHX_ listsv, "%04lx\t%04lx\t%04lx\n",
3603 (long)tfirst, (long)(tfirst + diff),
3606 Perl_sv_catpvf(aTHX_ listsv, "%04lx\t\t%04lx\n",
3607 (long)tfirst, (long)rfirst);
3609 if (rfirst + diff > max)
3610 max = rfirst + diff;
3612 grows = (tfirst < rfirst &&
3613 UNISKIP(tfirst) < UNISKIP(rfirst + diff));
3625 else if (max > 0xff)
3630 PerlMemShared_free(cPVOPo->op_pv);
3631 cPVOPo->op_pv = NULL;
3633 swash = MUTABLE_SV(swash_init("utf8", "", listsv, bits, none));
3635 cPADOPo->op_padix = pad_alloc(OP_TRANS, SVs_PADTMP);
3636 SvREFCNT_dec(PAD_SVl(cPADOPo->op_padix));
3637 PAD_SETSV(cPADOPo->op_padix, swash);
3639 SvREADONLY_on(swash);
3641 cSVOPo->op_sv = swash;
3643 SvREFCNT_dec(listsv);
3644 SvREFCNT_dec(transv);
3646 if (!del && havefinal && rlen)
3647 (void)hv_store(MUTABLE_HV(SvRV(swash)), "FINAL", 5,
3648 newSVuv((UV)final), 0);
3651 o->op_private |= OPpTRANS_GROWS;
3657 op_getmad(expr,o,'e');
3658 op_getmad(repl,o,'r');
3666 tbl = (short*)cPVOPo->op_pv;
3668 Zero(tbl, 256, short);
3669 for (i = 0; i < (I32)tlen; i++)
3671 for (i = 0, j = 0; i < 256; i++) {
3673 if (j >= (I32)rlen) {
3682 if (i < 128 && r[j] >= 128)
3692 o->op_private |= OPpTRANS_IDENTICAL;
3694 else if (j >= (I32)rlen)
3699 PerlMemShared_realloc(tbl,
3700 (0x101+rlen-j) * sizeof(short));
3701 cPVOPo->op_pv = (char*)tbl;
3703 tbl[0x100] = (short)(rlen - j);
3704 for (i=0; i < (I32)rlen - j; i++)
3705 tbl[0x101+i] = r[j+i];
3709 if (!rlen && !del) {
3712 o->op_private |= OPpTRANS_IDENTICAL;
3714 else if (!squash && rlen == tlen && memEQ((char*)t, (char*)r, tlen)) {
3715 o->op_private |= OPpTRANS_IDENTICAL;
3717 for (i = 0; i < 256; i++)
3719 for (i = 0, j = 0; i < (I32)tlen; i++,j++) {
3720 if (j >= (I32)rlen) {
3722 if (tbl[t[i]] == -1)
3728 if (tbl[t[i]] == -1) {
3729 if (t[i] < 128 && r[j] >= 128)
3736 if(del && rlen == tlen) {
3737 Perl_ck_warner(aTHX_ packWARN(WARN_MISC), "Useless use of /d modifier in transliteration operator");
3738 } else if(rlen > tlen) {
3739 Perl_ck_warner(aTHX_ packWARN(WARN_MISC), "Replacement list is longer than search list");
3743 o->op_private |= OPpTRANS_GROWS;
3745 op_getmad(expr,o,'e');
3746 op_getmad(repl,o,'r');
3756 =for apidoc Am|OP *|newPMOP|I32 type|I32 flags
3758 Constructs, checks, and returns an op of any pattern matching type.
3759 I<type> is the opcode. I<flags> gives the eight bits of C<op_flags>
3760 and, shifted up eight bits, the eight bits of C<op_private>.
3766 Perl_newPMOP(pTHX_ I32 type, I32 flags)
3771 assert((PL_opargs[type] & OA_CLASS_MASK) == OA_PMOP);
3773 NewOp(1101, pmop, 1, PMOP);
3774 pmop->op_type = (OPCODE)type;
3775 pmop->op_ppaddr = PL_ppaddr[type];
3776 pmop->op_flags = (U8)flags;
3777 pmop->op_private = (U8)(0 | (flags >> 8));
3779 if (PL_hints & HINT_RE_TAINT)
3780 pmop->op_pmflags |= PMf_RETAINT;
3781 if (PL_hints & HINT_LOCALE) {
3782 pmop->op_pmflags |= PMf_LOCALE;
3784 else if ((! (PL_hints & HINT_BYTES)) && (PL_hints & HINT_UNI_8_BIT)) {
3785 pmop->op_pmflags |= RXf_PMf_UNICODE;
3787 if (PL_hints & HINT_RE_FLAGS) {
3788 SV *reflags = Perl_refcounted_he_fetch_pvn(aTHX_
3789 PL_compiling.cop_hints_hash, STR_WITH_LEN("reflags"), 0, 0
3791 if (reflags && SvOK(reflags)) pmop->op_pmflags |= SvIV(reflags);
3792 reflags = Perl_refcounted_he_fetch_pvn(aTHX_
3793 PL_compiling.cop_hints_hash, STR_WITH_LEN("reflags_dul"), 0, 0
3795 if (reflags && SvOK(reflags)) {
3796 pmop->op_pmflags &= ~(RXf_PMf_LOCALE|RXf_PMf_UNICODE);
3797 pmop->op_pmflags |= SvIV(reflags);
3803 assert(SvPOK(PL_regex_pad[0]));
3804 if (SvCUR(PL_regex_pad[0])) {
3805 /* Pop off the "packed" IV from the end. */
3806 SV *const repointer_list = PL_regex_pad[0];
3807 const char *p = SvEND(repointer_list) - sizeof(IV);
3808 const IV offset = *((IV*)p);
3810 assert(SvCUR(repointer_list) % sizeof(IV) == 0);
3812 SvEND_set(repointer_list, p);
3814 pmop->op_pmoffset = offset;
3815 /* This slot should be free, so assert this: */
3816 assert(PL_regex_pad[offset] == &PL_sv_undef);
3818 SV * const repointer = &PL_sv_undef;
3819 av_push(PL_regex_padav, repointer);
3820 pmop->op_pmoffset = av_len(PL_regex_padav);
3821 PL_regex_pad = AvARRAY(PL_regex_padav);
3825 return CHECKOP(type, pmop);
3828 /* Given some sort of match op o, and an expression expr containing a
3829 * pattern, either compile expr into a regex and attach it to o (if it's
3830 * constant), or convert expr into a runtime regcomp op sequence (if it's
3833 * isreg indicates that the pattern is part of a regex construct, eg
3834 * $x =~ /pattern/ or split /pattern/, as opposed to $x =~ $pattern or
3835 * split "pattern", which aren't. In the former case, expr will be a list
3836 * if the pattern contains more than one term (eg /a$b/) or if it contains
3837 * a replacement, ie s/// or tr///.
3841 Perl_pmruntime(pTHX_ OP *o, OP *expr, bool isreg)
3846 I32 repl_has_vars = 0;
3850 PERL_ARGS_ASSERT_PMRUNTIME;
3853 o->op_type == OP_SUBST
3854 || o->op_type == OP_TRANS || o->op_type == OP_TRANSR
3856 /* last element in list is the replacement; pop it */
3858 repl = cLISTOPx(expr)->op_last;
3859 kid = cLISTOPx(expr)->op_first;
3860 while (kid->op_sibling != repl)
3861 kid = kid->op_sibling;
3862 kid->op_sibling = NULL;
3863 cLISTOPx(expr)->op_last = kid;
3866 if (isreg && expr->op_type == OP_LIST &&
3867 cLISTOPx(expr)->op_first->op_sibling == cLISTOPx(expr)->op_last)
3869 /* convert single element list to element */
3870 OP* const oe = expr;
3871 expr = cLISTOPx(oe)->op_first->op_sibling;
3872 cLISTOPx(oe)->op_first->op_sibling = NULL;
3873 cLISTOPx(oe)->op_last = NULL;
3877 if (o->op_type == OP_TRANS || o->op_type == OP_TRANSR) {
3878 return pmtrans(o, expr, repl);
3881 reglist = isreg && expr->op_type == OP_LIST;
3885 PL_hints |= HINT_BLOCK_SCOPE;
3888 if (expr->op_type == OP_CONST) {
3889 SV *pat = ((SVOP*)expr)->op_sv;
3890 U32 pm_flags = pm->op_pmflags & PMf_COMPILETIME;
3892 if (o->op_flags & OPf_SPECIAL)
3893 pm_flags |= RXf_SPLIT;
3896 assert (SvUTF8(pat));
3897 } else if (SvUTF8(pat)) {
3898 /* Not doing UTF-8, despite what the SV says. Is this only if we're
3899 trapped in use 'bytes'? */
3900 /* Make a copy of the octet sequence, but without the flag on, as
3901 the compiler now honours the SvUTF8 flag on pat. */
3903 const char *const p = SvPV(pat, len);
3904 pat = newSVpvn_flags(p, len, SVs_TEMP);
3907 PM_SETRE(pm, CALLREGCOMP(pat, pm_flags));
3910 op_getmad(expr,(OP*)pm,'e');
3916 if (pm->op_pmflags & PMf_KEEP || !(PL_hints & HINT_RE_EVAL))
3917 expr = newUNOP((!(PL_hints & HINT_RE_EVAL)
3919 : OP_REGCMAYBE),0,expr);
3921 NewOp(1101, rcop, 1, LOGOP);
3922 rcop->op_type = OP_REGCOMP;
3923 rcop->op_ppaddr = PL_ppaddr[OP_REGCOMP];
3924 rcop->op_first = scalar(expr);
3925 rcop->op_flags |= OPf_KIDS
3926 | ((PL_hints & HINT_RE_EVAL) ? OPf_SPECIAL : 0)
3927 | (reglist ? OPf_STACKED : 0);
3928 rcop->op_private = 1;
3931 rcop->op_targ = pad_alloc(rcop->op_type, SVs_PADTMP);
3933 /* /$x/ may cause an eval, since $x might be qr/(?{..})/ */
3934 if (PL_hints & HINT_RE_EVAL) PL_cv_has_eval = 1;
3936 /* establish postfix order */
3937 if (pm->op_pmflags & PMf_KEEP || !(PL_hints & HINT_RE_EVAL)) {
3939 rcop->op_next = expr;
3940 ((UNOP*)expr)->op_first->op_next = (OP*)rcop;
3943 rcop->op_next = LINKLIST(expr);
3944 expr->op_next = (OP*)rcop;
3947 op_prepend_elem(o->op_type, scalar((OP*)rcop), o);
3952 if (pm->op_pmflags & PMf_EVAL) {
3954 if (CopLINE(PL_curcop) < (line_t)PL_parser->multi_end)
3955 CopLINE_set(PL_curcop, (line_t)PL_parser->multi_end);
3957 else if (repl->op_type == OP_CONST)
3961 for (curop = LINKLIST(repl); curop!=repl; curop = LINKLIST(curop)) {
3962 if (curop->op_type == OP_SCOPE
3963 || curop->op_type == OP_LEAVE
3964 || (PL_opargs[curop->op_type] & OA_DANGEROUS)) {
3965 if (curop->op_type == OP_GV) {
3966 GV * const gv = cGVOPx_gv(curop);
3968 if (strchr("&`'123456789+-\016\022", *GvENAME(gv)))
3971 else if (curop->op_type == OP_RV2CV)
3973 else if (curop->op_type == OP_RV2SV ||
3974 curop->op_type == OP_RV2AV ||
3975 curop->op_type == OP_RV2HV ||
3976 curop->op_type == OP_RV2GV) {
3977 if (lastop && lastop->op_type != OP_GV) /*funny deref?*/
3980 else if (curop->op_type == OP_PADSV ||
3981 curop->op_type == OP_PADAV ||
3982 curop->op_type == OP_PADHV ||
3983 curop->op_type == OP_PADANY)
3987 else if (curop->op_type == OP_PUSHRE)
3988 NOOP; /* Okay here, dangerous in newASSIGNOP */
3998 || RX_EXTFLAGS(PM_GETRE(pm)) & RXf_EVAL_SEEN)))
4000 pm->op_pmflags |= PMf_CONST; /* const for long enough */
4001 op_prepend_elem(o->op_type, scalar(repl), o);
4004 if (curop == repl && !PM_GETRE(pm)) { /* Has variables. */
4005 pm->op_pmflags |= PMf_MAYBE_CONST;
4007 NewOp(1101, rcop, 1, LOGOP);
4008 rcop->op_type = OP_SUBSTCONT;
4009 rcop->op_ppaddr = PL_ppaddr[OP_SUBSTCONT];
4010 rcop->op_first = scalar(repl);
4011 rcop->op_flags |= OPf_KIDS;
4012 rcop->op_private = 1;
4015 /* establish postfix order */
4016 rcop->op_next = LINKLIST(repl);
4017 repl->op_next = (OP*)rcop;
4019 pm->op_pmreplrootu.op_pmreplroot = scalar((OP*)rcop);
4020 assert(!(pm->op_pmflags & PMf_ONCE));
4021 pm->op_pmstashstartu.op_pmreplstart = LINKLIST(rcop);
4030 =for apidoc Am|OP *|newSVOP|I32 type|I32 flags|SV *sv
4032 Constructs, checks, and returns an op of any type that involves an
4033 embedded SV. I<type> is the opcode. I<flags> gives the eight bits
4034 of C<op_flags>. I<sv> gives the SV to embed in the op; this function
4035 takes ownership of one reference to it.
4041 Perl_newSVOP(pTHX_ I32 type, I32 flags, SV *sv)
4046 PERL_ARGS_ASSERT_NEWSVOP;
4048 assert((PL_opargs[type] & OA_CLASS_MASK) == OA_SVOP
4049 || (PL_opargs[type] & OA_CLASS_MASK) == OA_PVOP_OR_SVOP
4050 || (PL_opargs[type] & OA_CLASS_MASK) == OA_FILESTATOP);
4052 NewOp(1101, svop, 1, SVOP);
4053 svop->op_type = (OPCODE)type;
4054 svop->op_ppaddr = PL_ppaddr[type];
4056 svop->op_next = (OP*)svop;
4057 svop->op_flags = (U8)flags;
4058 if (PL_opargs[type] & OA_RETSCALAR)
4060 if (PL_opargs[type] & OA_TARGET)
4061 svop->op_targ = pad_alloc(type, SVs_PADTMP);
4062 return CHECKOP(type, svop);
4068 =for apidoc Am|OP *|newPADOP|I32 type|I32 flags|SV *sv
4070 Constructs, checks, and returns an op of any type that involves a
4071 reference to a pad element. I<type> is the opcode. I<flags> gives the
4072 eight bits of C<op_flags>. A pad slot is automatically allocated, and
4073 is populated with I<sv>; this function takes ownership of one reference
4076 This function only exists if Perl has been compiled to use ithreads.
4082 Perl_newPADOP(pTHX_ I32 type, I32 flags, SV *sv)
4087 PERL_ARGS_ASSERT_NEWPADOP;
4089 assert((PL_opargs[type] & OA_CLASS_MASK) == OA_SVOP
4090 || (PL_opargs[type] & OA_CLASS_MASK) == OA_PVOP_OR_SVOP
4091 || (PL_opargs[type] & OA_CLASS_MASK) == OA_FILESTATOP);
4093 NewOp(1101, padop, 1, PADOP);
4094 padop->op_type = (OPCODE)type;
4095 padop->op_ppaddr = PL_ppaddr[type];
4096 padop->op_padix = pad_alloc(type, SVs_PADTMP);
4097 SvREFCNT_dec(PAD_SVl(padop->op_padix));
4098 PAD_SETSV(padop->op_padix, sv);
4101 padop->op_next = (OP*)padop;
4102 padop->op_flags = (U8)flags;
4103 if (PL_opargs[type] & OA_RETSCALAR)
4105 if (PL_opargs[type] & OA_TARGET)
4106 padop->op_targ = pad_alloc(type, SVs_PADTMP);
4107 return CHECKOP(type, padop);
4110 #endif /* !USE_ITHREADS */
4113 =for apidoc Am|OP *|newGVOP|I32 type|I32 flags|GV *gv
4115 Constructs, checks, and returns an op of any type that involves an
4116 embedded reference to a GV. I<type> is the opcode. I<flags> gives the
4117 eight bits of C<op_flags>. I<gv> identifies the GV that the op should
4118 reference; calling this function does not transfer ownership of any
4125 Perl_newGVOP(pTHX_ I32 type, I32 flags, GV *gv)
4129 PERL_ARGS_ASSERT_NEWGVOP;
4133 return newPADOP(type, flags, SvREFCNT_inc_simple_NN(gv));
4135 return newSVOP(type, flags, SvREFCNT_inc_simple_NN(gv));
4140 =for apidoc Am|OP *|newPVOP|I32 type|I32 flags|char *pv
4142 Constructs, checks, and returns an op of any type that involves an
4143 embedded C-level pointer (PV). I<type> is the opcode. I<flags> gives
4144 the eight bits of C<op_flags>. I<pv> supplies the C-level pointer, which
4145 must have been allocated using L</PerlMemShared_malloc>; the memory will
4146 be freed when the op is destroyed.
4152 Perl_newPVOP(pTHX_ I32 type, I32 flags, char *pv)
4157 assert((PL_opargs[type] & OA_CLASS_MASK) == OA_PVOP_OR_SVOP
4158 || (PL_opargs[type] & OA_CLASS_MASK) == OA_LOOPEXOP);
4160 NewOp(1101, pvop, 1, PVOP);
4161 pvop->op_type = (OPCODE)type;
4162 pvop->op_ppaddr = PL_ppaddr[type];
4164 pvop->op_next = (OP*)pvop;
4165 pvop->op_flags = (U8)flags;
4166 if (PL_opargs[type] & OA_RETSCALAR)
4168 if (PL_opargs[type] & OA_TARGET)
4169 pvop->op_targ = pad_alloc(type, SVs_PADTMP);
4170 return CHECKOP(type, pvop);
4178 Perl_package(pTHX_ OP *o)
4181 SV *const sv = cSVOPo->op_sv;
4186 PERL_ARGS_ASSERT_PACKAGE;
4188 save_hptr(&PL_curstash);
4189 save_item(PL_curstname);
4191 PL_curstash = gv_stashsv(sv, GV_ADD);
4193 sv_setsv(PL_curstname, sv);
4195 PL_hints |= HINT_BLOCK_SCOPE;
4196 PL_parser->copline = NOLINE;
4197 PL_parser->expect = XSTATE;
4202 if (!PL_madskills) {
4207 pegop = newOP(OP_NULL,0);
4208 op_getmad(o,pegop,'P');
4214 Perl_package_version( pTHX_ OP *v )
4217 U32 savehints = PL_hints;
4218 PERL_ARGS_ASSERT_PACKAGE_VERSION;
4219 PL_hints &= ~HINT_STRICT_VARS;
4220 sv_setsv( GvSV(gv_fetchpvs("VERSION", GV_ADDMULTI, SVt_PV)), cSVOPx(v)->op_sv );
4221 PL_hints = savehints;
4230 Perl_utilize(pTHX_ int aver, I32 floor, OP *version, OP *idop, OP *arg)
4237 OP *pegop = newOP(OP_NULL,0);
4239 SV *use_version = NULL;
4241 PERL_ARGS_ASSERT_UTILIZE;
4243 if (idop->op_type != OP_CONST)
4244 Perl_croak(aTHX_ "Module name must be constant");
4247 op_getmad(idop,pegop,'U');
4252 SV * const vesv = ((SVOP*)version)->op_sv;
4255 op_getmad(version,pegop,'V');
4256 if (!arg && !SvNIOKp(vesv)) {
4263 if (version->op_type != OP_CONST || !SvNIOKp(vesv))
4264 Perl_croak(aTHX_ "Version number must be a constant number");
4266 /* Make copy of idop so we don't free it twice */
4267 pack = newSVOP(OP_CONST, 0, newSVsv(((SVOP*)idop)->op_sv));
4269 /* Fake up a method call to VERSION */
4270 meth = newSVpvs_share("VERSION");
4271 veop = convert(OP_ENTERSUB, OPf_STACKED|OPf_SPECIAL,
4272 op_append_elem(OP_LIST,
4273 op_prepend_elem(OP_LIST, pack, list(version)),
4274 newSVOP(OP_METHOD_NAMED, 0, meth)));
4278 /* Fake up an import/unimport */
4279 if (arg && arg->op_type == OP_STUB) {
4281 op_getmad(arg,pegop,'S');
4282 imop = arg; /* no import on explicit () */
4284 else if (SvNIOKp(((SVOP*)idop)->op_sv)) {
4285 imop = NULL; /* use 5.0; */
4287 use_version = ((SVOP*)idop)->op_sv;
4289 idop->op_private |= OPpCONST_NOVER;
4295 op_getmad(arg,pegop,'A');
4297 /* Make copy of idop so we don't free it twice */
4298 pack = newSVOP(OP_CONST, 0, newSVsv(((SVOP*)idop)->op_sv));
4300 /* Fake up a method call to import/unimport */
4302 ? newSVpvs_share("import") : newSVpvs_share("unimport");
4303 imop = convert(OP_ENTERSUB, OPf_STACKED|OPf_SPECIAL,
4304 op_append_elem(OP_LIST,
4305 op_prepend_elem(OP_LIST, pack, list(arg)),
4306 newSVOP(OP_METHOD_NAMED, 0, meth)));
4309 /* Fake up the BEGIN {}, which does its thing immediately. */
4311 newSVOP(OP_CONST, 0, newSVpvs_share("BEGIN")),
4314 op_append_elem(OP_LINESEQ,
4315 op_append_elem(OP_LINESEQ,
4316 newSTATEOP(0, NULL, newUNOP(OP_REQUIRE, 0, idop)),
4317 newSTATEOP(0, NULL, veop)),
4318 newSTATEOP(0, NULL, imop) ));
4321 /* If we request a version >= 5.9.5, load feature.pm with the
4322 * feature bundle that corresponds to the required version. */
4323 use_version = sv_2mortal(new_version(use_version));
4325 if (vcmp(use_version,
4326 sv_2mortal(upg_version(newSVnv(5.009005), FALSE))) >= 0) {
4327 SV *const importsv = vnormal(use_version);
4328 *SvPVX_mutable(importsv) = ':';
4329 ENTER_with_name("load_feature");
4330 Perl_load_module(aTHX_ 0, newSVpvs("feature"), NULL, importsv, NULL);
4331 LEAVE_with_name("load_feature");
4333 /* If a version >= 5.11.0 is requested, strictures are on by default! */
4334 if (vcmp(use_version,
4335 sv_2mortal(upg_version(newSVnv(5.011000), FALSE))) >= 0) {
4336 PL_hints |= (HINT_STRICT_REFS | HINT_STRICT_SUBS | HINT_STRICT_VARS);
4340 /* The "did you use incorrect case?" warning used to be here.
4341 * The problem is that on case-insensitive filesystems one
4342 * might get false positives for "use" (and "require"):
4343 * "use Strict" or "require CARP" will work. This causes
4344 * portability problems for the script: in case-strict
4345 * filesystems the script will stop working.
4347 * The "incorrect case" warning checked whether "use Foo"
4348 * imported "Foo" to your namespace, but that is wrong, too:
4349 * there is no requirement nor promise in the language that
4350 * a Foo.pm should or would contain anything in package "Foo".
4352 * There is very little Configure-wise that can be done, either:
4353 * the case-sensitivity of the build filesystem of Perl does not
4354 * help in guessing the case-sensitivity of the runtime environment.
4357 PL_hints |= HINT_BLOCK_SCOPE;
4358 PL_parser->copline = NOLINE;
4359 PL_parser->expect = XSTATE;
4360 PL_cop_seqmax++; /* Purely for B::*'s benefit */
4363 if (!PL_madskills) {
4364 /* FIXME - don't allocate pegop if !PL_madskills */
4373 =head1 Embedding Functions
4375 =for apidoc load_module
4377 Loads the module whose name is pointed to by the string part of name.
4378 Note that the actual module name, not its filename, should be given.
4379 Eg, "Foo::Bar" instead of "Foo/Bar.pm". flags can be any of
4380 PERL_LOADMOD_DENY, PERL_LOADMOD_NOIMPORT, or PERL_LOADMOD_IMPORT_OPS
4381 (or 0 for no flags). ver, if specified, provides version semantics
4382 similar to C<use Foo::Bar VERSION>. The optional trailing SV*
4383 arguments can be used to specify arguments to the module's import()
4384 method, similar to C<use Foo::Bar VERSION LIST>. They must be
4385 terminated with a final NULL pointer. Note that this list can only
4386 be omitted when the PERL_LOADMOD_NOIMPORT flag has been used.
4387 Otherwise at least a single NULL pointer to designate the default
4388 import list is required.
4393 Perl_load_module(pTHX_ U32 flags, SV *name, SV *ver, ...)
4397 PERL_ARGS_ASSERT_LOAD_MODULE;
4399 va_start(args, ver);
4400 vload_module(flags, name, ver, &args);
4404 #ifdef PERL_IMPLICIT_CONTEXT
4406 Perl_load_module_nocontext(U32 flags, SV *name, SV *ver, ...)
4410 PERL_ARGS_ASSERT_LOAD_MODULE_NOCONTEXT;
4411 va_start(args, ver);
4412 vload_module(flags, name, ver, &args);
4418 Perl_vload_module(pTHX_ U32 flags, SV *name, SV *ver, va_list *args)
4422 OP * const modname = newSVOP(OP_CONST, 0, name);
4424 PERL_ARGS_ASSERT_VLOAD_MODULE;
4426 modname->op_private |= OPpCONST_BARE;
4428 veop = newSVOP(OP_CONST, 0, ver);
4432 if (flags & PERL_LOADMOD_NOIMPORT) {
4433 imop = sawparens(newNULLLIST());
4435 else if (flags & PERL_LOADMOD_IMPORT_OPS) {
4436 imop = va_arg(*args, OP*);
4441 sv = va_arg(*args, SV*);
4443 imop = op_append_elem(OP_LIST, imop, newSVOP(OP_CONST, 0, sv));
4444 sv = va_arg(*args, SV*);
4448 /* utilize() fakes up a BEGIN { require ..; import ... }, so make sure
4449 * that it has a PL_parser to play with while doing that, and also
4450 * that it doesn't mess with any existing parser, by creating a tmp
4451 * new parser with lex_start(). This won't actually be used for much,
4452 * since pp_require() will create another parser for the real work. */
4455 SAVEVPTR(PL_curcop);
4456 lex_start(NULL, NULL, 0);
4457 utilize(!(flags & PERL_LOADMOD_DENY), start_subparse(FALSE, 0),
4458 veop, modname, imop);
4463 Perl_dofile(pTHX_ OP *term, I32 force_builtin)
4469 PERL_ARGS_ASSERT_DOFILE;
4471 if (!force_builtin) {
4472 gv = gv_fetchpvs("do", GV_NOTQUAL, SVt_PVCV);
4473 if (!(gv && GvCVu(gv) && GvIMPORTED_CV(gv))) {
4474 GV * const * const gvp = (GV**)hv_fetchs(PL_globalstash, "do", FALSE);
4475 gv = gvp ? *gvp : NULL;
4479 if (gv && GvCVu(gv) && GvIMPORTED_CV(gv)) {
4480 doop = ck_subr(newUNOP(OP_ENTERSUB, OPf_STACKED,
4481 op_append_elem(OP_LIST, term,
4482 scalar(newUNOP(OP_RV2CV, 0,
4483 newGVOP(OP_GV, 0, gv))))));
4486 doop = newUNOP(OP_DOFILE, 0, scalar(term));
4492 =head1 Optree construction
4494 =for apidoc Am|OP *|newSLICEOP|I32 flags|OP *subscript|OP *listval
4496 Constructs, checks, and returns an C<lslice> (list slice) op. I<flags>
4497 gives the eight bits of C<op_flags>, except that C<OPf_KIDS> will
4498 be set automatically, and, shifted up eight bits, the eight bits of
4499 C<op_private>, except that the bit with value 1 or 2 is automatically
4500 set as required. I<listval> and I<subscript> supply the parameters of
4501 the slice; they are consumed by this function and become part of the
4502 constructed op tree.
4508 Perl_newSLICEOP(pTHX_ I32 flags, OP *subscript, OP *listval)
4510 return newBINOP(OP_LSLICE, flags,
4511 list(force_list(subscript)),
4512 list(force_list(listval)) );
4516 S_is_list_assignment(pTHX_ register const OP *o)
4524 if ((o->op_type == OP_NULL) && (o->op_flags & OPf_KIDS))
4525 o = cUNOPo->op_first;
4527 flags = o->op_flags;
4529 if (type == OP_COND_EXPR) {
4530 const I32 t = is_list_assignment(cLOGOPo->op_first->op_sibling);
4531 const I32 f = is_list_assignment(cLOGOPo->op_first->op_sibling->op_sibling);
4536 yyerror("Assignment to both a list and a scalar");
4540 if (type == OP_LIST &&
4541 (flags & OPf_WANT) == OPf_WANT_SCALAR &&
4542 o->op_private & OPpLVAL_INTRO)
4545 if (type == OP_LIST || flags & OPf_PARENS ||
4546 type == OP_RV2AV || type == OP_RV2HV ||
4547 type == OP_ASLICE || type == OP_HSLICE)
4550 if (type == OP_PADAV || type == OP_PADHV)
4553 if (type == OP_RV2SV)
4560 =for apidoc Am|OP *|newASSIGNOP|I32 flags|OP *left|I32 optype|OP *right
4562 Constructs, checks, and returns an assignment op. I<left> and I<right>
4563 supply the parameters of the assignment; they are consumed by this
4564 function and become part of the constructed op tree.
4566 If I<optype> is C<OP_ANDASSIGN>, C<OP_ORASSIGN>, or C<OP_DORASSIGN>, then
4567 a suitable conditional optree is constructed. If I<optype> is the opcode
4568 of a binary operator, such as C<OP_BIT_OR>, then an op is constructed that
4569 performs the binary operation and assigns the result to the left argument.
4570 Either way, if I<optype> is non-zero then I<flags> has no effect.
4572 If I<optype> is zero, then a plain scalar or list assignment is
4573 constructed. Which type of assignment it is is automatically determined.
4574 I<flags> gives the eight bits of C<op_flags>, except that C<OPf_KIDS>
4575 will be set automatically, and, shifted up eight bits, the eight bits
4576 of C<op_private>, except that the bit with value 1 or 2 is automatically
4583 Perl_newASSIGNOP(pTHX_ I32 flags, OP *left, I32 optype, OP *right)
4589 if (optype == OP_ANDASSIGN || optype == OP_ORASSIGN || optype == OP_DORASSIGN) {
4590 return newLOGOP(optype, 0,
4591 op_lvalue(scalar(left), optype),
4592 newUNOP(OP_SASSIGN, 0, scalar(right)));
4595 return newBINOP(optype, OPf_STACKED,
4596 op_lvalue(scalar(left), optype), scalar(right));
4600 if (is_list_assignment(left)) {
4601 static const char no_list_state[] = "Initialization of state variables"
4602 " in list context currently forbidden";
4604 bool maybe_common_vars = TRUE;
4607 /* Grandfathering $[ assignment here. Bletch.*/
4608 /* Only simple assignments like C<< ($[) = 1 >> are allowed */
4609 PL_eval_start = (left->op_type == OP_CONST) ? right : NULL;
4610 left = op_lvalue(left, OP_AASSIGN);
4613 else if (left->op_type == OP_CONST) {
4614 deprecate("assignment to $[");
4616 /* Result of assignment is always 1 (or we'd be dead already) */
4617 return newSVOP(OP_CONST, 0, newSViv(1));
4619 curop = list(force_list(left));
4620 o = newBINOP(OP_AASSIGN, flags, list(force_list(right)), curop);
4621 o->op_private = (U8)(0 | (flags >> 8));
4623 if ((left->op_type == OP_LIST
4624 || (left->op_type == OP_NULL && left->op_targ == OP_LIST)))
4626 OP* lop = ((LISTOP*)left)->op_first;
4627 maybe_common_vars = FALSE;
4629 if (lop->op_type == OP_PADSV ||
4630 lop->op_type == OP_PADAV ||
4631 lop->op_type == OP_PADHV ||
4632 lop->op_type == OP_PADANY) {
4633 if (!(lop->op_private & OPpLVAL_INTRO))
4634 maybe_common_vars = TRUE;
4636 if (lop->op_private & OPpPAD_STATE) {
4637 if (left->op_private & OPpLVAL_INTRO) {
4638 /* Each variable in state($a, $b, $c) = ... */
4641 /* Each state variable in
4642 (state $a, my $b, our $c, $d, undef) = ... */
4644 yyerror(no_list_state);
4646 /* Each my variable in
4647 (state $a, my $b, our $c, $d, undef) = ... */
4649 } else if (lop->op_type == OP_UNDEF ||
4650 lop->op_type == OP_PUSHMARK) {
4651 /* undef may be interesting in
4652 (state $a, undef, state $c) */
4654 /* Other ops in the list. */
4655 maybe_common_vars = TRUE;
4657 lop = lop->op_sibling;
4660 else if ((left->op_private & OPpLVAL_INTRO)
4661 && ( left->op_type == OP_PADSV
4662 || left->op_type == OP_PADAV
4663 || left->op_type == OP_PADHV
4664 || left->op_type == OP_PADANY))
4666 if (left->op_type == OP_PADSV) maybe_common_vars = FALSE;
4667 if (left->op_private & OPpPAD_STATE) {
4668 /* All single variable list context state assignments, hence
4678 yyerror(no_list_state);
4682 /* PL_generation sorcery:
4683 * an assignment like ($a,$b) = ($c,$d) is easier than
4684 * ($a,$b) = ($c,$a), since there is no need for temporary vars.
4685 * To detect whether there are common vars, the global var
4686 * PL_generation is incremented for each assign op we compile.
4687 * Then, while compiling the assign op, we run through all the
4688 * variables on both sides of the assignment, setting a spare slot
4689 * in each of them to PL_generation. If any of them already have
4690 * that value, we know we've got commonality. We could use a
4691 * single bit marker, but then we'd have to make 2 passes, first
4692 * to clear the flag, then to test and set it. To find somewhere
4693 * to store these values, evil chicanery is done with SvUVX().
4696 if (maybe_common_vars) {
4699 for (curop = LINKLIST(o); curop != o; curop = LINKLIST(curop)) {
4700 if (PL_opargs[curop->op_type] & OA_DANGEROUS) {
4701 if (curop->op_type == OP_GV) {
4702 GV *gv = cGVOPx_gv(curop);
4704 || (int)GvASSIGN_GENERATION(gv) == PL_generation)
4706 GvASSIGN_GENERATION_set(gv, PL_generation);
4708 else if (curop->op_type == OP_PADSV ||
4709 curop->op_type == OP_PADAV ||
4710 curop->op_type == OP_PADHV ||
4711 curop->op_type == OP_PADANY)
4713 if (PAD_COMPNAME_GEN(curop->op_targ)
4714 == (STRLEN)PL_generation)
4716 PAD_COMPNAME_GEN_set(curop->op_targ, PL_generation);
4719 else if (curop->op_type == OP_RV2CV)
4721 else if (curop->op_type == OP_RV2SV ||
4722 curop->op_type == OP_RV2AV ||
4723 curop->op_type == OP_RV2HV ||
4724 curop->op_type == OP_RV2GV) {
4725 if (lastop->op_type != OP_GV) /* funny deref? */
4728 else if (curop->op_type == OP_PUSHRE) {
4730 if (((PMOP*)curop)->op_pmreplrootu.op_pmtargetoff) {
4731 GV *const gv = MUTABLE_GV(PAD_SVl(((PMOP*)curop)->op_pmreplrootu.op_pmtargetoff));
4733 || (int)GvASSIGN_GENERATION(gv) == PL_generation)
4735 GvASSIGN_GENERATION_set(gv, PL_generation);
4739 = ((PMOP*)curop)->op_pmreplrootu.op_pmtargetgv;
4742 || (int)GvASSIGN_GENERATION(gv) == PL_generation)
4744 GvASSIGN_GENERATION_set(gv, PL_generation);
4754 o->op_private |= OPpASSIGN_COMMON;
4757 if (right && right->op_type == OP_SPLIT && !PL_madskills) {
4758 OP* tmpop = ((LISTOP*)right)->op_first;
4759 if (tmpop && (tmpop->op_type == OP_PUSHRE)) {
4760 PMOP * const pm = (PMOP*)tmpop;
4761 if (left->op_type == OP_RV2AV &&
4762 !(left->op_private & OPpLVAL_INTRO) &&
4763 !(o->op_private & OPpASSIGN_COMMON) )
4765 tmpop = ((UNOP*)left)->op_first;
4766 if (tmpop->op_type == OP_GV
4768 && !pm->op_pmreplrootu.op_pmtargetoff
4770 && !pm->op_pmreplrootu.op_pmtargetgv
4774 pm->op_pmreplrootu.op_pmtargetoff
4775 = cPADOPx(tmpop)->op_padix;
4776 cPADOPx(tmpop)->op_padix = 0; /* steal it */
4778 pm->op_pmreplrootu.op_pmtargetgv
4779 = MUTABLE_GV(cSVOPx(tmpop)->op_sv);
4780 cSVOPx(tmpop)->op_sv = NULL; /* steal it */
4782 pm->op_pmflags |= PMf_ONCE;
4783 tmpop = cUNOPo->op_first; /* to list (nulled) */
4784 tmpop = ((UNOP*)tmpop)->op_first; /* to pushmark */
4785 tmpop->op_sibling = NULL; /* don't free split */
4786 right->op_next = tmpop->op_next; /* fix starting loc */
4787 op_free(o); /* blow off assign */
4788 right->op_flags &= ~OPf_WANT;
4789 /* "I don't know and I don't care." */
4794 if (PL_modcount < RETURN_UNLIMITED_NUMBER &&
4795 ((LISTOP*)right)->op_last->op_type == OP_CONST)
4797 SV *sv = ((SVOP*)((LISTOP*)right)->op_last)->op_sv;
4798 if (SvIOK(sv) && SvIVX(sv) == 0)
4799 sv_setiv(sv, PL_modcount+1);
4807 right = newOP(OP_UNDEF, 0);
4808 if (right->op_type == OP_READLINE) {
4809 right->op_flags |= OPf_STACKED;
4810 return newBINOP(OP_NULL, flags, op_lvalue(scalar(left), OP_SASSIGN),
4814 PL_eval_start = right; /* Grandfathering $[ assignment here. Bletch.*/
4815 o = newBINOP(OP_SASSIGN, flags,
4816 scalar(right), op_lvalue(scalar(left), OP_SASSIGN) );
4820 if (!PL_madskills) { /* assignment to $[ is ignored when making a mad dump */
4821 deprecate("assignment to $[");
4823 o = newSVOP(OP_CONST, 0, newSViv(CopARYBASE_get(&PL_compiling)));
4824 o->op_private |= OPpCONST_ARYBASE;
4832 =for apidoc Am|OP *|newSTATEOP|I32 flags|char *label|OP *o