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"
108 #define CALL_PEEP(o) PL_peepp(aTHX_ o)
109 #define CALL_RPEEP(o) PL_rpeepp(aTHX_ o)
110 #define CALL_OPFREEHOOK(o) if (PL_opfreehook) PL_opfreehook(aTHX_ o)
112 /* See the explanatory comments above struct opslab in op.h. */
114 #ifdef PERL_DEBUG_READONLY_OPS
115 # define PERL_SLAB_SIZE 128
116 # define PERL_MAX_SLAB_SIZE 4096
117 # include <sys/mman.h>
120 #ifndef PERL_SLAB_SIZE
121 # define PERL_SLAB_SIZE 64
123 #ifndef PERL_MAX_SLAB_SIZE
124 # define PERL_MAX_SLAB_SIZE 2048
127 /* rounds up to nearest pointer */
128 #define SIZE_TO_PSIZE(x) (((x) + sizeof(I32 *) - 1)/sizeof(I32 *))
129 #define DIFF(o,p) ((size_t)((I32 **)(p) - (I32**)(o)))
132 S_new_slab(pTHX_ size_t sz)
134 #ifdef PERL_DEBUG_READONLY_OPS
135 OPSLAB *slab = (OPSLAB *) mmap(0, sz * sizeof(I32 *),
136 PROT_READ|PROT_WRITE,
137 MAP_ANON|MAP_PRIVATE, -1, 0);
138 DEBUG_m(PerlIO_printf(Perl_debug_log, "mapped %lu at %p\n",
139 (unsigned long) sz, slab));
140 if (slab == MAP_FAILED) {
141 perror("mmap failed");
144 slab->opslab_size = (U16)sz;
146 OPSLAB *slab = (OPSLAB *)PerlMemShared_calloc(sz, sizeof(I32 *));
148 slab->opslab_first = (OPSLOT *)((I32 **)slab + sz - 1);
152 /* requires double parens and aTHX_ */
153 #define DEBUG_S_warn(args) \
155 PerlIO_printf(Perl_debug_log, "%s", SvPVx_nolen(Perl_mess args)) \
159 Perl_Slab_Alloc(pTHX_ size_t sz)
168 if (!PL_compcv || CvROOT(PL_compcv)
169 || (CvSTART(PL_compcv) && !CvSLABBED(PL_compcv)))
170 return PerlMemShared_calloc(1, sz);
172 if (!CvSTART(PL_compcv)) { /* sneak it in here */
174 (OP *)(slab = S_new_slab(aTHX_ PERL_SLAB_SIZE));
175 CvSLABBED_on(PL_compcv);
176 slab->opslab_refcnt = 2; /* one for the CV; one for the new OP */
178 else ++(slab = (OPSLAB *)CvSTART(PL_compcv))->opslab_refcnt;
180 opsz = SIZE_TO_PSIZE(sz);
181 sz = opsz + OPSLOT_HEADER_P;
183 if (slab->opslab_freed) {
184 OP **too = &slab->opslab_freed;
186 DEBUG_S_warn((aTHX_ "found free op at %p, slab %p", o, slab));
187 while (o && DIFF(OpSLOT(o), OpSLOT(o)->opslot_next) < sz) {
188 DEBUG_S_warn((aTHX_ "Alas! too small"));
189 o = *(too = &o->op_next);
190 if (o) { DEBUG_S_warn((aTHX_ "found another free op at %p", o)); }
194 Zero(o, opsz, I32 *);
200 #define INIT_OPSLOT \
201 slot->opslot_slab = slab; \
202 slot->opslot_next = slab2->opslab_first; \
203 slab2->opslab_first = slot; \
204 o = &slot->opslot_op; \
207 /* The partially-filled slab is next in the chain. */
208 slab2 = slab->opslab_next ? slab->opslab_next : slab;
209 if ((space = DIFF(&slab2->opslab_slots, slab2->opslab_first)) < sz) {
210 /* Remaining space is too small. */
212 /* If we can fit a BASEOP, add it to the free chain, so as not
214 if (space >= SIZE_TO_PSIZE(sizeof(OP)) + OPSLOT_HEADER_P) {
215 slot = &slab2->opslab_slots;
217 o->op_type = OP_FREED;
218 o->op_next = slab->opslab_freed;
219 slab->opslab_freed = o;
222 /* Create a new slab. Make this one twice as big. */
223 slot = slab2->opslab_first;
224 while (slot->opslot_next) slot = slot->opslot_next;
225 slab2 = S_new_slab(aTHX_
226 (DIFF(slab2, slot)+1)*2 > PERL_MAX_SLAB_SIZE
228 : (DIFF(slab2, slot)+1)*2);
229 slab2->opslab_next = slab->opslab_next;
230 slab->opslab_next = slab2;
232 assert(DIFF(&slab2->opslab_slots, slab2->opslab_first) >= sz);
234 /* Create a new op slot */
235 slot = (OPSLOT *)((I32 **)slab2->opslab_first - sz);
236 assert(slot >= &slab2->opslab_slots);
237 if (DIFF(&slab2->opslab_slots, slot)
238 < SIZE_TO_PSIZE(sizeof(OP)) + OPSLOT_HEADER_P)
239 slot = &slab2->opslab_slots;
241 DEBUG_S_warn((aTHX_ "allocating op at %p, slab %p", o, slab));
247 #ifdef PERL_DEBUG_READONLY_OPS
249 Perl_Slab_to_ro(pTHX_ OPSLAB *slab)
251 PERL_ARGS_ASSERT_SLAB_TO_RO;
253 if (slab->opslab_readonly) return;
254 slab->opslab_readonly = 1;
255 for (; slab; slab = slab->opslab_next) {
256 /*DEBUG_U(PerlIO_printf(Perl_debug_log,"mprotect ->ro %lu at %p\n",
257 (unsigned long) slab->opslab_size, slab));*/
258 if (mprotect(slab, slab->opslab_size * sizeof(I32 *), PROT_READ))
259 Perl_warn(aTHX_ "mprotect for %p %lu failed with %d", slab,
260 (unsigned long)slab->opslab_size, errno);
265 Perl_Slab_to_rw(pTHX_ OPSLAB *const slab)
269 PERL_ARGS_ASSERT_SLAB_TO_RW;
271 if (!slab->opslab_readonly) return;
273 for (; slab2; slab2 = slab2->opslab_next) {
274 /*DEBUG_U(PerlIO_printf(Perl_debug_log,"mprotect ->rw %lu at %p\n",
275 (unsigned long) size, slab2));*/
276 if (mprotect((void *)slab2, slab2->opslab_size * sizeof(I32 *),
277 PROT_READ|PROT_WRITE)) {
278 Perl_warn(aTHX_ "mprotect RW for %p %lu failed with %d", slab,
279 (unsigned long)slab2->opslab_size, errno);
282 slab->opslab_readonly = 0;
286 # define Slab_to_rw(op)
289 /* This cannot possibly be right, but it was copied from the old slab
290 allocator, to which it was originally added, without explanation, in
293 # define PerlMemShared PerlMem
297 Perl_Slab_Free(pTHX_ void *op)
300 OP * const o = (OP *)op;
303 PERL_ARGS_ASSERT_SLAB_FREE;
305 if (!o->op_slabbed) {
307 PerlMemShared_free(op);
312 /* If this op is already freed, our refcount will get screwy. */
313 assert(o->op_type != OP_FREED);
314 o->op_type = OP_FREED;
315 o->op_next = slab->opslab_freed;
316 slab->opslab_freed = o;
317 DEBUG_S_warn((aTHX_ "free op at %p, recorded in slab %p", o, slab));
318 OpslabREFCNT_dec_padok(slab);
322 Perl_opslab_free_nopad(pTHX_ OPSLAB *slab)
325 const bool havepad = !!PL_comppad;
326 PERL_ARGS_ASSERT_OPSLAB_FREE_NOPAD;
329 PAD_SAVE_SETNULLPAD();
336 Perl_opslab_free(pTHX_ OPSLAB *slab)
340 PERL_ARGS_ASSERT_OPSLAB_FREE;
341 DEBUG_S_warn((aTHX_ "freeing slab %p", slab));
342 assert(slab->opslab_refcnt == 1);
343 for (; slab; slab = slab2) {
344 slab2 = slab->opslab_next;
346 slab->opslab_refcnt = ~(size_t)0;
348 #ifdef PERL_DEBUG_READONLY_OPS
349 DEBUG_m(PerlIO_printf(Perl_debug_log, "Deallocate slab at %p\n",
351 if (munmap(slab, slab->opslab_size * sizeof(I32 *))) {
352 perror("munmap failed");
356 PerlMemShared_free(slab);
362 Perl_opslab_force_free(pTHX_ OPSLAB *slab)
367 size_t savestack_count = 0;
369 PERL_ARGS_ASSERT_OPSLAB_FORCE_FREE;
372 for (slot = slab2->opslab_first;
374 slot = slot->opslot_next) {
375 if (slot->opslot_op.op_type != OP_FREED
376 && !(slot->opslot_op.op_savefree
382 assert(slot->opslot_op.op_slabbed);
383 op_free(&slot->opslot_op);
384 if (slab->opslab_refcnt == 1) goto free;
387 } while ((slab2 = slab2->opslab_next));
388 /* > 1 because the CV still holds a reference count. */
389 if (slab->opslab_refcnt > 1) { /* still referenced by the savestack */
391 assert(savestack_count == slab->opslab_refcnt-1);
393 /* Remove the CV’s reference count. */
394 slab->opslab_refcnt--;
401 #ifdef PERL_DEBUG_READONLY_OPS
403 Perl_op_refcnt_inc(pTHX_ OP *o)
406 OPSLAB *const slab = o->op_slabbed ? OpSLAB(o) : NULL;
407 if (slab && slab->opslab_readonly) {
420 Perl_op_refcnt_dec(pTHX_ OP *o)
423 OPSLAB *const slab = o->op_slabbed ? OpSLAB(o) : NULL;
425 PERL_ARGS_ASSERT_OP_REFCNT_DEC;
427 if (slab && slab->opslab_readonly) {
429 result = --o->op_targ;
432 result = --o->op_targ;
438 * In the following definition, the ", (OP*)0" is just to make the compiler
439 * think the expression is of the right type: croak actually does a Siglongjmp.
441 #define CHECKOP(type,o) \
442 ((PL_op_mask && PL_op_mask[type]) \
443 ? ( op_free((OP*)o), \
444 Perl_croak(aTHX_ "'%s' trapped by operation mask", PL_op_desc[type]), \
446 : PL_check[type](aTHX_ (OP*)o))
448 #define RETURN_UNLIMITED_NUMBER (PERL_INT_MAX / 2)
450 #define CHANGE_TYPE(o,type) \
452 o->op_type = (OPCODE)type; \
453 o->op_ppaddr = PL_ppaddr[type]; \
457 S_gv_ename(pTHX_ GV *gv)
459 SV* const tmpsv = sv_newmortal();
461 PERL_ARGS_ASSERT_GV_ENAME;
463 gv_efullname3(tmpsv, gv, NULL);
468 S_no_fh_allowed(pTHX_ OP *o)
470 PERL_ARGS_ASSERT_NO_FH_ALLOWED;
472 yyerror(Perl_form(aTHX_ "Missing comma after first argument to %s function",
478 S_too_few_arguments_sv(pTHX_ OP *o, SV *namesv, U32 flags)
480 PERL_ARGS_ASSERT_TOO_FEW_ARGUMENTS_SV;
481 yyerror_pv(Perl_form(aTHX_ "Not enough arguments for %"SVf, namesv),
482 SvUTF8(namesv) | flags);
487 S_too_few_arguments_pv(pTHX_ OP *o, const char* name, U32 flags)
489 PERL_ARGS_ASSERT_TOO_FEW_ARGUMENTS_PV;
490 yyerror_pv(Perl_form(aTHX_ "Not enough arguments for %s", name), flags);
495 S_too_many_arguments_pv(pTHX_ OP *o, const char *name, U32 flags)
497 PERL_ARGS_ASSERT_TOO_MANY_ARGUMENTS_PV;
499 yyerror_pv(Perl_form(aTHX_ "Too many arguments for %s", name), flags);
504 S_too_many_arguments_sv(pTHX_ OP *o, SV *namesv, U32 flags)
506 PERL_ARGS_ASSERT_TOO_MANY_ARGUMENTS_SV;
508 yyerror_pv(Perl_form(aTHX_ "Too many arguments for %"SVf, SVfARG(namesv)),
509 SvUTF8(namesv) | flags);
514 S_bad_type_pv(pTHX_ I32 n, const char *t, const char *name, U32 flags, const OP *kid)
516 PERL_ARGS_ASSERT_BAD_TYPE_PV;
518 yyerror_pv(Perl_form(aTHX_ "Type of arg %d to %s must be %s (not %s)",
519 (int)n, name, t, OP_DESC(kid)), flags);
523 S_bad_type_sv(pTHX_ I32 n, const char *t, SV *namesv, U32 flags, const OP *kid)
525 PERL_ARGS_ASSERT_BAD_TYPE_SV;
527 yyerror_pv(Perl_form(aTHX_ "Type of arg %d to %"SVf" must be %s (not %s)",
528 (int)n, SVfARG(namesv), t, OP_DESC(kid)), SvUTF8(namesv) | flags);
532 S_no_bareword_allowed(pTHX_ OP *o)
534 PERL_ARGS_ASSERT_NO_BAREWORD_ALLOWED;
537 return; /* various ok barewords are hidden in extra OP_NULL */
538 qerror(Perl_mess(aTHX_
539 "Bareword \"%"SVf"\" not allowed while \"strict subs\" in use",
541 o->op_private &= ~OPpCONST_STRICT; /* prevent warning twice about the same OP */
544 /* "register" allocation */
547 Perl_allocmy(pTHX_ const char *const name, const STRLEN len, const U32 flags)
551 const bool is_our = (PL_parser->in_my == KEY_our);
553 PERL_ARGS_ASSERT_ALLOCMY;
555 if (flags & ~SVf_UTF8)
556 Perl_croak(aTHX_ "panic: allocmy illegal flag bits 0x%" UVxf,
559 /* Until we're using the length for real, cross check that we're being
561 assert(strlen(name) == len);
563 /* complain about "my $<special_var>" etc etc */
567 ((flags & SVf_UTF8) && isIDFIRST_utf8((U8 *)name+1)) ||
568 (name[1] == '_' && (*name == '$' || len > 2))))
570 /* name[2] is true if strlen(name) > 2 */
571 if (!(flags & SVf_UTF8 && UTF8_IS_START(name[1]))
572 && (!isPRINT(name[1]) || strchr("\t\n\r\f", name[1]))) {
573 yyerror(Perl_form(aTHX_ "Can't use global %c^%c%.*s in \"%s\"",
574 name[0], toCTRL(name[1]), (int)(len - 2), name + 2,
575 PL_parser->in_my == KEY_state ? "state" : "my"));
577 yyerror_pv(Perl_form(aTHX_ "Can't use global %.*s in \"%s\"", (int) len, name,
578 PL_parser->in_my == KEY_state ? "state" : "my"), flags & SVf_UTF8);
581 else if (len == 2 && name[1] == '_' && !is_our)
582 /* diag_listed_as: Use of my $_ is experimental */
583 Perl_ck_warner_d(aTHX_ packWARN(WARN_EXPERIMENTAL__LEXICAL_TOPIC),
584 "Use of %s $_ is experimental",
585 PL_parser->in_my == KEY_state
589 /* allocate a spare slot and store the name in that slot */
591 off = pad_add_name_pvn(name, len,
592 (is_our ? padadd_OUR :
593 PL_parser->in_my == KEY_state ? padadd_STATE : 0)
594 | ( flags & SVf_UTF8 ? SVf_UTF8 : 0 ),
595 PL_parser->in_my_stash,
597 /* $_ is always in main::, even with our */
598 ? (PL_curstash && !strEQ(name,"$_") ? PL_curstash : PL_defstash)
602 /* anon sub prototypes contains state vars should always be cloned,
603 * otherwise the state var would be shared between anon subs */
605 if (PL_parser->in_my == KEY_state && CvANON(PL_compcv))
606 CvCLONE_on(PL_compcv);
612 =for apidoc alloccopstash
614 Available only under threaded builds, this function allocates an entry in
615 C<PL_stashpad> for the stash passed to it.
622 Perl_alloccopstash(pTHX_ HV *hv)
624 PADOFFSET off = 0, o = 1;
625 bool found_slot = FALSE;
627 PERL_ARGS_ASSERT_ALLOCCOPSTASH;
629 if (PL_stashpad[PL_stashpadix] == hv) return PL_stashpadix;
631 for (; o < PL_stashpadmax; ++o) {
632 if (PL_stashpad[o] == hv) return PL_stashpadix = o;
633 if (!PL_stashpad[o] || SvTYPE(PL_stashpad[o]) != SVt_PVHV)
634 found_slot = TRUE, off = o;
637 Renew(PL_stashpad, PL_stashpadmax + 10, HV *);
638 Zero(PL_stashpad + PL_stashpadmax, 10, HV *);
639 off = PL_stashpadmax;
640 PL_stashpadmax += 10;
643 PL_stashpad[PL_stashpadix = off] = hv;
648 /* free the body of an op without examining its contents.
649 * Always use this rather than FreeOp directly */
652 S_op_destroy(pTHX_ OP *o)
660 Perl_op_free(pTHX_ OP *o)
665 /* Though ops may be freed twice, freeing the op after its slab is a
667 assert(!o || !o->op_slabbed || OpSLAB(o)->opslab_refcnt != ~(size_t)0);
668 /* During the forced freeing of ops after compilation failure, kidops
669 may be freed before their parents. */
670 if (!o || o->op_type == OP_FREED)
674 if (o->op_private & OPpREFCOUNTED) {
685 refcnt = OpREFCNT_dec(o);
688 /* Need to find and remove any pattern match ops from the list
689 we maintain for reset(). */
690 find_and_forget_pmops(o);
700 /* Call the op_free hook if it has been set. Do it now so that it's called
701 * at the right time for refcounted ops, but still before all of the kids
705 if (o->op_flags & OPf_KIDS) {
707 for (kid = cUNOPo->op_first; kid; kid = nextkid) {
708 nextkid = kid->op_sibling; /* Get before next freeing kid */
713 type = (OPCODE)o->op_targ;
716 Slab_to_rw(OpSLAB(o));
719 /* COP* is not cleared by op_clear() so that we may track line
720 * numbers etc even after null() */
721 if (type == OP_NEXTSTATE || type == OP_DBSTATE) {
727 #ifdef DEBUG_LEAKING_SCALARS
734 Perl_op_clear(pTHX_ OP *o)
739 PERL_ARGS_ASSERT_OP_CLEAR;
742 mad_free(o->op_madprop);
747 switch (o->op_type) {
748 case OP_NULL: /* Was holding old type, if any. */
749 if (PL_madskills && o->op_targ != OP_NULL) {
750 o->op_type = (Optype)o->op_targ;
755 case OP_ENTEREVAL: /* Was holding hints. */
759 if (!(o->op_flags & OPf_REF)
760 || (PL_check[o->op_type] != Perl_ck_ftst))
767 GV *gv = (o->op_type == OP_GV || o->op_type == OP_GVSV)
772 /* It's possible during global destruction that the GV is freed
773 before the optree. Whilst the SvREFCNT_inc is happy to bump from
774 0 to 1 on a freed SV, the corresponding SvREFCNT_dec from 1 to 0
775 will trigger an assertion failure, because the entry to sv_clear
776 checks that the scalar is not already freed. A check of for
777 !SvIS_FREED(gv) turns out to be invalid, because during global
778 destruction the reference count can be forced down to zero
779 (with SVf_BREAK set). In which case raising to 1 and then
780 dropping to 0 triggers cleanup before it should happen. I
781 *think* that this might actually be a general, systematic,
782 weakness of the whole idea of SVf_BREAK, in that code *is*
783 allowed to raise and lower references during global destruction,
784 so any *valid* code that happens to do this during global
785 destruction might well trigger premature cleanup. */
786 bool still_valid = gv && SvREFCNT(gv);
789 SvREFCNT_inc_simple_void(gv);
791 if (cPADOPo->op_padix > 0) {
792 /* No GvIN_PAD_off(cGVOPo_gv) here, because other references
793 * may still exist on the pad */
794 pad_swipe(cPADOPo->op_padix, TRUE);
795 cPADOPo->op_padix = 0;
798 SvREFCNT_dec(cSVOPo->op_sv);
799 cSVOPo->op_sv = NULL;
802 int try_downgrade = SvREFCNT(gv) == 2;
805 gv_try_downgrade(gv);
809 case OP_METHOD_NAMED:
812 SvREFCNT_dec(cSVOPo->op_sv);
813 cSVOPo->op_sv = NULL;
816 Even if op_clear does a pad_free for the target of the op,
817 pad_free doesn't actually remove the sv that exists in the pad;
818 instead it lives on. This results in that it could be reused as
819 a target later on when the pad was reallocated.
822 pad_swipe(o->op_targ,1);
832 if (o->op_flags & (OPf_SPECIAL|OPf_STACKED|OPf_KIDS))
837 if (o->op_private & (OPpTRANS_FROM_UTF|OPpTRANS_TO_UTF)) {
838 assert(o->op_type == OP_TRANS || o->op_type == OP_TRANSR);
840 if (cPADOPo->op_padix > 0) {
841 pad_swipe(cPADOPo->op_padix, TRUE);
842 cPADOPo->op_padix = 0;
845 SvREFCNT_dec(cSVOPo->op_sv);
846 cSVOPo->op_sv = NULL;
850 PerlMemShared_free(cPVOPo->op_pv);
851 cPVOPo->op_pv = NULL;
855 op_free(cPMOPo->op_pmreplrootu.op_pmreplroot);
859 if (cPMOPo->op_pmreplrootu.op_pmtargetoff) {
860 /* No GvIN_PAD_off here, because other references may still
861 * exist on the pad */
862 pad_swipe(cPMOPo->op_pmreplrootu.op_pmtargetoff, TRUE);
865 SvREFCNT_dec(MUTABLE_SV(cPMOPo->op_pmreplrootu.op_pmtargetgv));
871 if (!(cPMOPo->op_pmflags & PMf_CODELIST_PRIVATE))
872 op_free(cPMOPo->op_code_list);
873 cPMOPo->op_code_list = NULL;
875 cPMOPo->op_pmreplrootu.op_pmreplroot = NULL;
876 /* we use the same protection as the "SAFE" version of the PM_ macros
877 * here since sv_clean_all might release some PMOPs
878 * after PL_regex_padav has been cleared
879 * and the clearing of PL_regex_padav needs to
880 * happen before sv_clean_all
883 if(PL_regex_pad) { /* We could be in destruction */
884 const IV offset = (cPMOPo)->op_pmoffset;
885 ReREFCNT_dec(PM_GETRE(cPMOPo));
886 PL_regex_pad[offset] = &PL_sv_undef;
887 sv_catpvn_nomg(PL_regex_pad[0], (const char *)&offset,
891 ReREFCNT_dec(PM_GETRE(cPMOPo));
892 PM_SETRE(cPMOPo, NULL);
898 if (o->op_targ > 0) {
899 pad_free(o->op_targ);
905 S_cop_free(pTHX_ COP* cop)
907 PERL_ARGS_ASSERT_COP_FREE;
910 if (! specialWARN(cop->cop_warnings))
911 PerlMemShared_free(cop->cop_warnings);
912 cophh_free(CopHINTHASH_get(cop));
916 S_forget_pmop(pTHX_ PMOP *const o
919 HV * const pmstash = PmopSTASH(o);
921 PERL_ARGS_ASSERT_FORGET_PMOP;
923 if (pmstash && !SvIS_FREED(pmstash) && SvMAGICAL(pmstash)) {
924 MAGIC * const mg = mg_find((const SV *)pmstash, PERL_MAGIC_symtab);
926 PMOP **const array = (PMOP**) mg->mg_ptr;
927 U32 count = mg->mg_len / sizeof(PMOP**);
932 /* Found it. Move the entry at the end to overwrite it. */
933 array[i] = array[--count];
934 mg->mg_len = count * sizeof(PMOP**);
935 /* Could realloc smaller at this point always, but probably
936 not worth it. Probably worth free()ing if we're the
939 Safefree(mg->mg_ptr);
952 S_find_and_forget_pmops(pTHX_ OP *o)
954 PERL_ARGS_ASSERT_FIND_AND_FORGET_PMOPS;
956 if (o->op_flags & OPf_KIDS) {
957 OP *kid = cUNOPo->op_first;
959 switch (kid->op_type) {
964 forget_pmop((PMOP*)kid);
966 find_and_forget_pmops(kid);
967 kid = kid->op_sibling;
973 Perl_op_null(pTHX_ OP *o)
977 PERL_ARGS_ASSERT_OP_NULL;
979 if (o->op_type == OP_NULL)
983 o->op_targ = o->op_type;
984 o->op_type = OP_NULL;
985 o->op_ppaddr = PL_ppaddr[OP_NULL];
989 Perl_op_refcnt_lock(pTHX)
997 Perl_op_refcnt_unlock(pTHX)
1000 PERL_UNUSED_CONTEXT;
1004 /* Contextualizers */
1007 =for apidoc Am|OP *|op_contextualize|OP *o|I32 context
1009 Applies a syntactic context to an op tree representing an expression.
1010 I<o> is the op tree, and I<context> must be C<G_SCALAR>, C<G_ARRAY>,
1011 or C<G_VOID> to specify the context to apply. The modified op tree
1018 Perl_op_contextualize(pTHX_ OP *o, I32 context)
1020 PERL_ARGS_ASSERT_OP_CONTEXTUALIZE;
1022 case G_SCALAR: return scalar(o);
1023 case G_ARRAY: return list(o);
1024 case G_VOID: return scalarvoid(o);
1026 Perl_croak(aTHX_ "panic: op_contextualize bad context %ld",
1033 =head1 Optree Manipulation Functions
1035 =for apidoc Am|OP*|op_linklist|OP *o
1036 This function is the implementation of the L</LINKLIST> macro. It should
1037 not be called directly.
1043 Perl_op_linklist(pTHX_ OP *o)
1047 PERL_ARGS_ASSERT_OP_LINKLIST;
1052 /* establish postfix order */
1053 first = cUNOPo->op_first;
1056 o->op_next = LINKLIST(first);
1059 if (kid->op_sibling) {
1060 kid->op_next = LINKLIST(kid->op_sibling);
1061 kid = kid->op_sibling;
1075 S_scalarkids(pTHX_ OP *o)
1077 if (o && o->op_flags & OPf_KIDS) {
1079 for (kid = cLISTOPo->op_first; kid; kid = kid->op_sibling)
1086 S_scalarboolean(pTHX_ OP *o)
1090 PERL_ARGS_ASSERT_SCALARBOOLEAN;
1092 if (o->op_type == OP_SASSIGN && cBINOPo->op_first->op_type == OP_CONST
1093 && !(cBINOPo->op_first->op_flags & OPf_SPECIAL)) {
1094 if (ckWARN(WARN_SYNTAX)) {
1095 const line_t oldline = CopLINE(PL_curcop);
1097 if (PL_parser && PL_parser->copline != NOLINE) {
1098 /* This ensures that warnings are reported at the first line
1099 of the conditional, not the last. */
1100 CopLINE_set(PL_curcop, PL_parser->copline);
1102 Perl_warner(aTHX_ packWARN(WARN_SYNTAX), "Found = in conditional, should be ==");
1103 CopLINE_set(PL_curcop, oldline);
1110 Perl_scalar(pTHX_ OP *o)
1115 /* assumes no premature commitment */
1116 if (!o || (PL_parser && PL_parser->error_count)
1117 || (o->op_flags & OPf_WANT)
1118 || o->op_type == OP_RETURN)
1123 o->op_flags = (o->op_flags & ~OPf_WANT) | OPf_WANT_SCALAR;
1125 switch (o->op_type) {
1127 scalar(cBINOPo->op_first);
1132 for (kid = cUNOPo->op_first->op_sibling; kid; kid = kid->op_sibling)
1142 if (o->op_flags & OPf_KIDS) {
1143 for (kid = cUNOPo->op_first; kid; kid = kid->op_sibling)
1149 kid = cLISTOPo->op_first;
1151 kid = kid->op_sibling;
1154 OP *sib = kid->op_sibling;
1155 if (sib && kid->op_type != OP_LEAVEWHEN)
1161 PL_curcop = &PL_compiling;
1166 kid = cLISTOPo->op_first;
1169 Perl_ck_warner(aTHX_ packWARN(WARN_VOID), "Useless use of sort in scalar context");
1176 Perl_scalarvoid(pTHX_ OP *o)
1180 SV *useless_sv = NULL;
1181 const char* useless = NULL;
1185 PERL_ARGS_ASSERT_SCALARVOID;
1187 /* trailing mad null ops don't count as "there" for void processing */
1189 o->op_type != OP_NULL &&
1191 o->op_sibling->op_type == OP_NULL)
1194 for (sib = o->op_sibling;
1195 sib && sib->op_type == OP_NULL;
1196 sib = sib->op_sibling) ;
1202 if (o->op_type == OP_NEXTSTATE
1203 || o->op_type == OP_DBSTATE
1204 || (o->op_type == OP_NULL && (o->op_targ == OP_NEXTSTATE
1205 || o->op_targ == OP_DBSTATE)))
1206 PL_curcop = (COP*)o; /* for warning below */
1208 /* assumes no premature commitment */
1209 want = o->op_flags & OPf_WANT;
1210 if ((want && want != OPf_WANT_SCALAR)
1211 || (PL_parser && PL_parser->error_count)
1212 || o->op_type == OP_RETURN || o->op_type == OP_REQUIRE || o->op_type == OP_LEAVEWHEN)
1217 if ((o->op_private & OPpTARGET_MY)
1218 && (PL_opargs[o->op_type] & OA_TARGLEX))/* OPp share the meaning */
1220 return scalar(o); /* As if inside SASSIGN */
1223 o->op_flags = (o->op_flags & ~OPf_WANT) | OPf_WANT_VOID;
1225 switch (o->op_type) {
1227 if (!(PL_opargs[o->op_type] & OA_FOLDCONST))
1231 if (o->op_flags & OPf_STACKED)
1235 if (o->op_private == 4)
1260 case OP_AELEMFAST_LEX:
1279 case OP_GETSOCKNAME:
1280 case OP_GETPEERNAME:
1285 case OP_GETPRIORITY:
1310 if (!(o->op_private & (OPpLVAL_INTRO|OPpOUR_INTRO)))
1311 /* Otherwise it's "Useless use of grep iterator" */
1312 useless = OP_DESC(o);
1316 kid = cLISTOPo->op_first;
1317 if (kid && kid->op_type == OP_PUSHRE
1319 && !((PMOP*)kid)->op_pmreplrootu.op_pmtargetoff)
1321 && !((PMOP*)kid)->op_pmreplrootu.op_pmtargetgv)
1323 useless = OP_DESC(o);
1327 kid = cUNOPo->op_first;
1328 if (kid->op_type != OP_MATCH && kid->op_type != OP_SUBST &&
1329 kid->op_type != OP_TRANS && kid->op_type != OP_TRANSR) {
1332 useless = "negative pattern binding (!~)";
1336 if (cPMOPo->op_pmflags & PMf_NONDESTRUCT)
1337 useless = "non-destructive substitution (s///r)";
1341 useless = "non-destructive transliteration (tr///r)";
1348 if (!(o->op_private & (OPpLVAL_INTRO|OPpOUR_INTRO)) &&
1349 (!o->op_sibling || o->op_sibling->op_type != OP_READLINE))
1350 useless = "a variable";
1355 if (cSVOPo->op_private & OPpCONST_STRICT)
1356 no_bareword_allowed(o);
1358 if (ckWARN(WARN_VOID)) {
1359 /* don't warn on optimised away booleans, eg
1360 * use constant Foo, 5; Foo || print; */
1361 if (cSVOPo->op_private & OPpCONST_SHORTCIRCUIT)
1363 /* the constants 0 and 1 are permitted as they are
1364 conventionally used as dummies in constructs like
1365 1 while some_condition_with_side_effects; */
1366 else if (SvNIOK(sv) && (SvNV(sv) == 0.0 || SvNV(sv) == 1.0))
1368 else if (SvPOK(sv)) {
1369 /* perl4's way of mixing documentation and code
1370 (before the invention of POD) was based on a
1371 trick to mix nroff and perl code. The trick was
1372 built upon these three nroff macros being used in
1373 void context. The pink camel has the details in
1374 the script wrapman near page 319. */
1375 const char * const maybe_macro = SvPVX_const(sv);
1376 if (strnEQ(maybe_macro, "di", 2) ||
1377 strnEQ(maybe_macro, "ds", 2) ||
1378 strnEQ(maybe_macro, "ig", 2))
1381 SV * const dsv = newSVpvs("");
1383 = Perl_newSVpvf(aTHX_
1385 pv_pretty(dsv, maybe_macro,
1386 SvCUR(sv), 32, NULL, NULL,
1388 | PERL_PV_ESCAPE_NOCLEAR
1389 | PERL_PV_ESCAPE_UNI_DETECT));
1390 SvREFCNT_dec_NN(dsv);
1393 else if (SvOK(sv)) {
1394 useless_sv = Perl_newSVpvf(aTHX_ "a constant (%"SVf")", sv);
1397 useless = "a constant (undef)";
1400 op_null(o); /* don't execute or even remember it */
1404 o->op_type = OP_PREINC; /* pre-increment is faster */
1405 o->op_ppaddr = PL_ppaddr[OP_PREINC];
1409 o->op_type = OP_PREDEC; /* pre-decrement is faster */
1410 o->op_ppaddr = PL_ppaddr[OP_PREDEC];
1414 o->op_type = OP_I_PREINC; /* pre-increment is faster */
1415 o->op_ppaddr = PL_ppaddr[OP_I_PREINC];
1419 o->op_type = OP_I_PREDEC; /* pre-decrement is faster */
1420 o->op_ppaddr = PL_ppaddr[OP_I_PREDEC];
1425 UNOP *refgen, *rv2cv;
1428 if ((o->op_private & ~OPpASSIGN_BACKWARDS) != 2)
1431 rv2gv = ((BINOP *)o)->op_last;
1432 if (!rv2gv || rv2gv->op_type != OP_RV2GV)
1435 refgen = (UNOP *)((BINOP *)o)->op_first;
1437 if (!refgen || refgen->op_type != OP_REFGEN)
1440 exlist = (LISTOP *)refgen->op_first;
1441 if (!exlist || exlist->op_type != OP_NULL
1442 || exlist->op_targ != OP_LIST)
1445 if (exlist->op_first->op_type != OP_PUSHMARK)
1448 rv2cv = (UNOP*)exlist->op_last;
1450 if (rv2cv->op_type != OP_RV2CV)
1453 assert ((rv2gv->op_private & OPpDONT_INIT_GV) == 0);
1454 assert ((o->op_private & OPpASSIGN_CV_TO_GV) == 0);
1455 assert ((rv2cv->op_private & OPpMAY_RETURN_CONSTANT) == 0);
1457 o->op_private |= OPpASSIGN_CV_TO_GV;
1458 rv2gv->op_private |= OPpDONT_INIT_GV;
1459 rv2cv->op_private |= OPpMAY_RETURN_CONSTANT;
1471 kid = cLOGOPo->op_first;
1472 if (kid->op_type == OP_NOT
1473 && (kid->op_flags & OPf_KIDS)
1475 if (o->op_type == OP_AND) {
1477 o->op_ppaddr = PL_ppaddr[OP_OR];
1479 o->op_type = OP_AND;
1480 o->op_ppaddr = PL_ppaddr[OP_AND];
1489 for (kid = cUNOPo->op_first->op_sibling; kid; kid = kid->op_sibling)
1494 if (o->op_flags & OPf_STACKED)
1501 if (!(o->op_flags & OPf_KIDS))
1512 for (kid = cLISTOPo->op_first; kid; kid = kid->op_sibling)
1523 /* mortalise it, in case warnings are fatal. */
1524 Perl_ck_warner(aTHX_ packWARN(WARN_VOID),
1525 "Useless use of %"SVf" in void context",
1526 sv_2mortal(useless_sv));
1529 Perl_ck_warner(aTHX_ packWARN(WARN_VOID),
1530 "Useless use of %s in void context",
1537 S_listkids(pTHX_ OP *o)
1539 if (o && o->op_flags & OPf_KIDS) {
1541 for (kid = cLISTOPo->op_first; kid; kid = kid->op_sibling)
1548 Perl_list(pTHX_ OP *o)
1553 /* assumes no premature commitment */
1554 if (!o || (o->op_flags & OPf_WANT)
1555 || (PL_parser && PL_parser->error_count)
1556 || o->op_type == OP_RETURN)
1561 if ((o->op_private & OPpTARGET_MY)
1562 && (PL_opargs[o->op_type] & OA_TARGLEX))/* OPp share the meaning */
1564 return o; /* As if inside SASSIGN */
1567 o->op_flags = (o->op_flags & ~OPf_WANT) | OPf_WANT_LIST;
1569 switch (o->op_type) {
1572 list(cBINOPo->op_first);
1577 for (kid = cUNOPo->op_first->op_sibling; kid; kid = kid->op_sibling)
1585 if (!(o->op_flags & OPf_KIDS))
1587 if (!o->op_next && cUNOPo->op_first->op_type == OP_FLOP) {
1588 list(cBINOPo->op_first);
1589 return gen_constant_list(o);
1596 kid = cLISTOPo->op_first;
1598 kid = kid->op_sibling;
1601 OP *sib = kid->op_sibling;
1602 if (sib && kid->op_type != OP_LEAVEWHEN)
1608 PL_curcop = &PL_compiling;
1612 kid = cLISTOPo->op_first;
1619 S_scalarseq(pTHX_ OP *o)
1623 const OPCODE type = o->op_type;
1625 if (type == OP_LINESEQ || type == OP_SCOPE ||
1626 type == OP_LEAVE || type == OP_LEAVETRY)
1629 for (kid = cLISTOPo->op_first; kid; kid = kid->op_sibling) {
1630 if (kid->op_sibling) {
1634 PL_curcop = &PL_compiling;
1636 o->op_flags &= ~OPf_PARENS;
1637 if (PL_hints & HINT_BLOCK_SCOPE)
1638 o->op_flags |= OPf_PARENS;
1641 o = newOP(OP_STUB, 0);
1646 S_modkids(pTHX_ OP *o, I32 type)
1648 if (o && o->op_flags & OPf_KIDS) {
1650 for (kid = cLISTOPo->op_first; kid; kid = kid->op_sibling)
1651 op_lvalue(kid, type);
1657 =for apidoc finalize_optree
1659 This function finalizes the optree. Should be called directly after
1660 the complete optree is built. It does some additional
1661 checking which can't be done in the normal ck_xxx functions and makes
1662 the tree thread-safe.
1667 Perl_finalize_optree(pTHX_ OP* o)
1669 PERL_ARGS_ASSERT_FINALIZE_OPTREE;
1672 SAVEVPTR(PL_curcop);
1680 S_finalize_op(pTHX_ OP* o)
1682 PERL_ARGS_ASSERT_FINALIZE_OP;
1684 #if defined(PERL_MAD) && defined(USE_ITHREADS)
1686 /* Make sure mad ops are also thread-safe */
1687 MADPROP *mp = o->op_madprop;
1689 if (mp->mad_type == MAD_OP && mp->mad_vlen) {
1690 OP *prop_op = (OP *) mp->mad_val;
1691 /* We only need "Relocate sv to the pad for thread safety.", but this
1692 easiest way to make sure it traverses everything */
1693 if (prop_op->op_type == OP_CONST)
1694 cSVOPx(prop_op)->op_private &= ~OPpCONST_STRICT;
1695 finalize_op(prop_op);
1702 switch (o->op_type) {
1705 PL_curcop = ((COP*)o); /* for warnings */
1709 && (o->op_sibling->op_type == OP_NEXTSTATE || o->op_sibling->op_type == OP_DBSTATE)
1710 && ckWARN(WARN_SYNTAX))
1712 if (o->op_sibling->op_sibling) {
1713 const OPCODE type = o->op_sibling->op_sibling->op_type;
1714 if (type != OP_EXIT && type != OP_WARN && type != OP_DIE) {
1715 const line_t oldline = CopLINE(PL_curcop);
1716 CopLINE_set(PL_curcop, CopLINE((COP*)o->op_sibling));
1717 Perl_warner(aTHX_ packWARN(WARN_EXEC),
1718 "Statement unlikely to be reached");
1719 Perl_warner(aTHX_ packWARN(WARN_EXEC),
1720 "\t(Maybe you meant system() when you said exec()?)\n");
1721 CopLINE_set(PL_curcop, oldline);
1728 if ((o->op_private & OPpEARLY_CV) && ckWARN(WARN_PROTOTYPE)) {
1729 GV * const gv = cGVOPo_gv;
1730 if (SvTYPE(gv) == SVt_PVGV && GvCV(gv) && SvPVX_const(GvCV(gv))) {
1731 /* XXX could check prototype here instead of just carping */
1732 SV * const sv = sv_newmortal();
1733 gv_efullname3(sv, gv, NULL);
1734 Perl_warner(aTHX_ packWARN(WARN_PROTOTYPE),
1735 "%"SVf"() called too early to check prototype",
1742 if (cSVOPo->op_private & OPpCONST_STRICT)
1743 no_bareword_allowed(o);
1747 case OP_METHOD_NAMED:
1748 /* Relocate sv to the pad for thread safety.
1749 * Despite being a "constant", the SV is written to,
1750 * for reference counts, sv_upgrade() etc. */
1751 if (cSVOPo->op_sv) {
1752 const PADOFFSET ix = pad_alloc(OP_CONST, SVs_PADTMP);
1753 if (o->op_type != OP_METHOD_NAMED &&
1754 (SvPADTMP(cSVOPo->op_sv) || SvPADMY(cSVOPo->op_sv)))
1756 /* If op_sv is already a PADTMP/MY then it is being used by
1757 * some pad, so make a copy. */
1758 sv_setsv(PAD_SVl(ix),cSVOPo->op_sv);
1759 if (!SvIsCOW(PAD_SVl(ix))) SvREADONLY_on(PAD_SVl(ix));
1760 SvREFCNT_dec(cSVOPo->op_sv);
1762 else if (o->op_type != OP_METHOD_NAMED
1763 && cSVOPo->op_sv == &PL_sv_undef) {
1764 /* PL_sv_undef is hack - it's unsafe to store it in the
1765 AV that is the pad, because av_fetch treats values of
1766 PL_sv_undef as a "free" AV entry and will merrily
1767 replace them with a new SV, causing pad_alloc to think
1768 that this pad slot is free. (When, clearly, it is not)
1770 SvOK_off(PAD_SVl(ix));
1771 SvPADTMP_on(PAD_SVl(ix));
1772 SvREADONLY_on(PAD_SVl(ix));
1775 SvREFCNT_dec(PAD_SVl(ix));
1776 SvPADTMP_on(cSVOPo->op_sv);
1777 PAD_SETSV(ix, cSVOPo->op_sv);
1778 /* XXX I don't know how this isn't readonly already. */
1779 if (!SvIsCOW(PAD_SVl(ix))) SvREADONLY_on(PAD_SVl(ix));
1781 cSVOPo->op_sv = NULL;
1792 const char *key = NULL;
1795 if (((BINOP*)o)->op_last->op_type != OP_CONST)
1798 /* Make the CONST have a shared SV */
1799 svp = cSVOPx_svp(((BINOP*)o)->op_last);
1800 if ((!SvIsCOW(sv = *svp))
1801 && SvTYPE(sv) < SVt_PVMG && !SvROK(sv)) {
1802 key = SvPV_const(sv, keylen);
1803 lexname = newSVpvn_share(key,
1804 SvUTF8(sv) ? -(I32)keylen : (I32)keylen,
1806 SvREFCNT_dec_NN(sv);
1810 if ((o->op_private & (OPpLVAL_INTRO)))
1813 rop = (UNOP*)((BINOP*)o)->op_first;
1814 if (rop->op_type != OP_RV2HV || rop->op_first->op_type != OP_PADSV)
1816 lexname = *av_fetch(PL_comppad_name, rop->op_first->op_targ, TRUE);
1817 if (!SvPAD_TYPED(lexname))
1819 fields = (GV**)hv_fetchs(SvSTASH(lexname), "FIELDS", FALSE);
1820 if (!fields || !GvHV(*fields))
1822 key = SvPV_const(*svp, keylen);
1823 if (!hv_fetch(GvHV(*fields), key,
1824 SvUTF8(*svp) ? -(I32)keylen : (I32)keylen, FALSE)) {
1825 Perl_croak(aTHX_ "No such class field \"%"SVf"\" "
1826 "in variable %"SVf" of type %"HEKf,
1827 SVfARG(*svp), SVfARG(lexname),
1828 HEKfARG(HvNAME_HEK(SvSTASH(lexname))));
1840 SVOP *first_key_op, *key_op;
1842 if ((o->op_private & (OPpLVAL_INTRO))
1843 /* I bet there's always a pushmark... */
1844 || ((LISTOP*)o)->op_first->op_sibling->op_type != OP_LIST)
1845 /* hmmm, no optimization if list contains only one key. */
1847 rop = (UNOP*)((LISTOP*)o)->op_last;
1848 if (rop->op_type != OP_RV2HV)
1850 if (rop->op_first->op_type == OP_PADSV)
1851 /* @$hash{qw(keys here)} */
1852 rop = (UNOP*)rop->op_first;
1854 /* @{$hash}{qw(keys here)} */
1855 if (rop->op_first->op_type == OP_SCOPE
1856 && cLISTOPx(rop->op_first)->op_last->op_type == OP_PADSV)
1858 rop = (UNOP*)cLISTOPx(rop->op_first)->op_last;
1864 lexname = *av_fetch(PL_comppad_name, rop->op_targ, TRUE);
1865 if (!SvPAD_TYPED(lexname))
1867 fields = (GV**)hv_fetchs(SvSTASH(lexname), "FIELDS", FALSE);
1868 if (!fields || !GvHV(*fields))
1870 /* Again guessing that the pushmark can be jumped over.... */
1871 first_key_op = (SVOP*)((LISTOP*)((LISTOP*)o)->op_first->op_sibling)
1872 ->op_first->op_sibling;
1873 for (key_op = first_key_op; key_op;
1874 key_op = (SVOP*)key_op->op_sibling) {
1875 if (key_op->op_type != OP_CONST)
1877 svp = cSVOPx_svp(key_op);
1878 key = SvPV_const(*svp, keylen);
1879 if (!hv_fetch(GvHV(*fields), key,
1880 SvUTF8(*svp) ? -(I32)keylen : (I32)keylen, FALSE)) {
1881 Perl_croak(aTHX_ "No such class field \"%"SVf"\" "
1882 "in variable %"SVf" of type %"HEKf,
1883 SVfARG(*svp), SVfARG(lexname),
1884 HEKfARG(HvNAME_HEK(SvSTASH(lexname))));
1891 if (cPMOPo->op_pmreplrootu.op_pmreplroot)
1892 finalize_op(cPMOPo->op_pmreplrootu.op_pmreplroot);
1899 if (o->op_flags & OPf_KIDS) {
1901 for (kid = cUNOPo->op_first; kid; kid = kid->op_sibling)
1907 =for apidoc Amx|OP *|op_lvalue|OP *o|I32 type
1909 Propagate lvalue ("modifiable") context to an op and its children.
1910 I<type> represents the context type, roughly based on the type of op that
1911 would do the modifying, although C<local()> is represented by OP_NULL,
1912 because it has no op type of its own (it is signalled by a flag on
1915 This function detects things that can't be modified, such as C<$x+1>, and
1916 generates errors for them. For example, C<$x+1 = 2> would cause it to be
1917 called with an op of type OP_ADD and a C<type> argument of OP_SASSIGN.
1919 It also flags things that need to behave specially in an lvalue context,
1920 such as C<$$x = 5> which might have to vivify a reference in C<$x>.
1926 Perl_op_lvalue_flags(pTHX_ OP *o, I32 type, U32 flags)
1930 /* -1 = error on localize, 0 = ignore localize, 1 = ok to localize */
1933 if (!o || (PL_parser && PL_parser->error_count))
1936 if ((o->op_private & OPpTARGET_MY)
1937 && (PL_opargs[o->op_type] & OA_TARGLEX))/* OPp share the meaning */
1942 assert( (o->op_flags & OPf_WANT) != OPf_WANT_VOID );
1944 if (type == OP_PRTF || type == OP_SPRINTF) type = OP_ENTERSUB;
1946 switch (o->op_type) {
1951 if ((o->op_flags & OPf_PARENS) || PL_madskills)
1955 if ((type == OP_UNDEF || type == OP_REFGEN || type == OP_LOCK) &&
1956 !(o->op_flags & OPf_STACKED)) {
1957 o->op_type = OP_RV2CV; /* entersub => rv2cv */
1958 /* Both ENTERSUB and RV2CV use this bit, but for different pur-
1959 poses, so we need it clear. */
1960 o->op_private &= ~1;
1961 o->op_ppaddr = PL_ppaddr[OP_RV2CV];
1962 assert(cUNOPo->op_first->op_type == OP_NULL);
1963 op_null(((LISTOP*)cUNOPo->op_first)->op_first);/* disable pushmark */
1966 else { /* lvalue subroutine call */
1967 o->op_private |= OPpLVAL_INTRO
1968 |(OPpENTERSUB_INARGS * (type == OP_LEAVESUBLV));
1969 PL_modcount = RETURN_UNLIMITED_NUMBER;
1970 if (type == OP_GREPSTART || type == OP_ENTERSUB || type == OP_REFGEN) {
1971 /* Potential lvalue context: */
1972 o->op_private |= OPpENTERSUB_INARGS;
1975 else { /* Compile-time error message: */
1976 OP *kid = cUNOPo->op_first;
1979 if (kid->op_type != OP_PUSHMARK) {
1980 if (kid->op_type != OP_NULL || kid->op_targ != OP_LIST)
1982 "panic: unexpected lvalue entersub "
1983 "args: type/targ %ld:%"UVuf,
1984 (long)kid->op_type, (UV)kid->op_targ);
1985 kid = kLISTOP->op_first;
1987 while (kid->op_sibling)
1988 kid = kid->op_sibling;
1989 if (!(kid->op_type == OP_NULL && kid->op_targ == OP_RV2CV)) {
1990 break; /* Postpone until runtime */
1993 kid = kUNOP->op_first;
1994 if (kid->op_type == OP_NULL && kid->op_targ == OP_RV2SV)
1995 kid = kUNOP->op_first;
1996 if (kid->op_type == OP_NULL)
1998 "Unexpected constant lvalue entersub "
1999 "entry via type/targ %ld:%"UVuf,
2000 (long)kid->op_type, (UV)kid->op_targ);
2001 if (kid->op_type != OP_GV) {
2005 cv = GvCV(kGVOP_gv);
2015 if (flags & OP_LVALUE_NO_CROAK) return NULL;
2016 /* grep, foreach, subcalls, refgen */
2017 if (type == OP_GREPSTART || type == OP_ENTERSUB
2018 || type == OP_REFGEN || type == OP_LEAVESUBLV)
2020 yyerror(Perl_form(aTHX_ "Can't modify %s in %s",
2021 (o->op_type == OP_NULL && (o->op_flags & OPf_SPECIAL)
2023 : (o->op_type == OP_ENTERSUB
2024 ? "non-lvalue subroutine call"
2026 type ? PL_op_desc[type] : "local"));
2040 case OP_RIGHT_SHIFT:
2049 if (!(o->op_flags & OPf_STACKED))
2056 for (kid = cUNOPo->op_first->op_sibling; kid; kid = kid->op_sibling)
2057 op_lvalue(kid, type);
2062 if (type == OP_REFGEN && o->op_flags & OPf_PARENS) {
2063 PL_modcount = RETURN_UNLIMITED_NUMBER;
2064 return o; /* Treat \(@foo) like ordinary list. */
2068 if (scalar_mod_type(o, type))
2070 ref(cUNOPo->op_first, o->op_type);
2077 if (type == OP_LEAVESUBLV)
2078 o->op_private |= OPpMAYBE_LVSUB;
2082 PL_modcount = RETURN_UNLIMITED_NUMBER;
2085 PL_hints |= HINT_BLOCK_SCOPE;
2086 if (type == OP_LEAVESUBLV)
2087 o->op_private |= OPpMAYBE_LVSUB;
2091 ref(cUNOPo->op_first, o->op_type);
2095 PL_hints |= HINT_BLOCK_SCOPE;
2104 case OP_AELEMFAST_LEX:
2111 PL_modcount = RETURN_UNLIMITED_NUMBER;
2112 if (type == OP_REFGEN && o->op_flags & OPf_PARENS)
2113 return o; /* Treat \(@foo) like ordinary list. */
2114 if (scalar_mod_type(o, type))
2116 if (type == OP_LEAVESUBLV)
2117 o->op_private |= OPpMAYBE_LVSUB;
2121 if (!type) /* local() */
2122 Perl_croak(aTHX_ "Can't localize lexical variable %"SVf,
2123 PAD_COMPNAME_SV(o->op_targ));
2132 if (type != OP_SASSIGN && type != OP_LEAVESUBLV)
2136 if (o->op_private == 4) /* don't allow 4 arg substr as lvalue */
2142 if (type == OP_LEAVESUBLV)
2143 o->op_private |= OPpMAYBE_LVSUB;
2144 pad_free(o->op_targ);
2145 o->op_targ = pad_alloc(o->op_type, SVs_PADMY);
2146 assert(SvTYPE(PAD_SV(o->op_targ)) == SVt_NULL);
2147 if (o->op_flags & OPf_KIDS)
2148 op_lvalue(cBINOPo->op_first->op_sibling, type);
2153 ref(cBINOPo->op_first, o->op_type);
2154 if (type == OP_ENTERSUB &&
2155 !(o->op_private & (OPpLVAL_INTRO | OPpDEREF)))
2156 o->op_private |= OPpLVAL_DEFER;
2157 if (type == OP_LEAVESUBLV)
2158 o->op_private |= OPpMAYBE_LVSUB;
2168 if (o->op_flags & OPf_KIDS)
2169 op_lvalue(cLISTOPo->op_last, type);
2174 if (o->op_flags & OPf_SPECIAL) /* do BLOCK */
2176 else if (!(o->op_flags & OPf_KIDS))
2178 if (o->op_targ != OP_LIST) {
2179 op_lvalue(cBINOPo->op_first, type);
2185 for (kid = cLISTOPo->op_first; kid; kid = kid->op_sibling)
2186 /* elements might be in void context because the list is
2187 in scalar context or because they are attribute sub calls */
2188 if ( (kid->op_flags & OPf_WANT) != OPf_WANT_VOID )
2189 op_lvalue(kid, type);
2193 if (type != OP_LEAVESUBLV)
2195 break; /* op_lvalue()ing was handled by ck_return() */
2201 /* [20011101.069] File test operators interpret OPf_REF to mean that
2202 their argument is a filehandle; thus \stat(".") should not set
2204 if (type == OP_REFGEN &&
2205 PL_check[o->op_type] == Perl_ck_ftst)
2208 if (type != OP_LEAVESUBLV)
2209 o->op_flags |= OPf_MOD;
2211 if (type == OP_AASSIGN || type == OP_SASSIGN)
2212 o->op_flags |= OPf_SPECIAL|OPf_REF;
2213 else if (!type) { /* local() */
2216 o->op_private |= OPpLVAL_INTRO;
2217 o->op_flags &= ~OPf_SPECIAL;
2218 PL_hints |= HINT_BLOCK_SCOPE;
2223 Perl_ck_warner(aTHX_ packWARN(WARN_SYNTAX),
2224 "Useless localization of %s", OP_DESC(o));
2227 else if (type != OP_GREPSTART && type != OP_ENTERSUB
2228 && type != OP_LEAVESUBLV)
2229 o->op_flags |= OPf_REF;
2234 S_scalar_mod_type(const OP *o, I32 type)
2239 if (o && o->op_type == OP_RV2GV)
2263 case OP_RIGHT_SHIFT:
2284 S_is_handle_constructor(const OP *o, I32 numargs)
2286 PERL_ARGS_ASSERT_IS_HANDLE_CONSTRUCTOR;
2288 switch (o->op_type) {
2296 case OP_SELECT: /* XXX c.f. SelectSaver.pm */
2309 S_refkids(pTHX_ OP *o, I32 type)
2311 if (o && o->op_flags & OPf_KIDS) {
2313 for (kid = cLISTOPo->op_first; kid; kid = kid->op_sibling)
2320 Perl_doref(pTHX_ OP *o, I32 type, bool set_op_ref)
2325 PERL_ARGS_ASSERT_DOREF;
2327 if (!o || (PL_parser && PL_parser->error_count))
2330 switch (o->op_type) {
2332 if ((type == OP_EXISTS || type == OP_DEFINED) &&
2333 !(o->op_flags & OPf_STACKED)) {
2334 o->op_type = OP_RV2CV; /* entersub => rv2cv */
2335 o->op_ppaddr = PL_ppaddr[OP_RV2CV];
2336 assert(cUNOPo->op_first->op_type == OP_NULL);
2337 op_null(((LISTOP*)cUNOPo->op_first)->op_first); /* disable pushmark */
2338 o->op_flags |= OPf_SPECIAL;
2339 o->op_private &= ~1;
2341 else if (type == OP_RV2SV || type == OP_RV2AV || type == OP_RV2HV){
2342 o->op_private |= (type == OP_RV2AV ? OPpDEREF_AV
2343 : type == OP_RV2HV ? OPpDEREF_HV
2345 o->op_flags |= OPf_MOD;
2351 for (kid = cUNOPo->op_first->op_sibling; kid; kid = kid->op_sibling)
2352 doref(kid, type, set_op_ref);
2355 if (type == OP_DEFINED)
2356 o->op_flags |= OPf_SPECIAL; /* don't create GV */
2357 doref(cUNOPo->op_first, o->op_type, set_op_ref);
2360 if (type == OP_RV2SV || type == OP_RV2AV || type == OP_RV2HV) {
2361 o->op_private |= (type == OP_RV2AV ? OPpDEREF_AV
2362 : type == OP_RV2HV ? OPpDEREF_HV
2364 o->op_flags |= OPf_MOD;
2371 o->op_flags |= OPf_REF;
2374 if (type == OP_DEFINED)
2375 o->op_flags |= OPf_SPECIAL; /* don't create GV */
2376 doref(cUNOPo->op_first, o->op_type, set_op_ref);
2382 o->op_flags |= OPf_REF;
2387 if (!(o->op_flags & OPf_KIDS) || type == OP_DEFINED)
2389 doref(cBINOPo->op_first, type, set_op_ref);
2393 doref(cBINOPo->op_first, o->op_type, set_op_ref);
2394 if (type == OP_RV2SV || type == OP_RV2AV || type == OP_RV2HV) {
2395 o->op_private |= (type == OP_RV2AV ? OPpDEREF_AV
2396 : type == OP_RV2HV ? OPpDEREF_HV
2398 o->op_flags |= OPf_MOD;
2408 if (!(o->op_flags & OPf_KIDS))
2410 doref(cLISTOPo->op_last, type, set_op_ref);
2420 S_dup_attrlist(pTHX_ OP *o)
2425 PERL_ARGS_ASSERT_DUP_ATTRLIST;
2427 /* An attrlist is either a simple OP_CONST or an OP_LIST with kids,
2428 * where the first kid is OP_PUSHMARK and the remaining ones
2429 * are OP_CONST. We need to push the OP_CONST values.
2431 if (o->op_type == OP_CONST)
2432 rop = newSVOP(OP_CONST, o->op_flags, SvREFCNT_inc_NN(cSVOPo->op_sv));
2434 else if (o->op_type == OP_NULL)
2438 assert((o->op_type == OP_LIST) && (o->op_flags & OPf_KIDS));
2440 for (o = cLISTOPo->op_first; o; o=o->op_sibling) {
2441 if (o->op_type == OP_CONST)
2442 rop = op_append_elem(OP_LIST, rop,
2443 newSVOP(OP_CONST, o->op_flags,
2444 SvREFCNT_inc_NN(cSVOPo->op_sv)));
2451 S_apply_attrs(pTHX_ HV *stash, SV *target, OP *attrs)
2454 SV * const stashsv = stash ? newSVhek(HvNAME_HEK(stash)) : &PL_sv_no;
2456 PERL_ARGS_ASSERT_APPLY_ATTRS;
2458 /* fake up C<use attributes $pkg,$rv,@attrs> */
2459 ENTER; /* need to protect against side-effects of 'use' */
2461 #define ATTRSMODULE "attributes"
2462 #define ATTRSMODULE_PM "attributes.pm"
2464 Perl_load_module(aTHX_ PERL_LOADMOD_IMPORT_OPS,
2465 newSVpvs(ATTRSMODULE),
2467 op_prepend_elem(OP_LIST,
2468 newSVOP(OP_CONST, 0, stashsv),
2469 op_prepend_elem(OP_LIST,
2470 newSVOP(OP_CONST, 0,
2472 dup_attrlist(attrs))));
2477 S_apply_attrs_my(pTHX_ HV *stash, OP *target, OP *attrs, OP **imopsp)
2480 OP *pack, *imop, *arg;
2481 SV *meth, *stashsv, **svp;
2483 PERL_ARGS_ASSERT_APPLY_ATTRS_MY;
2488 assert(target->op_type == OP_PADSV ||
2489 target->op_type == OP_PADHV ||
2490 target->op_type == OP_PADAV);
2492 /* Ensure that attributes.pm is loaded. */
2493 ENTER; /* need to protect against side-effects of 'use' */
2494 /* Don't force the C<use> if we don't need it. */
2495 svp = hv_fetchs(GvHVn(PL_incgv), ATTRSMODULE_PM, FALSE);
2496 if (svp && *svp != &PL_sv_undef)
2497 NOOP; /* already in %INC */
2499 Perl_load_module(aTHX_ PERL_LOADMOD_NOIMPORT,
2500 newSVpvs(ATTRSMODULE), NULL);
2503 /* Need package name for method call. */
2504 pack = newSVOP(OP_CONST, 0, newSVpvs(ATTRSMODULE));
2506 /* Build up the real arg-list. */
2507 stashsv = stash ? newSVhek(HvNAME_HEK(stash)) : &PL_sv_no;
2509 arg = newOP(OP_PADSV, 0);
2510 arg->op_targ = target->op_targ;
2511 arg = op_prepend_elem(OP_LIST,
2512 newSVOP(OP_CONST, 0, stashsv),
2513 op_prepend_elem(OP_LIST,
2514 newUNOP(OP_REFGEN, 0,
2515 op_lvalue(arg, OP_REFGEN)),
2516 dup_attrlist(attrs)));
2518 /* Fake up a method call to import */
2519 meth = newSVpvs_share("import");
2520 imop = convert(OP_ENTERSUB, OPf_STACKED|OPf_SPECIAL|OPf_WANT_VOID,
2521 op_append_elem(OP_LIST,
2522 op_prepend_elem(OP_LIST, pack, list(arg)),
2523 newSVOP(OP_METHOD_NAMED, 0, meth)));
2525 /* Combine the ops. */
2526 *imopsp = op_append_elem(OP_LIST, *imopsp, imop);
2530 =notfor apidoc apply_attrs_string
2532 Attempts to apply a list of attributes specified by the C<attrstr> and
2533 C<len> arguments to the subroutine identified by the C<cv> argument which
2534 is expected to be associated with the package identified by the C<stashpv>
2535 argument (see L<attributes>). It gets this wrong, though, in that it
2536 does not correctly identify the boundaries of the individual attribute
2537 specifications within C<attrstr>. This is not really intended for the
2538 public API, but has to be listed here for systems such as AIX which
2539 need an explicit export list for symbols. (It's called from XS code
2540 in support of the C<ATTRS:> keyword from F<xsubpp>.) Patches to fix it
2541 to respect attribute syntax properly would be welcome.
2547 Perl_apply_attrs_string(pTHX_ const char *stashpv, CV *cv,
2548 const char *attrstr, STRLEN len)
2552 PERL_ARGS_ASSERT_APPLY_ATTRS_STRING;
2555 len = strlen(attrstr);
2559 for (; isSPACE(*attrstr) && len; --len, ++attrstr) ;
2561 const char * const sstr = attrstr;
2562 for (; !isSPACE(*attrstr) && len; --len, ++attrstr) ;
2563 attrs = op_append_elem(OP_LIST, attrs,
2564 newSVOP(OP_CONST, 0,
2565 newSVpvn(sstr, attrstr-sstr)));
2569 Perl_load_module(aTHX_ PERL_LOADMOD_IMPORT_OPS,
2570 newSVpvs(ATTRSMODULE),
2571 NULL, op_prepend_elem(OP_LIST,
2572 newSVOP(OP_CONST, 0, newSVpv(stashpv,0)),
2573 op_prepend_elem(OP_LIST,
2574 newSVOP(OP_CONST, 0,
2575 newRV(MUTABLE_SV(cv))),
2580 S_my_kid(pTHX_ OP *o, OP *attrs, OP **imopsp)
2584 const bool stately = PL_parser && PL_parser->in_my == KEY_state;
2586 PERL_ARGS_ASSERT_MY_KID;
2588 if (!o || (PL_parser && PL_parser->error_count))
2592 if (PL_madskills && type == OP_NULL && o->op_flags & OPf_KIDS) {
2593 (void)my_kid(cUNOPo->op_first, attrs, imopsp);
2597 if (type == OP_LIST) {
2599 for (kid = cLISTOPo->op_first; kid; kid = kid->op_sibling)
2600 my_kid(kid, attrs, imopsp);
2602 } else if (type == OP_UNDEF || type == OP_STUB) {
2604 } else if (type == OP_RV2SV || /* "our" declaration */
2606 type == OP_RV2HV) { /* XXX does this let anything illegal in? */
2607 if (cUNOPo->op_first->op_type != OP_GV) { /* MJD 20011224 */
2608 yyerror(Perl_form(aTHX_ "Can't declare %s in \"%s\"",
2610 PL_parser->in_my == KEY_our
2612 : PL_parser->in_my == KEY_state ? "state" : "my"));
2614 GV * const gv = cGVOPx_gv(cUNOPo->op_first);
2615 PL_parser->in_my = FALSE;
2616 PL_parser->in_my_stash = NULL;
2617 apply_attrs(GvSTASH(gv),
2618 (type == OP_RV2SV ? GvSV(gv) :
2619 type == OP_RV2AV ? MUTABLE_SV(GvAV(gv)) :
2620 type == OP_RV2HV ? MUTABLE_SV(GvHV(gv)) : MUTABLE_SV(gv)),
2623 o->op_private |= OPpOUR_INTRO;
2626 else if (type != OP_PADSV &&
2629 type != OP_PUSHMARK)
2631 yyerror(Perl_form(aTHX_ "Can't declare %s in \"%s\"",
2633 PL_parser->in_my == KEY_our
2635 : PL_parser->in_my == KEY_state ? "state" : "my"));
2638 else if (attrs && type != OP_PUSHMARK) {
2641 PL_parser->in_my = FALSE;
2642 PL_parser->in_my_stash = NULL;
2644 /* check for C<my Dog $spot> when deciding package */
2645 stash = PAD_COMPNAME_TYPE(o->op_targ);
2647 stash = PL_curstash;
2648 apply_attrs_my(stash, o, attrs, imopsp);
2650 o->op_flags |= OPf_MOD;
2651 o->op_private |= OPpLVAL_INTRO;
2653 o->op_private |= OPpPAD_STATE;
2658 Perl_my_attrs(pTHX_ OP *o, OP *attrs)
2662 int maybe_scalar = 0;
2664 PERL_ARGS_ASSERT_MY_ATTRS;
2666 /* [perl #17376]: this appears to be premature, and results in code such as
2667 C< our(%x); > executing in list mode rather than void mode */
2669 if (o->op_flags & OPf_PARENS)
2679 o = my_kid(o, attrs, &rops);
2681 if (maybe_scalar && o->op_type == OP_PADSV) {
2682 o = scalar(op_append_list(OP_LIST, rops, o));
2683 o->op_private |= OPpLVAL_INTRO;
2686 /* The listop in rops might have a pushmark at the beginning,
2687 which will mess up list assignment. */
2688 LISTOP * const lrops = (LISTOP *)rops; /* for brevity */
2689 if (rops->op_type == OP_LIST &&
2690 lrops->op_first && lrops->op_first->op_type == OP_PUSHMARK)
2692 OP * const pushmark = lrops->op_first;
2693 lrops->op_first = pushmark->op_sibling;
2696 o = op_append_list(OP_LIST, o, rops);
2699 PL_parser->in_my = FALSE;
2700 PL_parser->in_my_stash = NULL;
2705 Perl_sawparens(pTHX_ OP *o)
2707 PERL_UNUSED_CONTEXT;
2709 o->op_flags |= OPf_PARENS;
2714 Perl_bind_match(pTHX_ I32 type, OP *left, OP *right)
2718 const OPCODE ltype = left->op_type;
2719 const OPCODE rtype = right->op_type;
2721 PERL_ARGS_ASSERT_BIND_MATCH;
2723 if ( (ltype == OP_RV2AV || ltype == OP_RV2HV || ltype == OP_PADAV
2724 || ltype == OP_PADHV) && ckWARN(WARN_MISC))
2726 const char * const desc
2728 rtype == OP_SUBST || rtype == OP_TRANS
2729 || rtype == OP_TRANSR
2731 ? (int)rtype : OP_MATCH];
2732 const bool isary = ltype == OP_RV2AV || ltype == OP_PADAV;
2735 (ltype == OP_RV2AV || ltype == OP_RV2HV)
2736 ? cUNOPx(left)->op_first->op_type == OP_GV
2737 && (gv = cGVOPx_gv(cUNOPx(left)->op_first))
2738 ? varname(gv, isary ? '@' : '%', 0, NULL, 0, 1)
2741 (GV *)PL_compcv, isary ? '@' : '%', left->op_targ, NULL, 0, 1
2744 Perl_warner(aTHX_ packWARN(WARN_MISC),
2745 "Applying %s to %"SVf" will act on scalar(%"SVf")",
2748 const char * const sample = (isary
2749 ? "@array" : "%hash");
2750 Perl_warner(aTHX_ packWARN(WARN_MISC),
2751 "Applying %s to %s will act on scalar(%s)",
2752 desc, sample, sample);
2756 if (rtype == OP_CONST &&
2757 cSVOPx(right)->op_private & OPpCONST_BARE &&
2758 cSVOPx(right)->op_private & OPpCONST_STRICT)
2760 no_bareword_allowed(right);
2763 /* !~ doesn't make sense with /r, so error on it for now */
2764 if (rtype == OP_SUBST && (cPMOPx(right)->op_pmflags & PMf_NONDESTRUCT) &&
2766 yyerror("Using !~ with s///r doesn't make sense");
2767 if (rtype == OP_TRANSR && type == OP_NOT)
2768 yyerror("Using !~ with tr///r doesn't make sense");
2770 ismatchop = (rtype == OP_MATCH ||
2771 rtype == OP_SUBST ||
2772 rtype == OP_TRANS || rtype == OP_TRANSR)
2773 && !(right->op_flags & OPf_SPECIAL);
2774 if (ismatchop && right->op_private & OPpTARGET_MY) {
2776 right->op_private &= ~OPpTARGET_MY;
2778 if (!(right->op_flags & OPf_STACKED) && ismatchop) {
2781 right->op_flags |= OPf_STACKED;
2782 if (rtype != OP_MATCH && rtype != OP_TRANSR &&
2783 ! (rtype == OP_TRANS &&
2784 right->op_private & OPpTRANS_IDENTICAL) &&
2785 ! (rtype == OP_SUBST &&
2786 (cPMOPx(right)->op_pmflags & PMf_NONDESTRUCT)))
2787 newleft = op_lvalue(left, rtype);
2790 if (right->op_type == OP_TRANS || right->op_type == OP_TRANSR)
2791 o = newBINOP(OP_NULL, OPf_STACKED, scalar(newleft), right);
2793 o = op_prepend_elem(rtype, scalar(newleft), right);
2795 return newUNOP(OP_NOT, 0, scalar(o));
2799 return bind_match(type, left,
2800 pmruntime(newPMOP(OP_MATCH, 0), right, 0, 0));
2804 Perl_invert(pTHX_ OP *o)
2808 return newUNOP(OP_NOT, OPf_SPECIAL, scalar(o));
2812 =for apidoc Amx|OP *|op_scope|OP *o
2814 Wraps up an op tree with some additional ops so that at runtime a dynamic
2815 scope will be created. The original ops run in the new dynamic scope,
2816 and then, provided that they exit normally, the scope will be unwound.
2817 The additional ops used to create and unwind the dynamic scope will
2818 normally be an C<enter>/C<leave> pair, but a C<scope> op may be used
2819 instead if the ops are simple enough to not need the full dynamic scope
2826 Perl_op_scope(pTHX_ OP *o)
2830 if (o->op_flags & OPf_PARENS || PERLDB_NOOPT || TAINTING_get) {
2831 o = op_prepend_elem(OP_LINESEQ, newOP(OP_ENTER, 0), o);
2832 o->op_type = OP_LEAVE;
2833 o->op_ppaddr = PL_ppaddr[OP_LEAVE];
2835 else if (o->op_type == OP_LINESEQ) {
2837 o->op_type = OP_SCOPE;
2838 o->op_ppaddr = PL_ppaddr[OP_SCOPE];
2839 kid = ((LISTOP*)o)->op_first;
2840 if (kid->op_type == OP_NEXTSTATE || kid->op_type == OP_DBSTATE) {
2843 /* The following deals with things like 'do {1 for 1}' */
2844 kid = kid->op_sibling;
2846 (kid->op_type == OP_NEXTSTATE || kid->op_type == OP_DBSTATE))
2851 o = newLISTOP(OP_SCOPE, 0, o, NULL);
2857 Perl_op_unscope(pTHX_ OP *o)
2859 if (o && o->op_type == OP_LINESEQ) {
2860 OP *kid = cLISTOPo->op_first;
2861 for(; kid; kid = kid->op_sibling)
2862 if (kid->op_type == OP_NEXTSTATE || kid->op_type == OP_DBSTATE)
2869 Perl_block_start(pTHX_ int full)
2872 const int retval = PL_savestack_ix;
2874 pad_block_start(full);
2876 PL_hints &= ~HINT_BLOCK_SCOPE;
2877 SAVECOMPILEWARNINGS();
2878 PL_compiling.cop_warnings = DUP_WARNINGS(PL_compiling.cop_warnings);
2880 CALL_BLOCK_HOOKS(bhk_start, full);
2886 Perl_block_end(pTHX_ I32 floor, OP *seq)
2889 const int needblockscope = PL_hints & HINT_BLOCK_SCOPE;
2890 OP* retval = scalarseq(seq);
2893 CALL_BLOCK_HOOKS(bhk_pre_end, &retval);
2896 CopHINTS_set(&PL_compiling, PL_hints);
2898 PL_hints |= HINT_BLOCK_SCOPE; /* propagate out */
2902 /* pad_leavemy has created a sequence of introcv ops for all my
2903 subs declared in the block. We have to replicate that list with
2904 clonecv ops, to deal with this situation:
2909 sub s1 { state sub foo { \&s2 } }
2912 Originally, I was going to have introcv clone the CV and turn
2913 off the stale flag. Since &s1 is declared before &s2, the
2914 introcv op for &s1 is executed (on sub entry) before the one for
2915 &s2. But the &foo sub inside &s1 (which is cloned when &s1 is
2916 cloned, since it is a state sub) closes over &s2 and expects
2917 to see it in its outer CV’s pad. If the introcv op clones &s1,
2918 then &s2 is still marked stale. Since &s1 is not active, and
2919 &foo closes over &s1’s implicit entry for &s2, we get a ‘Varia-
2920 ble will not stay shared’ warning. Because it is the same stub
2921 that will be used when the introcv op for &s2 is executed, clos-
2922 ing over it is safe. Hence, we have to turn off the stale flag
2923 on all lexical subs in the block before we clone any of them.
2924 Hence, having introcv clone the sub cannot work. So we create a
2925 list of ops like this:
2949 OP *kid = o->op_flags & OPf_KIDS ? cLISTOPo->op_first : o;
2950 OP * const last = o->op_flags & OPf_KIDS ? cLISTOPo->op_last : o;
2951 for (;; kid = kid->op_sibling) {
2952 OP *newkid = newOP(OP_CLONECV, 0);
2953 newkid->op_targ = kid->op_targ;
2954 o = op_append_elem(OP_LINESEQ, o, newkid);
2955 if (kid == last) break;
2957 retval = op_prepend_elem(OP_LINESEQ, o, retval);
2960 CALL_BLOCK_HOOKS(bhk_post_end, &retval);
2966 =head1 Compile-time scope hooks
2968 =for apidoc Aox||blockhook_register
2970 Register a set of hooks to be called when the Perl lexical scope changes
2971 at compile time. See L<perlguts/"Compile-time scope hooks">.
2977 Perl_blockhook_register(pTHX_ BHK *hk)
2979 PERL_ARGS_ASSERT_BLOCKHOOK_REGISTER;
2981 Perl_av_create_and_push(aTHX_ &PL_blockhooks, newSViv(PTR2IV(hk)));
2988 const PADOFFSET offset = pad_findmy_pvs("$_", 0);
2989 if (offset == NOT_IN_PAD || PAD_COMPNAME_FLAGS_isOUR(offset)) {
2990 return newSVREF(newGVOP(OP_GV, 0, PL_defgv));
2993 OP * const o = newOP(OP_PADSV, 0);
2994 o->op_targ = offset;
3000 Perl_newPROG(pTHX_ OP *o)
3004 PERL_ARGS_ASSERT_NEWPROG;
3011 PL_eval_root = newUNOP(OP_LEAVEEVAL,
3012 ((PL_in_eval & EVAL_KEEPERR)
3013 ? OPf_SPECIAL : 0), o);
3015 cx = &cxstack[cxstack_ix];
3016 assert(CxTYPE(cx) == CXt_EVAL);
3018 if ((cx->blk_gimme & G_WANT) == G_VOID)
3019 scalarvoid(PL_eval_root);
3020 else if ((cx->blk_gimme & G_WANT) == G_ARRAY)
3023 scalar(PL_eval_root);
3025 PL_eval_start = op_linklist(PL_eval_root);
3026 PL_eval_root->op_private |= OPpREFCOUNTED;
3027 OpREFCNT_set(PL_eval_root, 1);
3028 PL_eval_root->op_next = 0;
3029 i = PL_savestack_ix;
3032 CALL_PEEP(PL_eval_start);
3033 finalize_optree(PL_eval_root);
3035 PL_savestack_ix = i;
3038 if (o->op_type == OP_STUB) {
3039 /* This block is entered if nothing is compiled for the main
3040 program. This will be the case for an genuinely empty main
3041 program, or one which only has BEGIN blocks etc, so already
3044 Historically (5.000) the guard above was !o. However, commit
3045 f8a08f7b8bd67b28 (Jun 2001), integrated to blead as
3046 c71fccf11fde0068, changed perly.y so that newPROG() is now
3047 called with the output of block_end(), which returns a new
3048 OP_STUB for the case of an empty optree. ByteLoader (and
3049 maybe other things) also take this path, because they set up
3050 PL_main_start and PL_main_root directly, without generating an
3053 If the parsing the main program aborts (due to parse errors,
3054 or due to BEGIN or similar calling exit), then newPROG()
3055 isn't even called, and hence this code path and its cleanups
3056 are skipped. This shouldn't make a make a difference:
3057 * a non-zero return from perl_parse is a failure, and
3058 perl_destruct() should be called immediately.
3059 * however, if exit(0) is called during the parse, then
3060 perl_parse() returns 0, and perl_run() is called. As
3061 PL_main_start will be NULL, perl_run() will return
3062 promptly, and the exit code will remain 0.
3065 PL_comppad_name = 0;
3067 S_op_destroy(aTHX_ o);
3070 PL_main_root = op_scope(sawparens(scalarvoid(o)));
3071 PL_curcop = &PL_compiling;
3072 PL_main_start = LINKLIST(PL_main_root);
3073 PL_main_root->op_private |= OPpREFCOUNTED;
3074 OpREFCNT_set(PL_main_root, 1);
3075 PL_main_root->op_next = 0;
3076 CALL_PEEP(PL_main_start);
3077 finalize_optree(PL_main_root);
3078 cv_forget_slab(PL_compcv);
3081 /* Register with debugger */
3083 CV * const cv = get_cvs("DB::postponed", 0);
3087 XPUSHs(MUTABLE_SV(CopFILEGV(&PL_compiling)));
3089 call_sv(MUTABLE_SV(cv), G_DISCARD);
3096 Perl_localize(pTHX_ OP *o, I32 lex)
3100 PERL_ARGS_ASSERT_LOCALIZE;
3102 if (o->op_flags & OPf_PARENS)
3103 /* [perl #17376]: this appears to be premature, and results in code such as
3104 C< our(%x); > executing in list mode rather than void mode */
3111 if ( PL_parser->bufptr > PL_parser->oldbufptr
3112 && PL_parser->bufptr[-1] == ','
3113 && ckWARN(WARN_PARENTHESIS))
3115 char *s = PL_parser->bufptr;
3118 /* some heuristics to detect a potential error */
3119 while (*s && (strchr(", \t\n", *s)))
3123 if (*s && strchr("@$%*", *s) && *++s
3124 && (isWORDCHAR(*s) || UTF8_IS_CONTINUED(*s))) {
3127 while (*s && (isWORDCHAR(*s) || UTF8_IS_CONTINUED(*s)))
3129 while (*s && (strchr(", \t\n", *s)))
3135 if (sigil && (*s == ';' || *s == '=')) {
3136 Perl_warner(aTHX_ packWARN(WARN_PARENTHESIS),
3137 "Parentheses missing around \"%s\" list",
3139 ? (PL_parser->in_my == KEY_our
3141 : PL_parser->in_my == KEY_state
3151 o = op_lvalue(o, OP_NULL); /* a bit kludgey */
3152 PL_parser->in_my = FALSE;
3153 PL_parser->in_my_stash = NULL;
3158 Perl_jmaybe(pTHX_ OP *o)
3160 PERL_ARGS_ASSERT_JMAYBE;
3162 if (o->op_type == OP_LIST) {
3164 = newSVREF(newGVOP(OP_GV, 0, gv_fetchpvs(";", GV_ADD|GV_NOTQUAL, SVt_PV)));
3165 o = convert(OP_JOIN, 0, op_prepend_elem(OP_LIST, o2, o));
3170 PERL_STATIC_INLINE OP *
3171 S_op_std_init(pTHX_ OP *o)
3173 I32 type = o->op_type;
3175 PERL_ARGS_ASSERT_OP_STD_INIT;
3177 if (PL_opargs[type] & OA_RETSCALAR)
3179 if (PL_opargs[type] & OA_TARGET && !o->op_targ)
3180 o->op_targ = pad_alloc(type, SVs_PADTMP);
3185 PERL_STATIC_INLINE OP *
3186 S_op_integerize(pTHX_ OP *o)
3188 I32 type = o->op_type;
3190 PERL_ARGS_ASSERT_OP_INTEGERIZE;
3192 /* integerize op. */
3193 if ((PL_opargs[type] & OA_OTHERINT) && (PL_hints & HINT_INTEGER))
3196 o->op_ppaddr = PL_ppaddr[type = ++(o->op_type)];
3199 if (type == OP_NEGATE)
3200 /* XXX might want a ck_negate() for this */
3201 cUNOPo->op_first->op_private &= ~OPpCONST_STRICT;
3207 S_fold_constants(pTHX_ OP *o)
3212 VOL I32 type = o->op_type;
3217 SV * const oldwarnhook = PL_warnhook;
3218 SV * const olddiehook = PL_diehook;
3222 PERL_ARGS_ASSERT_FOLD_CONSTANTS;
3224 if (!(PL_opargs[type] & OA_FOLDCONST))
3238 /* XXX what about the numeric ops? */
3239 if (IN_LOCALE_COMPILETIME)
3243 if (!cLISTOPo->op_first->op_sibling
3244 || cLISTOPo->op_first->op_sibling->op_type != OP_CONST)
3247 SV * const sv = cSVOPx_sv(cLISTOPo->op_first->op_sibling);
3248 if (!SvPOK(sv) || SvGMAGICAL(sv)) goto nope;
3250 const char *s = SvPVX_const(sv);
3251 while (s < SvEND(sv)) {
3252 if (*s == 'p' || *s == 'P') goto nope;
3259 if (o->op_private & OPpREPEAT_DOLIST) goto nope;
3262 if (PL_parser && PL_parser->error_count)
3263 goto nope; /* Don't try to run w/ errors */
3265 for (curop = LINKLIST(o); curop != o; curop = LINKLIST(curop)) {
3266 const OPCODE type = curop->op_type;
3267 if ((type != OP_CONST || (curop->op_private & OPpCONST_BARE)) &&
3269 type != OP_SCALAR &&
3271 type != OP_PUSHMARK)
3277 curop = LINKLIST(o);
3278 old_next = o->op_next;
3282 oldscope = PL_scopestack_ix;
3283 create_eval_scope(G_FAKINGEVAL);
3285 /* Verify that we don't need to save it: */
3286 assert(PL_curcop == &PL_compiling);
3287 StructCopy(&PL_compiling, ¬_compiling, COP);
3288 PL_curcop = ¬_compiling;
3289 /* The above ensures that we run with all the correct hints of the
3290 currently compiling COP, but that IN_PERL_RUNTIME is not true. */
3291 assert(IN_PERL_RUNTIME);
3292 PL_warnhook = PERL_WARNHOOK_FATAL;
3299 sv = *(PL_stack_sp--);
3300 if (o->op_targ && sv == PAD_SV(o->op_targ)) { /* grab pad temp? */
3302 /* Can't simply swipe the SV from the pad, because that relies on
3303 the op being freed "real soon now". Under MAD, this doesn't
3304 happen (see the #ifdef below). */
3307 pad_swipe(o->op_targ, FALSE);
3310 else if (SvTEMP(sv)) { /* grab mortal temp? */
3311 SvREFCNT_inc_simple_void(sv);
3316 /* Something tried to die. Abandon constant folding. */
3317 /* Pretend the error never happened. */
3319 o->op_next = old_next;
3323 /* Don't expect 1 (setjmp failed) or 2 (something called my_exit) */
3324 PL_warnhook = oldwarnhook;
3325 PL_diehook = olddiehook;
3326 /* XXX note that this croak may fail as we've already blown away
3327 * the stack - eg any nested evals */
3328 Perl_croak(aTHX_ "panic: fold_constants JMPENV_PUSH returned %d", ret);
3331 PL_warnhook = oldwarnhook;
3332 PL_diehook = olddiehook;
3333 PL_curcop = &PL_compiling;
3335 if (PL_scopestack_ix > oldscope)
3336 delete_eval_scope();
3345 if (type == OP_RV2GV)
3346 newop = newGVOP(OP_GV, 0, MUTABLE_GV(sv));
3348 newop = newSVOP(OP_CONST, OPpCONST_FOLDED<<8, MUTABLE_SV(sv));
3349 op_getmad(o,newop,'f');
3357 S_gen_constant_list(pTHX_ OP *o)
3361 const I32 oldtmps_floor = PL_tmps_floor;
3364 if (PL_parser && PL_parser->error_count)
3365 return o; /* Don't attempt to run with errors */
3367 PL_op = curop = LINKLIST(o);
3370 Perl_pp_pushmark(aTHX);
3373 assert (!(curop->op_flags & OPf_SPECIAL));
3374 assert(curop->op_type == OP_RANGE);
3375 Perl_pp_anonlist(aTHX);
3376 PL_tmps_floor = oldtmps_floor;
3378 o->op_type = OP_RV2AV;
3379 o->op_ppaddr = PL_ppaddr[OP_RV2AV];
3380 o->op_flags &= ~OPf_REF; /* treat \(1..2) like an ordinary list */
3381 o->op_flags |= OPf_PARENS; /* and flatten \(1..2,3) */
3382 o->op_opt = 0; /* needs to be revisited in rpeep() */
3383 curop = ((UNOP*)o)->op_first;
3384 ((UNOP*)o)->op_first = newSVOP(OP_CONST, 0, SvREFCNT_inc_NN(*PL_stack_sp--));
3386 op_getmad(curop,o,'O');
3395 Perl_convert(pTHX_ I32 type, I32 flags, OP *o)
3398 if (type < 0) type = -type, flags |= OPf_SPECIAL;
3399 if (!o || o->op_type != OP_LIST)
3400 o = newLISTOP(OP_LIST, 0, o, NULL);
3402 o->op_flags &= ~OPf_WANT;
3404 if (!(PL_opargs[type] & OA_MARK))
3405 op_null(cLISTOPo->op_first);
3407 OP * const kid2 = cLISTOPo->op_first->op_sibling;
3408 if (kid2 && kid2->op_type == OP_COREARGS) {
3409 op_null(cLISTOPo->op_first);
3410 kid2->op_private |= OPpCOREARGS_PUSHMARK;
3414 o->op_type = (OPCODE)type;
3415 o->op_ppaddr = PL_ppaddr[type];
3416 o->op_flags |= flags;
3418 o = CHECKOP(type, o);
3419 if (o->op_type != (unsigned)type)
3422 return fold_constants(op_integerize(op_std_init(o)));
3426 =head1 Optree Manipulation Functions
3429 /* List constructors */
3432 =for apidoc Am|OP *|op_append_elem|I32 optype|OP *first|OP *last
3434 Append an item to the list of ops contained directly within a list-type
3435 op, returning the lengthened list. I<first> is the list-type op,
3436 and I<last> is the op to append to the list. I<optype> specifies the
3437 intended opcode for the list. If I<first> is not already a list of the
3438 right type, it will be upgraded into one. If either I<first> or I<last>
3439 is null, the other is returned unchanged.
3445 Perl_op_append_elem(pTHX_ I32 type, OP *first, OP *last)
3453 if (first->op_type != (unsigned)type
3454 || (type == OP_LIST && (first->op_flags & OPf_PARENS)))
3456 return newLISTOP(type, 0, first, last);
3459 if (first->op_flags & OPf_KIDS)
3460 ((LISTOP*)first)->op_last->op_sibling = last;
3462 first->op_flags |= OPf_KIDS;
3463 ((LISTOP*)first)->op_first = last;
3465 ((LISTOP*)first)->op_last = last;
3470 =for apidoc Am|OP *|op_append_list|I32 optype|OP *first|OP *last
3472 Concatenate the lists of ops contained directly within two list-type ops,
3473 returning the combined list. I<first> and I<last> are the list-type ops
3474 to concatenate. I<optype> specifies the intended opcode for the list.
3475 If either I<first> or I<last> is not already a list of the right type,
3476 it will be upgraded into one. If either I<first> or I<last> is null,
3477 the other is returned unchanged.
3483 Perl_op_append_list(pTHX_ I32 type, OP *first, OP *last)
3491 if (first->op_type != (unsigned)type)
3492 return op_prepend_elem(type, first, last);
3494 if (last->op_type != (unsigned)type)
3495 return op_append_elem(type, first, last);
3497 ((LISTOP*)first)->op_last->op_sibling = ((LISTOP*)last)->op_first;
3498 ((LISTOP*)first)->op_last = ((LISTOP*)last)->op_last;
3499 first->op_flags |= (last->op_flags & OPf_KIDS);
3502 if (((LISTOP*)last)->op_first && first->op_madprop) {
3503 MADPROP *mp = ((LISTOP*)last)->op_first->op_madprop;
3505 while (mp->mad_next)
3507 mp->mad_next = first->op_madprop;
3510 ((LISTOP*)last)->op_first->op_madprop = first->op_madprop;
3513 first->op_madprop = last->op_madprop;
3514 last->op_madprop = 0;
3517 S_op_destroy(aTHX_ last);
3523 =for apidoc Am|OP *|op_prepend_elem|I32 optype|OP *first|OP *last
3525 Prepend an item to the list of ops contained directly within a list-type
3526 op, returning the lengthened list. I<first> is the op to prepend to the
3527 list, and I<last> is the list-type op. I<optype> specifies the intended
3528 opcode for the list. If I<last> is not already a list of the right type,
3529 it will be upgraded into one. If either I<first> or I<last> is null,
3530 the other is returned unchanged.
3536 Perl_op_prepend_elem(pTHX_ I32 type, OP *first, OP *last)
3544 if (last->op_type == (unsigned)type) {
3545 if (type == OP_LIST) { /* already a PUSHMARK there */
3546 first->op_sibling = ((LISTOP*)last)->op_first->op_sibling;
3547 ((LISTOP*)last)->op_first->op_sibling = first;
3548 if (!(first->op_flags & OPf_PARENS))
3549 last->op_flags &= ~OPf_PARENS;
3552 if (!(last->op_flags & OPf_KIDS)) {
3553 ((LISTOP*)last)->op_last = first;
3554 last->op_flags |= OPf_KIDS;
3556 first->op_sibling = ((LISTOP*)last)->op_first;
3557 ((LISTOP*)last)->op_first = first;
3559 last->op_flags |= OPf_KIDS;
3563 return newLISTOP(type, 0, first, last);
3571 Perl_newTOKEN(pTHX_ I32 optype, YYSTYPE lval, MADPROP* madprop)
3574 Newxz(tk, 1, TOKEN);
3575 tk->tk_type = (OPCODE)optype;
3576 tk->tk_type = 12345;
3578 tk->tk_mad = madprop;
3583 Perl_token_free(pTHX_ TOKEN* tk)
3585 PERL_ARGS_ASSERT_TOKEN_FREE;
3587 if (tk->tk_type != 12345)
3589 mad_free(tk->tk_mad);
3594 Perl_token_getmad(pTHX_ TOKEN* tk, OP* o, char slot)
3599 PERL_ARGS_ASSERT_TOKEN_GETMAD;
3601 if (tk->tk_type != 12345) {
3602 Perl_warner(aTHX_ packWARN(WARN_MISC),
3603 "Invalid TOKEN object ignored");
3610 /* faked up qw list? */
3612 tm->mad_type == MAD_SV &&
3613 SvPVX((SV *)tm->mad_val)[0] == 'q')
3620 /* pretend constant fold didn't happen? */
3621 if (mp->mad_key == 'f' &&
3622 (o->op_type == OP_CONST ||
3623 o->op_type == OP_GV) )
3625 token_getmad(tk,(OP*)mp->mad_val,slot);
3639 if (mp->mad_key == 'X')
3640 mp->mad_key = slot; /* just change the first one */
3650 Perl_op_getmad_weak(pTHX_ OP* from, OP* o, char slot)
3659 /* pretend constant fold didn't happen? */
3660 if (mp->mad_key == 'f' &&
3661 (o->op_type == OP_CONST ||
3662 o->op_type == OP_GV) )
3664 op_getmad(from,(OP*)mp->mad_val,slot);
3671 mp->mad_next = newMADPROP(slot,MAD_OP,from,0);
3674 o->op_madprop = newMADPROP(slot,MAD_OP,from,0);
3680 Perl_op_getmad(pTHX_ OP* from, OP* o, char slot)
3689 /* pretend constant fold didn't happen? */
3690 if (mp->mad_key == 'f' &&
3691 (o->op_type == OP_CONST ||
3692 o->op_type == OP_GV) )
3694 op_getmad(from,(OP*)mp->mad_val,slot);
3701 mp->mad_next = newMADPROP(slot,MAD_OP,from,1);
3704 o->op_madprop = newMADPROP(slot,MAD_OP,from,1);
3708 PerlIO_printf(PerlIO_stderr(),
3709 "DESTROYING op = %0"UVxf"\n", PTR2UV(from));
3715 Perl_prepend_madprops(pTHX_ MADPROP* mp, OP* o, char slot)
3733 Perl_append_madprops(pTHX_ MADPROP* tm, OP* o, char slot)
3737 addmad(tm, &(o->op_madprop), slot);
3741 Perl_addmad(pTHX_ MADPROP* tm, MADPROP** root, char slot)
3762 Perl_newMADsv(pTHX_ char key, SV* sv)
3764 PERL_ARGS_ASSERT_NEWMADSV;
3766 return newMADPROP(key, MAD_SV, sv, 0);
3770 Perl_newMADPROP(pTHX_ char key, char type, void* val, I32 vlen)
3772 MADPROP *const mp = (MADPROP *) PerlMemShared_malloc(sizeof(MADPROP));
3775 mp->mad_vlen = vlen;
3776 mp->mad_type = type;
3778 /* PerlIO_printf(PerlIO_stderr(), "NEW mp = %0x\n", mp); */
3783 Perl_mad_free(pTHX_ MADPROP* mp)
3785 /* PerlIO_printf(PerlIO_stderr(), "FREE mp = %0x\n", mp); */
3789 mad_free(mp->mad_next);
3790 /* if (PL_parser && PL_parser->lex_state != LEX_NOTPARSING && mp->mad_vlen)
3791 PerlIO_printf(PerlIO_stderr(), "DESTROYING '%c'=<%s>\n", mp->mad_key & 255, mp->mad_val); */
3792 switch (mp->mad_type) {
3796 Safefree(mp->mad_val);
3799 if (mp->mad_vlen) /* vlen holds "strong/weak" boolean */
3800 op_free((OP*)mp->mad_val);
3803 sv_free(MUTABLE_SV(mp->mad_val));
3806 PerlIO_printf(PerlIO_stderr(), "Unrecognized mad\n");
3809 PerlMemShared_free(mp);
3815 =head1 Optree construction
3817 =for apidoc Am|OP *|newNULLLIST
3819 Constructs, checks, and returns a new C<stub> op, which represents an
3820 empty list expression.
3826 Perl_newNULLLIST(pTHX)
3828 return newOP(OP_STUB, 0);
3832 S_force_list(pTHX_ OP *o)
3834 if (!o || o->op_type != OP_LIST)
3835 o = newLISTOP(OP_LIST, 0, o, NULL);
3841 =for apidoc Am|OP *|newLISTOP|I32 type|I32 flags|OP *first|OP *last
3843 Constructs, checks, and returns an op of any list type. I<type> is
3844 the opcode. I<flags> gives the eight bits of C<op_flags>, except that
3845 C<OPf_KIDS> will be set automatically if required. I<first> and I<last>
3846 supply up to two ops to be direct children of the list op; they are
3847 consumed by this function and become part of the constructed op tree.
3853 Perl_newLISTOP(pTHX_ I32 type, I32 flags, OP *first, OP *last)
3858 assert((PL_opargs[type] & OA_CLASS_MASK) == OA_LISTOP);
3860 NewOp(1101, listop, 1, LISTOP);
3862 listop->op_type = (OPCODE)type;
3863 listop->op_ppaddr = PL_ppaddr[type];
3866 listop->op_flags = (U8)flags;
3870 else if (!first && last)
3873 first->op_sibling = last;
3874 listop->op_first = first;
3875 listop->op_last = last;
3876 if (type == OP_LIST) {
3877 OP* const pushop = newOP(OP_PUSHMARK, 0);
3878 pushop->op_sibling = first;
3879 listop->op_first = pushop;
3880 listop->op_flags |= OPf_KIDS;
3882 listop->op_last = pushop;
3885 return CHECKOP(type, listop);
3889 =for apidoc Am|OP *|newOP|I32 type|I32 flags
3891 Constructs, checks, and returns an op of any base type (any type that
3892 has no extra fields). I<type> is the opcode. I<flags> gives the
3893 eight bits of C<op_flags>, and, shifted up eight bits, the eight bits
3900 Perl_newOP(pTHX_ I32 type, I32 flags)
3905 if (type == -OP_ENTEREVAL) {
3906 type = OP_ENTEREVAL;
3907 flags |= OPpEVAL_BYTES<<8;
3910 assert((PL_opargs[type] & OA_CLASS_MASK) == OA_BASEOP
3911 || (PL_opargs[type] & OA_CLASS_MASK) == OA_BASEOP_OR_UNOP
3912 || (PL_opargs[type] & OA_CLASS_MASK) == OA_FILESTATOP
3913 || (PL_opargs[type] & OA_CLASS_MASK) == OA_LOOPEXOP);
3915 NewOp(1101, o, 1, OP);
3916 o->op_type = (OPCODE)type;
3917 o->op_ppaddr = PL_ppaddr[type];
3918 o->op_flags = (U8)flags;
3921 o->op_private = (U8)(0 | (flags >> 8));
3922 if (PL_opargs[type] & OA_RETSCALAR)
3924 if (PL_opargs[type] & OA_TARGET)
3925 o->op_targ = pad_alloc(type, SVs_PADTMP);
3926 return CHECKOP(type, o);
3930 =for apidoc Am|OP *|newUNOP|I32 type|I32 flags|OP *first
3932 Constructs, checks, and returns an op of any unary type. I<type> is
3933 the opcode. I<flags> gives the eight bits of C<op_flags>, except that
3934 C<OPf_KIDS> will be set automatically if required, and, shifted up eight
3935 bits, the eight bits of C<op_private>, except that the bit with value 1
3936 is automatically set. I<first> supplies an optional op to be the direct
3937 child of the unary op; it is consumed by this function and become part
3938 of the constructed op tree.
3944 Perl_newUNOP(pTHX_ I32 type, I32 flags, OP *first)
3949 if (type == -OP_ENTEREVAL) {
3950 type = OP_ENTEREVAL;
3951 flags |= OPpEVAL_BYTES<<8;
3954 assert((PL_opargs[type] & OA_CLASS_MASK) == OA_UNOP
3955 || (PL_opargs[type] & OA_CLASS_MASK) == OA_BASEOP_OR_UNOP
3956 || (PL_opargs[type] & OA_CLASS_MASK) == OA_FILESTATOP
3957 || (PL_opargs[type] & OA_CLASS_MASK) == OA_LOOPEXOP
3958 || type == OP_SASSIGN
3959 || type == OP_ENTERTRY
3960 || type == OP_NULL );
3963 first = newOP(OP_STUB, 0);
3964 if (PL_opargs[type] & OA_MARK)
3965 first = force_list(first);
3967 NewOp(1101, unop, 1, UNOP);
3968 unop->op_type = (OPCODE)type;
3969 unop->op_ppaddr = PL_ppaddr[type];
3970 unop->op_first = first;
3971 unop->op_flags = (U8)(flags | OPf_KIDS);
3972 unop->op_private = (U8)(1 | (flags >> 8));
3973 unop = (UNOP*) CHECKOP(type, unop);
3977 return fold_constants(op_integerize(op_std_init((OP *) unop)));
3981 =for apidoc Am|OP *|newBINOP|I32 type|I32 flags|OP *first|OP *last
3983 Constructs, checks, and returns an op of any binary type. I<type>
3984 is the opcode. I<flags> gives the eight bits of C<op_flags>, except
3985 that C<OPf_KIDS> will be set automatically, and, shifted up eight bits,
3986 the eight bits of C<op_private>, except that the bit with value 1 or
3987 2 is automatically set as required. I<first> and I<last> supply up to
3988 two ops to be the direct children of the binary op; they are consumed
3989 by this function and become part of the constructed op tree.
3995 Perl_newBINOP(pTHX_ I32 type, I32 flags, OP *first, OP *last)
4000 assert((PL_opargs[type] & OA_CLASS_MASK) == OA_BINOP
4001 || type == OP_SASSIGN || type == OP_NULL );
4003 NewOp(1101, binop, 1, BINOP);
4006 first = newOP(OP_NULL, 0);
4008 binop->op_type = (OPCODE)type;
4009 binop->op_ppaddr = PL_ppaddr[type];
4010 binop->op_first = first;
4011 binop->op_flags = (U8)(flags | OPf_KIDS);
4014 binop->op_private = (U8)(1 | (flags >> 8));
4017 binop->op_private = (U8)(2 | (flags >> 8));
4018 first->op_sibling = last;
4021 binop = (BINOP*)CHECKOP(type, binop);
4022 if (binop->op_next || binop->op_type != (OPCODE)type)
4025 binop->op_last = binop->op_first->op_sibling;
4027 return fold_constants(op_integerize(op_std_init((OP *)binop)));
4030 static int uvcompare(const void *a, const void *b)
4031 __attribute__nonnull__(1)
4032 __attribute__nonnull__(2)
4033 __attribute__pure__;
4034 static int uvcompare(const void *a, const void *b)
4036 if (*((const UV *)a) < (*(const UV *)b))
4038 if (*((const UV *)a) > (*(const UV *)b))
4040 if (*((const UV *)a+1) < (*(const UV *)b+1))
4042 if (*((const UV *)a+1) > (*(const UV *)b+1))
4048 S_pmtrans(pTHX_ OP *o, OP *expr, OP *repl)
4051 SV * const tstr = ((SVOP*)expr)->op_sv;
4054 (repl->op_type == OP_NULL)
4055 ? ((SVOP*)((LISTOP*)repl)->op_first)->op_sv :
4057 ((SVOP*)repl)->op_sv;
4060 const U8 *t = (U8*)SvPV_const(tstr, tlen);
4061 const U8 *r = (U8*)SvPV_const(rstr, rlen);
4067 const I32 complement = o->op_private & OPpTRANS_COMPLEMENT;
4068 const I32 squash = o->op_private & OPpTRANS_SQUASH;
4069 I32 del = o->op_private & OPpTRANS_DELETE;
4072 PERL_ARGS_ASSERT_PMTRANS;
4074 PL_hints |= HINT_BLOCK_SCOPE;
4077 o->op_private |= OPpTRANS_FROM_UTF;
4080 o->op_private |= OPpTRANS_TO_UTF;
4082 if (o->op_private & (OPpTRANS_FROM_UTF|OPpTRANS_TO_UTF)) {
4083 SV* const listsv = newSVpvs("# comment\n");
4085 const U8* tend = t + tlen;
4086 const U8* rend = r + rlen;
4100 const I32 from_utf = o->op_private & OPpTRANS_FROM_UTF;
4101 const I32 to_utf = o->op_private & OPpTRANS_TO_UTF;
4104 const U32 flags = UTF8_ALLOW_DEFAULT;
4108 t = tsave = bytes_to_utf8(t, &len);
4111 if (!to_utf && rlen) {
4113 r = rsave = bytes_to_utf8(r, &len);
4117 /* There are several snags with this code on EBCDIC:
4118 1. 0xFF is a legal UTF-EBCDIC byte (there are no illegal bytes).
4119 2. scan_const() in toke.c has encoded chars in native encoding which makes
4120 ranges at least in EBCDIC 0..255 range the bottom odd.
4124 U8 tmpbuf[UTF8_MAXBYTES+1];
4127 Newx(cp, 2*tlen, UV);
4129 transv = newSVpvs("");
4131 cp[2*i] = utf8n_to_uvuni(t, tend-t, &ulen, flags);
4133 if (t < tend && NATIVE_TO_UTF(*t) == 0xff) {
4135 cp[2*i+1] = utf8n_to_uvuni(t, tend-t, &ulen, flags);
4139 cp[2*i+1] = cp[2*i];
4143 qsort(cp, i, 2*sizeof(UV), uvcompare);
4144 for (j = 0; j < i; j++) {
4146 diff = val - nextmin;
4148 t = uvuni_to_utf8(tmpbuf,nextmin);
4149 sv_catpvn(transv, (char*)tmpbuf, t - tmpbuf);
4151 U8 range_mark = UTF_TO_NATIVE(0xff);
4152 t = uvuni_to_utf8(tmpbuf, val - 1);
4153 sv_catpvn(transv, (char *)&range_mark, 1);
4154 sv_catpvn(transv, (char*)tmpbuf, t - tmpbuf);
4161 t = uvuni_to_utf8(tmpbuf,nextmin);
4162 sv_catpvn(transv, (char*)tmpbuf, t - tmpbuf);
4164 U8 range_mark = UTF_TO_NATIVE(0xff);
4165 sv_catpvn(transv, (char *)&range_mark, 1);
4167 t = uvuni_to_utf8(tmpbuf, 0x7fffffff);
4168 sv_catpvn(transv, (char*)tmpbuf, t - tmpbuf);
4169 t = (const U8*)SvPVX_const(transv);
4170 tlen = SvCUR(transv);
4174 else if (!rlen && !del) {
4175 r = t; rlen = tlen; rend = tend;
4178 if ((!rlen && !del) || t == r ||
4179 (tlen == rlen && memEQ((char *)t, (char *)r, tlen)))
4181 o->op_private |= OPpTRANS_IDENTICAL;
4185 while (t < tend || tfirst <= tlast) {
4186 /* see if we need more "t" chars */
4187 if (tfirst > tlast) {
4188 tfirst = (I32)utf8n_to_uvuni(t, tend - t, &ulen, flags);
4190 if (t < tend && NATIVE_TO_UTF(*t) == 0xff) { /* illegal utf8 val indicates range */
4192 tlast = (I32)utf8n_to_uvuni(t, tend - t, &ulen, flags);
4199 /* now see if we need more "r" chars */
4200 if (rfirst > rlast) {
4202 rfirst = (I32)utf8n_to_uvuni(r, rend - r, &ulen, flags);
4204 if (r < rend && NATIVE_TO_UTF(*r) == 0xff) { /* illegal utf8 val indicates range */
4206 rlast = (I32)utf8n_to_uvuni(r, rend - r, &ulen, flags);
4215 rfirst = rlast = 0xffffffff;
4219 /* now see which range will peter our first, if either. */
4220 tdiff = tlast - tfirst;
4221 rdiff = rlast - rfirst;
4228 if (rfirst == 0xffffffff) {
4229 diff = tdiff; /* oops, pretend rdiff is infinite */
4231 Perl_sv_catpvf(aTHX_ listsv, "%04lx\t%04lx\tXXXX\n",
4232 (long)tfirst, (long)tlast);
4234 Perl_sv_catpvf(aTHX_ listsv, "%04lx\t\tXXXX\n", (long)tfirst);
4238 Perl_sv_catpvf(aTHX_ listsv, "%04lx\t%04lx\t%04lx\n",
4239 (long)tfirst, (long)(tfirst + diff),
4242 Perl_sv_catpvf(aTHX_ listsv, "%04lx\t\t%04lx\n",
4243 (long)tfirst, (long)rfirst);
4245 if (rfirst + diff > max)
4246 max = rfirst + diff;
4248 grows = (tfirst < rfirst &&
4249 UNISKIP(tfirst) < UNISKIP(rfirst + diff));
4261 else if (max > 0xff)
4266 swash = MUTABLE_SV(swash_init("utf8", "", listsv, bits, none));
4268 cPADOPo->op_padix = pad_alloc(OP_TRANS, SVs_PADTMP);
4269 SvREFCNT_dec(PAD_SVl(cPADOPo->op_padix));
4270 PAD_SETSV(cPADOPo->op_padix, swash);
4272 SvREADONLY_on(swash);
4274 cSVOPo->op_sv = swash;
4276 SvREFCNT_dec(listsv);
4277 SvREFCNT_dec(transv);
4279 if (!del && havefinal && rlen)
4280 (void)hv_store(MUTABLE_HV(SvRV(swash)), "FINAL", 5,
4281 newSVuv((UV)final), 0);
4284 o->op_private |= OPpTRANS_GROWS;
4290 op_getmad(expr,o,'e');
4291 op_getmad(repl,o,'r');
4299 tbl = (short*)PerlMemShared_calloc(
4300 (o->op_private & OPpTRANS_COMPLEMENT) &&
4301 !(o->op_private & OPpTRANS_DELETE) ? 258 : 256,
4303 cPVOPo->op_pv = (char*)tbl;
4305 for (i = 0; i < (I32)tlen; i++)
4307 for (i = 0, j = 0; i < 256; i++) {
4309 if (j >= (I32)rlen) {
4318 if (i < 128 && r[j] >= 128)
4328 o->op_private |= OPpTRANS_IDENTICAL;
4330 else if (j >= (I32)rlen)
4335 PerlMemShared_realloc(tbl,
4336 (0x101+rlen-j) * sizeof(short));
4337 cPVOPo->op_pv = (char*)tbl;
4339 tbl[0x100] = (short)(rlen - j);
4340 for (i=0; i < (I32)rlen - j; i++)
4341 tbl[0x101+i] = r[j+i];
4345 if (!rlen && !del) {
4348 o->op_private |= OPpTRANS_IDENTICAL;
4350 else if (!squash && rlen == tlen && memEQ((char*)t, (char*)r, tlen)) {
4351 o->op_private |= OPpTRANS_IDENTICAL;
4353 for (i = 0; i < 256; i++)
4355 for (i = 0, j = 0; i < (I32)tlen; i++,j++) {
4356 if (j >= (I32)rlen) {
4358 if (tbl[t[i]] == -1)
4364 if (tbl[t[i]] == -1) {
4365 if (t[i] < 128 && r[j] >= 128)
4372 if(del && rlen == tlen) {
4373 Perl_ck_warner(aTHX_ packWARN(WARN_MISC), "Useless use of /d modifier in transliteration operator");
4374 } else if(rlen > tlen) {
4375 Perl_ck_warner(aTHX_ packWARN(WARN_MISC), "Replacement list is longer than search list");
4379 o->op_private |= OPpTRANS_GROWS;
4381 op_getmad(expr,o,'e');
4382 op_getmad(repl,o,'r');
4392 =for apidoc Am|OP *|newPMOP|I32 type|I32 flags
4394 Constructs, checks, and returns an op of any pattern matching type.
4395 I<type> is the opcode. I<flags> gives the eight bits of C<op_flags>
4396 and, shifted up eight bits, the eight bits of C<op_private>.
4402 Perl_newPMOP(pTHX_ I32 type, I32 flags)
4407 assert((PL_opargs[type] & OA_CLASS_MASK) == OA_PMOP);
4409 NewOp(1101, pmop, 1, PMOP);
4410 pmop->op_type = (OPCODE)type;
4411 pmop->op_ppaddr = PL_ppaddr[type];
4412 pmop->op_flags = (U8)flags;
4413 pmop->op_private = (U8)(0 | (flags >> 8));
4415 if (PL_hints & HINT_RE_TAINT)
4416 pmop->op_pmflags |= PMf_RETAINT;
4417 if (IN_LOCALE_COMPILETIME) {
4418 set_regex_charset(&(pmop->op_pmflags), REGEX_LOCALE_CHARSET);
4420 else if ((! (PL_hints & HINT_BYTES))
4421 /* Both UNI_8_BIT and locale :not_characters imply Unicode */
4422 && (PL_hints & (HINT_UNI_8_BIT|HINT_LOCALE_NOT_CHARS)))
4424 set_regex_charset(&(pmop->op_pmflags), REGEX_UNICODE_CHARSET);
4426 if (PL_hints & HINT_RE_FLAGS) {
4427 SV *reflags = Perl_refcounted_he_fetch_pvn(aTHX_
4428 PL_compiling.cop_hints_hash, STR_WITH_LEN("reflags"), 0, 0
4430 if (reflags && SvOK(reflags)) pmop->op_pmflags |= SvIV(reflags);
4431 reflags = Perl_refcounted_he_fetch_pvn(aTHX_
4432 PL_compiling.cop_hints_hash, STR_WITH_LEN("reflags_charset"), 0, 0
4434 if (reflags && SvOK(reflags)) {
4435 set_regex_charset(&(pmop->op_pmflags), (regex_charset)SvIV(reflags));
4441 assert(SvPOK(PL_regex_pad[0]));
4442 if (SvCUR(PL_regex_pad[0])) {
4443 /* Pop off the "packed" IV from the end. */
4444 SV *const repointer_list = PL_regex_pad[0];
4445 const char *p = SvEND(repointer_list) - sizeof(IV);
4446 const IV offset = *((IV*)p);
4448 assert(SvCUR(repointer_list) % sizeof(IV) == 0);
4450 SvEND_set(repointer_list, p);
4452 pmop->op_pmoffset = offset;
4453 /* This slot should be free, so assert this: */
4454 assert(PL_regex_pad[offset] == &PL_sv_undef);
4456 SV * const repointer = &PL_sv_undef;
4457 av_push(PL_regex_padav, repointer);
4458 pmop->op_pmoffset = av_len(PL_regex_padav);
4459 PL_regex_pad = AvARRAY(PL_regex_padav);
4463 return CHECKOP(type, pmop);
4466 /* Given some sort of match op o, and an expression expr containing a
4467 * pattern, either compile expr into a regex and attach it to o (if it's
4468 * constant), or convert expr into a runtime regcomp op sequence (if it's
4471 * isreg indicates that the pattern is part of a regex construct, eg
4472 * $x =~ /pattern/ or split /pattern/, as opposed to $x =~ $pattern or
4473 * split "pattern", which aren't. In the former case, expr will be a list
4474 * if the pattern contains more than one term (eg /a$b/) or if it contains
4475 * a replacement, ie s/// or tr///.
4477 * When the pattern has been compiled within a new anon CV (for
4478 * qr/(?{...})/ ), then floor indicates the savestack level just before
4479 * the new sub was created
4483 Perl_pmruntime(pTHX_ OP *o, OP *expr, bool isreg, I32 floor)
4488 I32 repl_has_vars = 0;
4490 bool is_trans = (o->op_type == OP_TRANS || o->op_type == OP_TRANSR);
4491 bool is_compiletime;
4494 PERL_ARGS_ASSERT_PMRUNTIME;
4496 /* for s/// and tr///, last element in list is the replacement; pop it */
4498 if (is_trans || o->op_type == OP_SUBST) {
4500 repl = cLISTOPx(expr)->op_last;
4501 kid = cLISTOPx(expr)->op_first;
4502 while (kid->op_sibling != repl)
4503 kid = kid->op_sibling;
4504 kid->op_sibling = NULL;
4505 cLISTOPx(expr)->op_last = kid;
4508 /* for TRANS, convert LIST/PUSH/CONST into CONST, and pass to pmtrans() */
4511 OP* const oe = expr;
4512 assert(expr->op_type == OP_LIST);
4513 assert(cLISTOPx(expr)->op_first->op_type == OP_PUSHMARK);
4514 assert(cLISTOPx(expr)->op_first->op_sibling == cLISTOPx(expr)->op_last);
4515 expr = cLISTOPx(oe)->op_last;
4516 cLISTOPx(oe)->op_first->op_sibling = NULL;
4517 cLISTOPx(oe)->op_last = NULL;
4520 return pmtrans(o, expr, repl);
4523 /* find whether we have any runtime or code elements;
4524 * at the same time, temporarily set the op_next of each DO block;
4525 * then when we LINKLIST, this will cause the DO blocks to be excluded
4526 * from the op_next chain (and from having LINKLIST recursively
4527 * applied to them). We fix up the DOs specially later */
4531 if (expr->op_type == OP_LIST) {
4533 for (o = cLISTOPx(expr)->op_first; o; o = o->op_sibling) {
4534 if (o->op_type == OP_NULL && (o->op_flags & OPf_SPECIAL)) {
4536 assert(!o->op_next && o->op_sibling);
4537 o->op_next = o->op_sibling;
4539 else if (o->op_type != OP_CONST && o->op_type != OP_PUSHMARK)
4543 else if (expr->op_type != OP_CONST)
4548 /* fix up DO blocks; treat each one as a separate little sub;
4549 * also, mark any arrays as LIST/REF */
4551 if (expr->op_type == OP_LIST) {
4553 for (o = cLISTOPx(expr)->op_first; o; o = o->op_sibling) {
4555 if (o->op_type == OP_PADAV || o->op_type == OP_RV2AV) {
4556 assert( !(o->op_flags & OPf_WANT));
4557 /* push the array rather than its contents. The regex
4558 * engine will retrieve and join the elements later */
4559 o->op_flags |= (OPf_WANT_LIST | OPf_REF);
4563 if (!(o->op_type == OP_NULL && (o->op_flags & OPf_SPECIAL)))
4565 o->op_next = NULL; /* undo temporary hack from above */
4568 if (cLISTOPo->op_first->op_type == OP_LEAVE) {
4569 LISTOP *leaveop = cLISTOPx(cLISTOPo->op_first);
4571 assert(leaveop->op_first->op_type == OP_ENTER);
4572 assert(leaveop->op_first->op_sibling);
4573 o->op_next = leaveop->op_first->op_sibling;
4575 assert(leaveop->op_flags & OPf_KIDS);
4576 assert(leaveop->op_last->op_next == (OP*)leaveop);
4577 leaveop->op_next = NULL; /* stop on last op */
4578 op_null((OP*)leaveop);
4582 OP *scope = cLISTOPo->op_first;
4583 assert(scope->op_type == OP_SCOPE);
4584 assert(scope->op_flags & OPf_KIDS);
4585 scope->op_next = NULL; /* stop on last op */
4588 /* have to peep the DOs individually as we've removed it from
4589 * the op_next chain */
4592 /* runtime finalizes as part of finalizing whole tree */
4596 else if (expr->op_type == OP_PADAV || expr->op_type == OP_RV2AV) {
4597 assert( !(expr->op_flags & OPf_WANT));
4598 /* push the array rather than its contents. The regex
4599 * engine will retrieve and join the elements later */
4600 expr->op_flags |= (OPf_WANT_LIST | OPf_REF);
4603 PL_hints |= HINT_BLOCK_SCOPE;
4605 assert(floor==0 || (pm->op_pmflags & PMf_HAS_CV));
4607 if (is_compiletime) {
4608 U32 rx_flags = pm->op_pmflags & RXf_PMf_COMPILETIME;
4609 regexp_engine const *eng = current_re_engine();
4611 if (o->op_flags & OPf_SPECIAL)
4612 rx_flags |= RXf_SPLIT;
4614 if (!has_code || !eng->op_comp) {
4615 /* compile-time simple constant pattern */
4617 if ((pm->op_pmflags & PMf_HAS_CV) && !has_code) {
4618 /* whoops! we guessed that a qr// had a code block, but we
4619 * were wrong (e.g. /[(?{}]/ ). Throw away the PL_compcv
4620 * that isn't required now. Note that we have to be pretty
4621 * confident that nothing used that CV's pad while the
4622 * regex was parsed */
4623 assert(AvFILLp(PL_comppad) == 0); /* just @_ */
4624 /* But we know that one op is using this CV's slab. */
4625 cv_forget_slab(PL_compcv);
4627 pm->op_pmflags &= ~PMf_HAS_CV;
4632 ? eng->op_comp(aTHX_ NULL, 0, expr, eng, NULL, NULL,
4633 rx_flags, pm->op_pmflags)
4634 : Perl_re_op_compile(aTHX_ NULL, 0, expr, eng, NULL, NULL,
4635 rx_flags, pm->op_pmflags)
4638 op_getmad(expr,(OP*)pm,'e');
4644 /* compile-time pattern that includes literal code blocks */
4645 REGEXP* re = eng->op_comp(aTHX_ NULL, 0, expr, eng, NULL, NULL,
4648 ((PL_hints & HINT_RE_EVAL) ? PMf_USE_RE_EVAL : 0))
4651 if (pm->op_pmflags & PMf_HAS_CV) {
4653 /* this QR op (and the anon sub we embed it in) is never
4654 * actually executed. It's just a placeholder where we can
4655 * squirrel away expr in op_code_list without the peephole
4656 * optimiser etc processing it for a second time */
4657 OP *qr = newPMOP(OP_QR, 0);
4658 ((PMOP*)qr)->op_code_list = expr;
4660 /* handle the implicit sub{} wrapped round the qr/(?{..})/ */
4661 SvREFCNT_inc_simple_void(PL_compcv);
4662 cv = newATTRSUB(floor, 0, NULL, NULL, qr);
4663 ReANY(re)->qr_anoncv = cv;
4665 /* attach the anon CV to the pad so that
4666 * pad_fixup_inner_anons() can find it */
4667 (void)pad_add_anon(cv, o->op_type);
4668 SvREFCNT_inc_simple_void(cv);
4671 pm->op_code_list = expr;
4676 /* runtime pattern: build chain of regcomp etc ops */
4678 PADOFFSET cv_targ = 0;
4680 reglist = isreg && expr->op_type == OP_LIST;
4685 pm->op_code_list = expr;
4686 /* don't free op_code_list; its ops are embedded elsewhere too */
4687 pm->op_pmflags |= PMf_CODELIST_PRIVATE;
4690 if (o->op_flags & OPf_SPECIAL)
4691 pm->op_pmflags |= PMf_SPLIT;
4693 /* the OP_REGCMAYBE is a placeholder in the non-threaded case
4694 * to allow its op_next to be pointed past the regcomp and
4695 * preceding stacking ops;
4696 * OP_REGCRESET is there to reset taint before executing the
4698 if (pm->op_pmflags & PMf_KEEP || TAINTING_get)
4699 expr = newUNOP((TAINTING_get ? OP_REGCRESET : OP_REGCMAYBE),0,expr);
4701 if (pm->op_pmflags & PMf_HAS_CV) {
4702 /* we have a runtime qr with literal code. This means
4703 * that the qr// has been wrapped in a new CV, which
4704 * means that runtime consts, vars etc will have been compiled
4705 * against a new pad. So... we need to execute those ops
4706 * within the environment of the new CV. So wrap them in a call
4707 * to a new anon sub. i.e. for
4711 * we build an anon sub that looks like
4713 * sub { "a", $b, '(?{...})' }
4715 * and call it, passing the returned list to regcomp.
4716 * Or to put it another way, the list of ops that get executed
4720 * ------ -------------------
4721 * pushmark (for regcomp)
4722 * pushmark (for entersub)
4723 * pushmark (for refgen)
4727 * regcreset regcreset
4729 * const("a") const("a")
4731 * const("(?{...})") const("(?{...})")
4736 SvREFCNT_inc_simple_void(PL_compcv);
4737 /* these lines are just an unrolled newANONATTRSUB */
4738 expr = newSVOP(OP_ANONCODE, 0,
4739 MUTABLE_SV(newATTRSUB(floor, 0, NULL, NULL, expr)));
4740 cv_targ = expr->op_targ;
4741 expr = newUNOP(OP_REFGEN, 0, expr);
4743 expr = list(force_list(newUNOP(OP_ENTERSUB, 0, scalar(expr))));
4746 NewOp(1101, rcop, 1, LOGOP);
4747 rcop->op_type = OP_REGCOMP;
4748 rcop->op_ppaddr = PL_ppaddr[OP_REGCOMP];
4749 rcop->op_first = scalar(expr);
4750 rcop->op_flags |= OPf_KIDS
4751 | ((PL_hints & HINT_RE_EVAL) ? OPf_SPECIAL : 0)
4752 | (reglist ? OPf_STACKED : 0);
4753 rcop->op_private = 0;
4755 rcop->op_targ = cv_targ;
4757 /* /$x/ may cause an eval, since $x might be qr/(?{..})/ */
4758 if (PL_hints & HINT_RE_EVAL) PL_cv_has_eval = 1;
4760 /* establish postfix order */
4761 if (expr->op_type == OP_REGCRESET || expr->op_type == OP_REGCMAYBE) {
4763 rcop->op_next = expr;
4764 ((UNOP*)expr)->op_first->op_next = (OP*)rcop;
4767 rcop->op_next = LINKLIST(expr);
4768 expr->op_next = (OP*)rcop;
4771 op_prepend_elem(o->op_type, scalar((OP*)rcop), o);
4777 if (pm->op_pmflags & PMf_EVAL) {
4778 if (CopLINE(PL_curcop) < (line_t)PL_parser->multi_end)
4779 CopLINE_set(PL_curcop, (line_t)PL_parser->multi_end);
4781 /* If we are looking at s//.../e with a single statement, get past
4782 the implicit do{}. */
4783 if (curop->op_type == OP_NULL && curop->op_flags & OPf_KIDS
4784 && cUNOPx(curop)->op_first->op_type == OP_SCOPE
4785 && cUNOPx(curop)->op_first->op_flags & OPf_KIDS) {
4786 OP *kid = cUNOPx(cUNOPx(curop)->op_first)->op_first;
4787 if (kid->op_type == OP_NULL && kid->op_sibling
4788 && !kid->op_sibling->op_sibling)
4789 curop = kid->op_sibling;
4791 if (curop->op_type == OP_CONST)
4793 else if (( (curop->op_type == OP_RV2SV ||
4794 curop->op_type == OP_RV2AV ||
4795 curop->op_type == OP_RV2HV ||
4796 curop->op_type == OP_RV2GV)
4797 && cUNOPx(curop)->op_first
4798 && cUNOPx(curop)->op_first->op_type == OP_GV )
4799 || curop->op_type == OP_PADSV
4800 || curop->op_type == OP_PADAV
4801 || curop->op_type == OP_PADHV
4802 || curop->op_type == OP_PADANY) {
4810 || !RX_PRELEN(PM_GETRE(pm))
4811 || RX_EXTFLAGS(PM_GETRE(pm)) & RXf_EVAL_SEEN)))
4813 pm->op_pmflags |= PMf_CONST; /* const for long enough */
4814 op_prepend_elem(o->op_type, scalar(repl), o);
4817 NewOp(1101, rcop, 1, LOGOP);
4818 rcop->op_type = OP_SUBSTCONT;
4819 rcop->op_ppaddr = PL_ppaddr[OP_SUBSTCONT];
4820 rcop->op_first = scalar(repl);
4821 rcop->op_flags |= OPf_KIDS;
4822 rcop->op_private = 1;
4825 /* establish postfix order */
4826 rcop->op_next = LINKLIST(repl);
4827 repl->op_next = (OP*)rcop;
4829 pm->op_pmreplrootu.op_pmreplroot = scalar((OP*)rcop);
4830 assert(!(pm->op_pmflags & PMf_ONCE));
4831 pm->op_pmstashstartu.op_pmreplstart = LINKLIST(rcop);
4840 =for apidoc Am|OP *|newSVOP|I32 type|I32 flags|SV *sv
4842 Constructs, checks, and returns an op of any type that involves an
4843 embedded SV. I<type> is the opcode. I<flags> gives the eight bits
4844 of C<op_flags>. I<sv> gives the SV to embed in the op; this function
4845 takes ownership of one reference to it.
4851 Perl_newSVOP(pTHX_ I32 type, I32 flags, SV *sv)
4856 PERL_ARGS_ASSERT_NEWSVOP;
4858 assert((PL_opargs[type] & OA_CLASS_MASK) == OA_SVOP
4859 || (PL_opargs[type] & OA_CLASS_MASK) == OA_PVOP_OR_SVOP
4860 || (PL_opargs[type] & OA_CLASS_MASK) == OA_FILESTATOP);
4862 NewOp(1101, svop, 1, SVOP);
4863 svop->op_type = (OPCODE)type;
4864 svop->op_ppaddr = PL_ppaddr[type];
4866 svop->op_next = (OP*)svop;
4867 svop->op_flags = (U8)flags;
4868 svop->op_private = (U8)(0 | (flags >> 8));
4869 if (PL_opargs[type] & OA_RETSCALAR)
4871 if (PL_opargs[type] & OA_TARGET)
4872 svop->op_targ = pad_alloc(type, SVs_PADTMP);
4873 return CHECKOP(type, svop);
4879 =for apidoc Am|OP *|newPADOP|I32 type|I32 flags|SV *sv
4881 Constructs, checks, and returns an op of any type that involves a
4882 reference to a pad element. I<type> is the opcode. I<flags> gives the
4883 eight bits of C<op_flags>. A pad slot is automatically allocated, and
4884 is populated with I<sv>; this function takes ownership of one reference
4887 This function only exists if Perl has been compiled to use ithreads.
4893 Perl_newPADOP(pTHX_ I32 type, I32 flags, SV *sv)
4898 PERL_ARGS_ASSERT_NEWPADOP;
4900 assert((PL_opargs[type] & OA_CLASS_MASK) == OA_SVOP
4901 || (PL_opargs[type] & OA_CLASS_MASK) == OA_PVOP_OR_SVOP
4902 || (PL_opargs[type] & OA_CLASS_MASK) == OA_FILESTATOP);
4904 NewOp(1101, padop, 1, PADOP);
4905 padop->op_type = (OPCODE)type;
4906 padop->op_ppaddr = PL_ppaddr[type];
4907 padop->op_padix = pad_alloc(type, SVs_PADTMP);
4908 SvREFCNT_dec(PAD_SVl(padop->op_padix));
4909 PAD_SETSV(padop->op_padix, sv);
4912 padop->op_next = (OP*)padop;
4913 padop->op_flags = (U8)flags;
4914 if (PL_opargs[type] & OA_RETSCALAR)
4916 if (PL_opargs[type] & OA_TARGET)
4917 padop->op_targ = pad_alloc(type, SVs_PADTMP);
4918 return CHECKOP(type, padop);
4921 #endif /* !USE_ITHREADS */
4924 =for apidoc Am|OP *|newGVOP|I32 type|I32 flags|GV *gv
4926 Constructs, checks, and returns an op of any type that involves an
4927 embedded reference to a GV. I<type> is the opcode. I<flags> gives the
4928 eight bits of C<op_flags>. I<gv> identifies the GV that the op should
4929 reference; calling this function does not transfer ownership of any
4936 Perl_newGVOP(pTHX_ I32 type, I32 flags, GV *gv)
4940 PERL_ARGS_ASSERT_NEWGVOP;
4944 return newPADOP(type, flags, SvREFCNT_inc_simple_NN(gv));
4946 return newSVOP(type, flags, SvREFCNT_inc_simple_NN(gv));
4951 =for apidoc Am|OP *|newPVOP|I32 type|I32 flags|char *pv
4953 Constructs, checks, and returns an op of any type that involves an
4954 embedded C-level pointer (PV). I<type> is the opcode. I<flags> gives
4955 the eight bits of C<op_flags>. I<pv> supplies the C-level pointer, which
4956 must have been allocated using L</PerlMemShared_malloc>; the memory will
4957 be freed when the op is destroyed.
4963 Perl_newPVOP(pTHX_ I32 type, I32 flags, char *pv)
4966 const bool utf8 = cBOOL(flags & SVf_UTF8);
4971 assert((PL_opargs[type] & OA_CLASS_MASK) == OA_PVOP_OR_SVOP
4973 || (PL_opargs[type] & OA_CLASS_MASK) == OA_LOOPEXOP);
4975 NewOp(1101, pvop, 1, PVOP);
4976 pvop->op_type = (OPCODE)type;
4977 pvop->op_ppaddr = PL_ppaddr[type];
4979 pvop->op_next = (OP*)pvop;
4980 pvop->op_flags = (U8)flags;
4981 pvop->op_private = utf8 ? OPpPV_IS_UTF8 : 0;
4982 if (PL_opargs[type] & OA_RETSCALAR)
4984 if (PL_opargs[type] & OA_TARGET)
4985 pvop->op_targ = pad_alloc(type, SVs_PADTMP);
4986 return CHECKOP(type, pvop);
4994 Perl_package(pTHX_ OP *o)
4997 SV *const sv = cSVOPo->op_sv;
5002 PERL_ARGS_ASSERT_PACKAGE;
5004 SAVEGENERICSV(PL_curstash);
5005 save_item(PL_curstname);
5007 PL_curstash = (HV *)SvREFCNT_inc(gv_stashsv(sv, GV_ADD));
5009 sv_setsv(PL_curstname, sv);
5011 PL_hints |= HINT_BLOCK_SCOPE;
5012 PL_parser->copline = NOLINE;
5013 PL_parser->expect = XSTATE;
5018 if (!PL_madskills) {
5023 pegop = newOP(OP_NULL,0);
5024 op_getmad(o,pegop,'P');
5030 Perl_package_version( pTHX_ OP *v )
5033 U32 savehints = PL_hints;
5034 PERL_ARGS_ASSERT_PACKAGE_VERSION;
5035 PL_hints &= ~HINT_STRICT_VARS;
5036 sv_setsv( GvSV(gv_fetchpvs("VERSION", GV_ADDMULTI, SVt_PV)), cSVOPx(v)->op_sv );
5037 PL_hints = savehints;
5046 Perl_utilize(pTHX_ int aver, I32 floor, OP *version, OP *idop, OP *arg)
5053 OP *pegop = PL_madskills ? newOP(OP_NULL,0) : NULL;
5055 SV *use_version = NULL;
5057 PERL_ARGS_ASSERT_UTILIZE;
5059 if (idop->op_type != OP_CONST)
5060 Perl_croak(aTHX_ "Module name must be constant");
5063 op_getmad(idop,pegop,'U');
5068 SV * const vesv = ((SVOP*)version)->op_sv;
5071 op_getmad(version,pegop,'V');
5072 if (!arg && !SvNIOKp(vesv)) {
5079 if (version->op_type != OP_CONST || !SvNIOKp(vesv))
5080 Perl_croak(aTHX_ "Version number must be a constant number");
5082 /* Make copy of idop so we don't free it twice */
5083 pack = newSVOP(OP_CONST, 0, newSVsv(((SVOP*)idop)->op_sv));
5085 /* Fake up a method call to VERSION */
5086 meth = newSVpvs_share("VERSION");
5087 veop = convert(OP_ENTERSUB, OPf_STACKED|OPf_SPECIAL,
5088 op_append_elem(OP_LIST,
5089 op_prepend_elem(OP_LIST, pack, list(version)),
5090 newSVOP(OP_METHOD_NAMED, 0, meth)));
5094 /* Fake up an import/unimport */
5095 if (arg && arg->op_type == OP_STUB) {
5097 op_getmad(arg,pegop,'S');
5098 imop = arg; /* no import on explicit () */
5100 else if (SvNIOKp(((SVOP*)idop)->op_sv)) {
5101 imop = NULL; /* use 5.0; */
5103 use_version = ((SVOP*)idop)->op_sv;
5105 idop->op_private |= OPpCONST_NOVER;
5111 op_getmad(arg,pegop,'A');
5113 /* Make copy of idop so we don't free it twice */
5114 pack = newSVOP(OP_CONST, 0, newSVsv(((SVOP*)idop)->op_sv));
5116 /* Fake up a method call to import/unimport */
5118 ? newSVpvs_share("import") : newSVpvs_share("unimport");
5119 imop = convert(OP_ENTERSUB, OPf_STACKED|OPf_SPECIAL,
5120 op_append_elem(OP_LIST,
5121 op_prepend_elem(OP_LIST, pack, list(arg)),
5122 newSVOP(OP_METHOD_NAMED, 0, meth)));
5125 /* Fake up the BEGIN {}, which does its thing immediately. */
5127 newSVOP(OP_CONST, 0, newSVpvs_share("BEGIN")),
5130 op_append_elem(OP_LINESEQ,
5131 op_append_elem(OP_LINESEQ,
5132 newSTATEOP(0, NULL, newUNOP(OP_REQUIRE, 0, idop)),
5133 newSTATEOP(0, NULL, veop)),
5134 newSTATEOP(0, NULL, imop) ));
5138 * feature bundle that corresponds to the required version. */
5139 use_version = sv_2mortal(new_version(use_version));
5140 S_enable_feature_bundle(aTHX_ use_version);
5142 /* If a version >= 5.11.0 is requested, strictures are on by default! */
5143 if (vcmp(use_version,
5144 sv_2mortal(upg_version(newSVnv(5.011000), FALSE))) >= 0) {
5145 if (!(PL_hints & HINT_EXPLICIT_STRICT_REFS))
5146 PL_hints |= HINT_STRICT_REFS;
5147 if (!(PL_hints & HINT_EXPLICIT_STRICT_SUBS))
5148 PL_hints |= HINT_STRICT_SUBS;
5149 if (!(PL_hints & HINT_EXPLICIT_STRICT_VARS))
5150 PL_hints |= HINT_STRICT_VARS;
5152 /* otherwise they are off */
5154 if (!(PL_hints & HINT_EXPLICIT_STRICT_REFS))
5155 PL_hints &= ~HINT_STRICT_REFS;
5156 if (!(PL_hints & HINT_EXPLICIT_STRICT_SUBS))
5157 PL_hints &= ~HINT_STRICT_SUBS;
5158 if (!(PL_hints & HINT_EXPLICIT_STRICT_VARS))
5159 PL_hints &= ~HINT_STRICT_VARS;
5163 /* The "did you use incorrect case?" warning used to be here.
5164 * The problem is that on case-insensitive filesystems one
5165 * might get false positives for "use" (and "require"):
5166 * "use Strict" or "require CARP" will work. This causes
5167 * portability problems for the script: in case-strict
5168 * filesystems the script will stop working.
5170 * The "incorrect case" warning checked whether "use Foo"
5171 * imported "Foo" to your namespace, but that is wrong, too:
5172 * there is no requirement nor promise in the language that
5173 * a Foo.pm should or would contain anything in package "Foo".
5175 * There is very little Configure-wise that can be done, either:
5176 * the case-sensitivity of the build filesystem of Perl does not
5177 * help in guessing the case-sensitivity of the runtime environment.
5180 PL_hints |= HINT_BLOCK_SCOPE;
5181 PL_parser->copline = NOLINE;
5182 PL_parser->expect = XSTATE;
5183 PL_cop_seqmax++; /* Purely for B::*'s benefit */
5184 if (PL_cop_seqmax == PERL_PADSEQ_INTRO) /* not a legal value */
5193 =head1 Embedding Functions
5195 =for apidoc load_module
5197 Loads the module whose name is pointed to by the string part of name.
5198 Note that the actual module name, not its filename, should be given.
5199 Eg, "Foo::Bar" instead of "Foo/Bar.pm". flags can be any of
5200 PERL_LOADMOD_DENY, PERL_LOADMOD_NOIMPORT, or PERL_LOADMOD_IMPORT_OPS
5201 (or 0 for no flags). ver, if specified and not NULL, provides version semantics
5202 similar to C<use Foo::Bar VERSION>. The optional trailing SV*
5203 arguments can be used to specify arguments to the module's import()
5204 method, similar to C<use Foo::Bar VERSION LIST>. They must be
5205 terminated with a final NULL pointer. Note that this list can only
5206 be omitted when the PERL_LOADMOD_NOIMPORT flag has been used.
5207 Otherwise at least a single NULL pointer to designate the default
5208 import list is required.
5210 The reference count for each specified C<SV*> parameter is decremented.
5215 Perl_load_module(pTHX_ U32 flags, SV *name, SV *ver, ...)
5219 PERL_ARGS_ASSERT_LOAD_MODULE;
5221 va_start(args, ver);
5222 vload_module(flags, name, ver, &args);
5226 #ifdef PERL_IMPLICIT_CONTEXT
5228 Perl_load_module_nocontext(U32 flags, SV *name, SV *ver, ...)
5232 PERL_ARGS_ASSERT_LOAD_MODULE_NOCONTEXT;
5233 va_start(args, ver);
5234 vload_module(flags, name, ver, &args);
5240 Perl_vload_module(pTHX_ U32 flags, SV *name, SV *ver, va_list *args)
5244 OP * const modname = newSVOP(OP_CONST, 0, name);
5246 PERL_ARGS_ASSERT_VLOAD_MODULE;
5248 modname->op_private |= OPpCONST_BARE;
5250 veop = newSVOP(OP_CONST, 0, ver);
5254 if (flags & PERL_LOADMOD_NOIMPORT) {
5255 imop = sawparens(newNULLLIST());
5257 else if (flags & PERL_LOADMOD_IMPORT_OPS) {
5258 imop = va_arg(*args, OP*);
5263 sv = va_arg(*args, SV*);
5265 imop = op_append_elem(OP_LIST, imop, newSVOP(OP_CONST, 0, sv));
5266 sv = va_arg(*args, SV*);
5270 /* utilize() fakes up a BEGIN { require ..; import ... }, so make sure
5271 * that it has a PL_parser to play with while doing that, and also
5272 * that it doesn't mess with any existing parser, by creating a tmp
5273 * new parser with lex_start(). This won't actually be used for much,
5274 * since pp_require() will create another parser for the real work. */
5277 SAVEVPTR(PL_curcop);
5278 lex_start(NULL, NULL, LEX_START_SAME_FILTER);
5279 utilize(!(flags & PERL_LOADMOD_DENY), start_subparse(FALSE, 0),
5280 veop, modname, imop);
5285 Perl_dofile(pTHX_ OP *term, I32 force_builtin)
5291 PERL_ARGS_ASSERT_DOFILE;
5293 if (!force_builtin) {
5294 gv = gv_fetchpvs("do", GV_NOTQUAL, SVt_PVCV);
5295 if (!(gv && GvCVu(gv) && GvIMPORTED_CV(gv))) {
5296 GV * const * const gvp = (GV**)hv_fetchs(PL_globalstash, "do", FALSE);
5297 gv = gvp ? *gvp : NULL;
5301 if (gv && GvCVu(gv) && GvIMPORTED_CV(gv)) {
5302 doop = newUNOP(OP_ENTERSUB, OPf_STACKED,
5303 op_append_elem(OP_LIST, term,
5304 scalar(newUNOP(OP_RV2CV, 0,
5305 newGVOP(OP_GV, 0, gv)))));
5308 doop = newUNOP(OP_DOFILE, 0, scalar(term));
5314 =head1 Optree construction
5316 =for apidoc Am|OP *|newSLICEOP|I32 flags|OP *subscript|OP *listval
5318 Constructs, checks, and returns an C<lslice> (list slice) op. I<flags>
5319 gives the eight bits of C<op_flags>, except that C<OPf_KIDS> will
5320 be set automatically, and, shifted up eight bits, the eight bits of
5321 C<op_private>, except that the bit with value 1 or 2 is automatically
5322 set as required. I<listval> and I<subscript> supply the parameters of
5323 the slice; they are consumed by this function and become part of the
5324 constructed op tree.
5330 Perl_newSLICEOP(pTHX_ I32 flags, OP *subscript, OP *listval)
5332 return newBINOP(OP_LSLICE, flags,
5333 list(force_list(subscript)),
5334 list(force_list(listval)) );
5338 S_is_list_assignment(pTHX_ const OP *o)
5346 if ((o->op_type == OP_NULL) && (o->op_flags & OPf_KIDS))
5347 o = cUNOPo->op_first;
5349 flags = o->op_flags;
5351 if (type == OP_COND_EXPR) {
5352 const I32 t = is_list_assignment(cLOGOPo->op_first->op_sibling);
5353 const I32 f = is_list_assignment(cLOGOPo->op_first->op_sibling->op_sibling);
5358 yyerror("Assignment to both a list and a scalar");
5362 if (type == OP_LIST &&
5363 (flags & OPf_WANT) == OPf_WANT_SCALAR &&
5364 o->op_private & OPpLVAL_INTRO)
5367 if (type == OP_LIST || flags & OPf_PARENS ||
5368 type == OP_RV2AV || type == OP_RV2HV ||
5369 type == OP_ASLICE || type == OP_HSLICE)
5372 if (type == OP_PADAV || type == OP_PADHV)
5375 if (type == OP_RV2SV)
5382 Helper function for newASSIGNOP to detection commonality between the
5383 lhs and the rhs. Marks all variables with PL_generation. If it
5384 returns TRUE the assignment must be able to handle common variables.
5386 PERL_STATIC_INLINE bool
5387 S_aassign_common_vars(pTHX_ OP* o)
5390 for (curop = cUNOPo->op_first; curop; curop=curop->op_sibling) {
5391 if (PL_opargs[curop->op_type] & OA_DANGEROUS) {
5392 if (curop->op_type == OP_GV) {
5393 GV *gv = cGVOPx_gv(curop);
5395 || (int)GvASSIGN_GENERATION(gv) == PL_generation)
5397 GvASSIGN_GENERATION_set(gv, PL_generation);
5399 else if (curop->op_type == OP_PADSV ||
5400 curop->op_type == OP_PADAV ||
5401 curop->op_type == OP_PADHV ||
5402 curop->op_type == OP_PADANY)
5404 if (PAD_COMPNAME_GEN(curop->op_targ)
5405 == (STRLEN)PL_generation)
5407 PAD_COMPNAME_GEN_set(curop->op_targ, PL_generation);
5410 else if (curop->op_type == OP_RV2CV)
5412 else if (curop->op_type == OP_RV2SV ||
5413 curop->op_type == OP_RV2AV ||
5414 curop->op_type == OP_RV2HV ||
5415 curop->op_type == OP_RV2GV) {
5416 if (cUNOPx(curop)->op_first->op_type != OP_GV) /* funny deref? */
5419 else if (curop->op_type == OP_PUSHRE) {
5421 if (((PMOP*)curop)->op_pmreplrootu.op_pmtargetoff) {
5422 GV *const gv = MUTABLE_GV(PAD_SVl(((PMOP*)curop)->op_pmreplrootu.op_pmtargetoff));
5424 || (int)GvASSIGN_GENERATION(gv) == PL_generation)
5426 GvASSIGN_GENERATION_set(gv, PL_generation);
5430 = ((PMOP*)curop)->op_pmreplrootu.op_pmtargetgv;
5433 || (int)GvASSIGN_GENERATION(gv) == PL_generation)
5435 GvASSIGN_GENERATION_set(gv, PL_generation);
5443 if (curop->op_flags & OPf_KIDS) {
5444 if (aassign_common_vars(curop))
5452 =for apidoc Am|OP *|newASSIGNOP|I32 flags|OP *left|I32 optype|OP *right
5454 Constructs, checks, and returns an assignment op. I<left> and I<right>
5455 supply the parameters of the assignment; they are consumed by this
5456 function and become part of the constructed op tree.
5458 If I<optype> is C<OP_ANDASSIGN>, C<OP_ORASSIGN>, or C<OP_DORASSIGN>, then
5459 a suitable conditional optree is constructed. If I<optype> is the opcode
5460 of a binary operator, such as C<OP_BIT_OR>, then an op is constructed that
5461 performs the binary operation and assigns the result to the left argument.
5462 Either way, if I<optype> is non-zero then I<flags> has no effect.
5464 If I<optype> is zero, then a plain scalar or list assignment is
5465 constructed. Which type of assignment it is is automatically determined.
5466 I<flags> gives the eight bits of C<op_flags>, except that C<OPf_KIDS>
5467 will be set automatically, and, shifted up eight bits, the eight bits
5468 of C<op_private>, except that the bit with value 1 or 2 is automatically
5475 Perl_newASSIGNOP(pTHX_ I32 flags, OP *left, I32 optype, OP *right)
5481 if (optype == OP_ANDASSIGN || optype == OP_ORASSIGN || optype == OP_DORASSIGN) {
5482 return newLOGOP(optype, 0,
5483 op_lvalue(scalar(left), optype),
5484 newUNOP(OP_SASSIGN, 0, scalar(right)));
5487 return newBINOP(optype, OPf_STACKED,
5488 op_lvalue(scalar(left), optype), scalar(right));
5492 if (is_list_assignment(left)) {
5493 static const char no_list_state[] = "Initialization of state variables"
5494 " in list context currently forbidden";
5496 bool maybe_common_vars = TRUE;
5499 left = op_lvalue(left, OP_AASSIGN);
5500 curop = list(force_list(left));
5501 o = newBINOP(OP_AASSIGN, flags, list(force_list(right)), curop);
5502 o->op_private = (U8)(0 | (flags >> 8));
5504 if ((left->op_type == OP_LIST
5505 || (left->op_type == OP_NULL && left->op_targ == OP_LIST)))
5507 OP* lop = ((LISTOP*)left)->op_first;
5508 maybe_common_vars = FALSE;
5510 if (lop->op_type == OP_PADSV ||
5511 lop->op_type == OP_PADAV ||
5512 lop->op_type == OP_PADHV ||
5513 lop->op_type == OP_PADANY) {
5514 if (!(lop->op_private & OPpLVAL_INTRO))
5515 maybe_common_vars = TRUE;
5517 if (lop->op_private & OPpPAD_STATE) {
5518 if (left->op_private & OPpLVAL_INTRO) {
5519 /* Each variable in state($a, $b, $c) = ... */
5522 /* Each state variable in
5523 (state $a, my $b, our $c, $d, undef) = ... */
5525 yyerror(no_list_state);
5527 /* Each my variable in
5528 (state $a, my $b, our $c, $d, undef) = ... */
5530 } else if (lop->op_type == OP_UNDEF ||
5531 lop->op_type == OP_PUSHMARK) {
5532 /* undef may be interesting in
5533 (state $a, undef, state $c) */
5535 /* Other ops in the list. */
5536 maybe_common_vars = TRUE;
5538 lop = lop->op_sibling;
5541 else if ((left->op_private & OPpLVAL_INTRO)
5542 && ( left->op_type == OP_PADSV
5543 || left->op_type == OP_PADAV
5544 || left->op_type == OP_PADHV
5545 || left->op_type == OP_PADANY))
5547 if (left->op_type == OP_PADSV) maybe_common_vars = FALSE;
5548 if (left->op_private & OPpPAD_STATE) {
5549 /* All single variable list context state assignments, hence
5559 yyerror(no_list_state);
5563 /* PL_generation sorcery:
5564 * an assignment like ($a,$b) = ($c,$d) is easier than
5565 * ($a,$b) = ($c,$a), since there is no need for temporary vars.
5566 * To detect whether there are common vars, the global var
5567 * PL_generation is incremented for each assign op we compile.
5568 * Then, while compiling the assign op, we run through all the
5569 * variables on both sides of the assignment, setting a spare slot
5570 * in each of them to PL_generation. If any of them already have
5571 * that value, we know we've got commonality. We could use a
5572 * single bit marker, but then we'd have to make 2 passes, first
5573 * to clear the flag, then to test and set it. To find somewhere
5574 * to store these values, evil chicanery is done with SvUVX().
5577 if (maybe_common_vars) {
5579 if (aassign_common_vars(o))
5580 o->op_private |= OPpASSIGN_COMMON;
5584 if (right && right->op_type == OP_SPLIT && !PL_madskills) {
5585 OP* tmpop = ((LISTOP*)right)->op_first;
5586 if (tmpop && (tmpop->op_type == OP_PUSHRE)) {
5587 PMOP * const pm = (PMOP*)tmpop;
5588 if (left->op_type == OP_RV2AV &&
5589 !(left->op_private & OPpLVAL_INTRO) &&
5590 !(o->op_private & OPpASSIGN_COMMON) )
5592 tmpop = ((UNOP*)left)->op_first;
5593 if (tmpop->op_type == OP_GV
5595 && !pm->op_pmreplrootu.op_pmtargetoff
5597 && !pm->op_pmreplrootu.op_pmtargetgv
5601 pm->op_pmreplrootu.op_pmtargetoff
5602 = cPADOPx(tmpop)->op_padix;
5603 cPADOPx(tmpop)->op_padix = 0; /* steal it */
5605 pm->op_pmreplrootu.op_pmtargetgv
5606 = MUTABLE_GV(cSVOPx(tmpop)->op_sv);
5607 cSVOPx(tmpop)->op_sv = NULL; /* steal it */
5609 tmpop = cUNOPo->op_first; /* to list (nulled) */
5610 tmpop = ((UNOP*)tmpop)->op_first; /* to pushmark */
5611 tmpop->op_sibling = NULL; /* don't free split */
5612 right->op_next = tmpop->op_next; /* fix starting loc */
5613 op_free(o); /* blow off assign */
5614 right->op_flags &= ~OPf_WANT;
5615 /* "I don't know and I don't care." */
5620 if (PL_modcount < RETURN_UNLIMITED_NUMBER &&
5621 ((LISTOP*)right)->op_last->op_type == OP_CONST)
5623 SV *sv = ((SVOP*)((LISTOP*)right)->op_last)->op_sv;
5624 if (SvIOK(sv) && SvIVX(sv) == 0)
5625 sv_setiv(sv, PL_modcount+1);
5633 right = newOP(OP_UNDEF, 0);
5634 if (right->op_type == OP_READLINE) {
5635 right->op_flags |= OPf_STACKED;
5636 return newBINOP(OP_NULL, flags, op_lvalue(scalar(left), OP_SASSIGN),
5640 o = newBINOP(OP_SASSIGN, flags,
5641 scalar(right), op_lvalue(scalar(left), OP_SASSIGN) );
5647 =for apidoc Am|OP *|newSTATEOP|I32 flags|char *label|OP *o
5649 Constructs a state op (COP). The state op is normally a C<nextstate> op,
5650 but will be a C<dbstate> op if debugging is enabled for currently-compiled
5651 code. The state op is populated from L</PL_curcop> (or L</PL_compiling>).
5652 If I<label> is non-null, it supplies the name of a label to attach to
5653 the state op; this function takes ownership of the memory pointed at by
5654 I<label>, and will free it. I<flags> gives the eight bits of C<op_flags>
5657 If I<o> is null, the state op is returned. Otherwise the state op is
5658 combined with I<o> into a C<lineseq> list op, which is returned. I<o>
5659 is consumed by this function and becomes part of the returned op tree.
5665 Perl_newSTATEOP(pTHX_ I32 flags, char *label, OP *o)
5668 const U32 seq = intro_my();
5669 const U32 utf8 = flags & SVf_UTF8;
5674 NewOp(1101, cop, 1, COP);
5675 if (PERLDB_LINE && CopLINE(PL_curcop) && PL_curstash != PL_debstash) {
5676 cop->op_type = OP_DBSTATE;
5677 cop->op_ppaddr = PL_ppaddr[ OP_DBSTATE ];
5680 cop->op_type = OP_NEXTSTATE;
5681 cop->op_ppaddr = PL_ppaddr[ OP_NEXTSTATE ];
5683 cop->op_flags = (U8)flags;
5684 CopHINTS_set(cop, PL_hints);
5686 cop->op_private |= NATIVE_HINTS;
5688 CopHINTS_set(&PL_compiling, CopHINTS_get(cop));
5689 cop->op_next = (OP*)cop;
5692 cop->cop_warnings = DUP_WARNINGS(PL_curcop->cop_warnings);
5693 CopHINTHASH_set(cop, cophh_copy(CopHINTHASH_get(PL_curcop)));
5695 Perl_cop_store_label(aTHX_ cop, label, strlen(label), utf8);
5697 PL_hints |= HINT_BLOCK_SCOPE;
5698 /* It seems that we need to defer freeing this pointer, as other parts
5699 of the grammar end up wanting to copy it after this op has been
5704 if (PL_parser && PL_parser->copline == NOLINE)
5705 CopLINE_set(cop, CopLINE(PL_curcop));
5707 CopLINE_set(cop, PL_parser->copline);
5708 PL_parser->copline = NOLINE;
5711 CopFILE_set(cop, CopFILE(PL_curcop)); /* XXX share in a pvtable? */
5713 CopFILEGV_set(cop, CopFILEGV(PL_curcop));
5715 CopSTASH_set(cop, PL_curstash);
5717 if ((PERLDB_LINE || PERLDB_SAVESRC) && PL_curstash != PL_debstash) {
5718 /* this line can have a breakpoint - store the cop in IV */
5719 AV *av = CopFILEAVx(PL_curcop);
5721 SV * const * const svp = av_fetch(av, (I32)CopLINE(cop), FALSE);
5722 if (svp && *svp != &PL_sv_undef ) {
5723 (void)SvIOK_on(*svp);
5724 SvIV_set(*svp, PTR2IV(cop));
5729 if (flags & OPf_SPECIAL)
5731 return op_prepend_elem(OP_LINESEQ, (OP*)cop, o);
5735 =for apidoc Am|OP *|newLOGOP|I32 type|I32 flags|OP *first|OP *other
5737 Constructs, checks, and returns a logical (flow control) op. I<type>
5738 is the opcode. I<flags> gives the eight bits of C<op_flags>, except
5739 that C<OPf_KIDS> will be set automatically, and, shifted up eight bits,
5740 the eight bits of C<op_private>, except that the bit with value 1 is
5741 automatically set. I<first> supplies the expression controlling the
5742 flow, and I<other> supplies the side (alternate) chain of ops; they are
5743 consumed by this function and become part of the constructed op tree.
5749 Perl_newLOGOP(pTHX_ I32 type, I32 flags, OP *first, OP *other)
5753 PERL_ARGS_ASSERT_NEWLOGOP;
5755 return new_logop(type, flags, &first, &other);
5759 S_search_const(pTHX_ OP *o)
5761 PERL_ARGS_ASSERT_SEARCH_CONST;
5763 switch (o->op_type) {
5767 if (o->op_flags & OPf_KIDS)
5768 return search_const(cUNOPo->op_first);
5775 if (!(o->op_flags & OPf_KIDS))
5777 kid = cLISTOPo->op_first;
5779 switch (kid->op_type) {
5783 kid = kid->op_sibling;
5786 if (kid != cLISTOPo->op_last)
5792 kid = cLISTOPo->op_last;
5794 return search_const(kid);
5802 S_new_logop(pTHX_ I32 type, I32 flags, OP** firstp, OP** otherp)
5810 int prepend_not = 0;
5812 PERL_ARGS_ASSERT_NEW_LOGOP;
5817 if (type == OP_XOR) /* Not short circuit, but here by precedence. */
5818 return newBINOP(type, flags, scalar(first), scalar(other));
5820 assert((PL_opargs[type] & OA_CLASS_MASK) == OA_LOGOP);
5822 scalarboolean(first);
5823 /* optimize AND and OR ops that have NOTs as children */
5824 if (first->op_type == OP_NOT
5825 && (first->op_flags & OPf_KIDS)
5826 && ((first->op_flags & OPf_SPECIAL) /* unless ($x) { } */
5827 || (other->op_type == OP_NOT)) /* if (!$x && !$y) { } */
5829 if (type == OP_AND || type == OP_OR) {
5835 if (other->op_type == OP_NOT) { /* !a AND|OR !b => !(a OR|AND b) */
5837 prepend_not = 1; /* prepend a NOT op later */
5841 /* search for a constant op that could let us fold the test */
5842 if ((cstop = search_const(first))) {
5843 if (cstop->op_private & OPpCONST_STRICT)
5844 no_bareword_allowed(cstop);
5845 else if ((cstop->op_private & OPpCONST_BARE))
5846 Perl_ck_warner(aTHX_ packWARN(WARN_BAREWORD), "Bareword found in conditional");
5847 if ((type == OP_AND && SvTRUE(((SVOP*)cstop)->op_sv)) ||
5848 (type == OP_OR && !SvTRUE(((SVOP*)cstop)->op_sv)) ||
5849 (type == OP_DOR && !SvOK(((SVOP*)cstop)->op_sv))) {
5851 if (other->op_type == OP_CONST)
5852 other->op_private |= OPpCONST_SHORTCIRCUIT;
5854 OP *newop = newUNOP(OP_NULL, 0, other);
5855 op_getmad(first, newop, '1');
5856 newop->op_targ = type; /* set "was" field */
5860 if (other->op_type == OP_LEAVE)
5861 other = newUNOP(OP_NULL, OPf_SPECIAL, other);
5862 else if (other->op_type == OP_MATCH
5863 || other->op_type == OP_SUBST
5864 || other->op_type == OP_TRANSR
5865 || other->op_type == OP_TRANS)
5866 /* Mark the op as being unbindable with =~ */
5867 other->op_flags |= OPf_SPECIAL;
5868 else if (other->op_type == OP_CONST)
5869 other->op_private |= OPpCONST_FOLDED;
5873 /* check for C<my $x if 0>, or C<my($x,$y) if 0> */
5874 const OP *o2 = other;
5875 if ( ! (o2->op_type == OP_LIST
5876 && (( o2 = cUNOPx(o2)->op_first))
5877 && o2->op_type == OP_PUSHMARK
5878 && (( o2 = o2->op_sibling)) )
5881 if ((o2->op_type == OP_PADSV || o2->op_type == OP_PADAV
5882 || o2->op_type == OP_PADHV)
5883 && o2->op_private & OPpLVAL_INTRO
5884 && !(o2->op_private & OPpPAD_STATE))
5886 Perl_ck_warner_d(aTHX_ packWARN(WARN_DEPRECATED),
5887 "Deprecated use of my() in false conditional");
5891 if (first->op_type == OP_CONST)
5892 first->op_private |= OPpCONST_SHORTCIRCUIT;
5894 first = newUNOP(OP_NULL, 0, first);
5895 op_getmad(other, first, '2');
5896 first->op_targ = type; /* set "was" field */
5903 else if ((first->op_flags & OPf_KIDS) && type != OP_DOR
5904 && ckWARN(WARN_MISC)) /* [#24076] Don't warn for <FH> err FOO. */
5906 const OP * const k1 = ((UNOP*)first)->op_first;
5907 const OP * const k2 = k1->op_sibling;
5909 switch (first->op_type)
5912 if (k2 && k2->op_type == OP_READLINE
5913 && (k2->op_flags & OPf_STACKED)
5914 && ((k1->op_flags & OPf_WANT) == OPf_WANT_SCALAR))
5916 warnop = k2->op_type;
5921 if (k1->op_type == OP_READDIR
5922 || k1->op_type == OP_GLOB
5923 || (k1->op_type == OP_NULL && k1->op_targ == OP_GLOB)
5924 || k1->op_type == OP_EACH
5925 || k1->op_type == OP_AEACH)
5927 warnop = ((k1->op_type == OP_NULL)
5928 ? (OPCODE)k1->op_targ : k1->op_type);
5933 const line_t oldline = CopLINE(PL_curcop);
5934 /* This ensures that warnings are reported at the first line
5935 of the construction, not the last. */
5936 CopLINE_set(PL_curcop, PL_parser->copline);
5937 Perl_warner(aTHX_ packWARN(WARN_MISC),
5938 "Value of %s%s can be \"0\"; test with defined()",
5940 ((warnop == OP_READLINE || warnop == OP_GLOB)
5941 ? " construct" : "() operator"));
5942 CopLINE_set(PL_curcop, oldline);
5949 if (type == OP_ANDASSIGN || type == OP_ORASSIGN || type == OP_DORASSIGN)
5950 other->op_private |= OPpASSIGN_BACKWARDS; /* other is an OP_SASSIGN */
5952 NewOp(1101, logop, 1, LOGOP);
5954 logop->op_type = (OPCODE)type;
5955 logop->op_ppaddr = PL_ppaddr[type];
5956 logop->op_first = first;
5957 logop->op_flags = (U8)(flags | OPf_KIDS);
5958 logop->op_other = LINKLIST(other);
5959 logop->op_private = (U8)(1 | (flags >> 8));
5961 /* establish postfix order */
5962 logop->op_next = LINKLIST(first);
5963 first->op_next = (OP*)logop;
5964 first->op_sibling = other;
5966 CHECKOP(type,logop);
5968 o = newUNOP(prepend_not ? OP_NOT : OP_NULL, 0, (OP*)logop);
5975 =for apidoc Am|OP *|newCONDOP|I32 flags|OP *first|OP *trueop|OP *falseop
5977 Constructs, checks, and returns a conditional-expression (C<cond_expr>)
5978 op. I<flags> gives the eight bits of C<op_flags>, except that C<OPf_KIDS>
5979 will be set automatically, and, shifted up eight bits, the eight bits of
5980 C<op_private>, except that the bit with value 1 is automatically set.
5981 I<first> supplies the expression selecting between the two branches,
5982 and I<trueop> and I<falseop> supply the branches; they are consumed by
5983 this function and become part of the constructed op tree.
5989 Perl_newCONDOP(pTHX_ I32 flags, OP *first, OP *trueop, OP *falseop)
5997 PERL_ARGS_ASSERT_NEWCONDOP;
6000 return newLOGOP(OP_AND, 0, first, trueop);
6002 return newLOGOP(OP_OR, 0, first, falseop);
6004 scalarboolean(first);
6005 if ((cstop = search_const(first))) {
6006 /* Left or right arm of the conditional? */
6007 const bool left = SvTRUE(((SVOP*)cstop)->op_sv);
6008 OP *live = left ? trueop : falseop;
6009 OP *const dead = left ? falseop : trueop;
6010 if (cstop->op_private & OPpCONST_BARE &&
6011 cstop->op_private & OPpCONST_STRICT) {
6012 no_bareword_allowed(cstop);
6015 /* This is all dead code when PERL_MAD is not defined. */
6016 live = newUNOP(OP_NULL, 0, live);
6017 op_getmad(first, live, 'C');
6018 op_getmad(dead, live, left ? 'e' : 't');
6023 if (live->op_type == OP_LEAVE)
6024 live = newUNOP(OP_NULL, OPf_SPECIAL, live);
6025 else if (live->op_type == OP_MATCH || live->op_type == OP_SUBST
6026 || live->op_type == OP_TRANS || live->op_type == OP_TRANSR)
6027 /* Mark the op as being unbindable with =~ */
6028 live->op_flags |= OPf_SPECIAL;
6029 else if (live->op_type == OP_CONST)
6030 live->op_private |= OPpCONST_FOLDED;
6033 NewOp(1101, logop, 1, LOGOP);
6034 logop->op_type = OP_COND_EXPR;
6035 logop->op_ppaddr = PL_ppaddr[OP_COND_EXPR];
6036 logop->op_first = first;
6037 logop->op_flags = (U8)(flags | OPf_KIDS);
6038 logop->op_private = (U8)(1 | (flags >> 8));
6039 logop->op_other = LINKLIST(trueop);
6040 logop->op_next = LINKLIST(falseop);
6042 CHECKOP(OP_COND_EXPR, /* that's logop->op_type */
6045 /* establish postfix order */
6046 start = LINKLIST(first);
6047 first->op_next = (OP*)logop;
6049 first->op_sibling = trueop;
6050 trueop->op_sibling = falseop;
6051 o = newUNOP(OP_NULL, 0, (OP*)logop);
6053 trueop->op_next = falseop->op_next = o;
6060 =for apidoc Am|OP *|newRANGE|I32 flags|OP *left|OP *right
6062 Constructs and returns a C<range> op, with subordinate C<flip> and
6063 C<flop> ops. I<flags> gives the eight bits of C<op_flags> for the
6064 C<flip> op and, shifted up eight bits, the eight bits of C<op_private>
6065 for both the C<flip> and C<range> ops, except that the bit with value
6066 1 is automatically set. I<left> and I<right> supply the expressions
6067 controlling the endpoints of the range; they are consumed by this function
6068 and become part of the constructed op tree.
6074 Perl_newRANGE(pTHX_ I32 flags, OP *left, OP *right)
6083 PERL_ARGS_ASSERT_NEWRANGE;
6085 NewOp(1101, range, 1, LOGOP);
6087 range->op_type = OP_RANGE;
6088 range->op_ppaddr = PL_ppaddr[OP_RANGE];
6089 range->op_first = left;
6090 range->op_flags = OPf_KIDS;
6091 leftstart = LINKLIST(left);
6092 range->op_other = LINKLIST(right);
6093 range->op_private = (U8)(1 | (flags >> 8));
6095 left->op_sibling = right;
6097 range->op_next = (OP*)range;
6098 flip = newUNOP(OP_FLIP, flags, (OP*)range);
6099 flop = newUNOP(OP_FLOP, 0, flip);
6100 o = newUNOP(OP_NULL, 0, flop);
6102 range->op_next = leftstart;
6104 left->op_next = flip;
6105 right->op_next = flop;
6107 range->op_targ = pad_alloc(OP_RANGE, SVs_PADMY);
6108 sv_upgrade(PAD_SV(range->op_targ), SVt_PVNV);
6109 flip->op_targ = pad_alloc(OP_RANGE, SVs_PADMY);
6110 sv_upgrade(PAD_SV(flip->op_targ), SVt_PVNV);
6112 flip->op_private = left->op_type == OP_CONST ? OPpFLIP_LINENUM : 0;
6113 flop->op_private = right->op_type == OP_CONST ? OPpFLIP_LINENUM : 0;
6115 /* check barewords before they might be optimized aways */
6116 if (flip->op_private && cSVOPx(left)->op_private & OPpCONST_STRICT)
6117 no_bareword_allowed(left);
6118 if (flop->op_private && cSVOPx(right)->op_private & OPpCONST_STRICT)
6119 no_bareword_allowed(right);
6122 if (!flip->op_private || !flop->op_private)
6123 LINKLIST(o); /* blow off optimizer unless constant */
6129 =for apidoc Am|OP *|newLOOPOP|I32 flags|I32 debuggable|OP *expr|OP *block
6131 Constructs, checks, and returns an op tree expressing a loop. This is
6132 only a loop in the control flow through the op tree; it does not have
6133 the heavyweight loop structure that allows exiting the loop by C<last>
6134 and suchlike. I<flags> gives the eight bits of C<op_flags> for the
6135 top-level op, except that some bits will be set automatically as required.
6136 I<expr> supplies the expression controlling loop iteration, and I<block>
6137 supplies the body of the loop; they are consumed by this function and
6138 become part of the constructed op tree. I<debuggable> is currently
6139 unused and should always be 1.
6145 Perl_newLOOPOP(pTHX_ I32 flags, I32 debuggable, OP *expr, OP *block)
6150 const bool once = block && block->op_flags & OPf_SPECIAL &&
6151 (block->op_type == OP_ENTERSUB || block->op_type == OP_NULL);
6153 PERL_UNUSED_ARG(debuggable);
6156 if (once && expr->op_type == OP_CONST && !SvTRUE(((SVOP*)expr)->op_sv))
6157 return block; /* do {} while 0 does once */
6158 if (expr->op_type == OP_READLINE
6159 || expr->op_type == OP_READDIR
6160 || expr->op_type == OP_GLOB
6161 || expr->op_type == OP_EACH || expr->op_type == OP_AEACH
6162 || (expr->op_type == OP_NULL && expr->op_targ == OP_GLOB)) {
6163 expr = newUNOP(OP_DEFINED, 0,
6164 newASSIGNOP(0, newDEFSVOP(), 0, expr) );
6165 } else if (expr->op_flags & OPf_KIDS) {
6166 const OP * const k1 = ((UNOP*)expr)->op_first;
6167 const OP * const k2 = k1 ? k1->op_sibling : NULL;
6168 switch (expr->op_type) {
6170 if (k2 && (k2->op_type == OP_READLINE || k2->op_type == OP_READDIR)
6171 && (k2->op_flags & OPf_STACKED)
6172 && ((k1->op_flags & OPf_WANT) == OPf_WANT_SCALAR))
6173 expr = newUNOP(OP_DEFINED, 0, expr);
6177 if (k1 && (k1->op_type == OP_READDIR
6178 || k1->op_type == OP_GLOB
6179 || (k1->op_type == OP_NULL && k1->op_targ == OP_GLOB)
6180 || k1->op_type == OP_EACH
6181 || k1->op_type == OP_AEACH))
6182 expr = newUNOP(OP_DEFINED, 0, expr);
6188 /* if block is null, the next op_append_elem() would put UNSTACK, a scalar
6189 * op, in listop. This is wrong. [perl #27024] */
6191 block = newOP(OP_NULL, 0);
6192 listop = op_append_elem(OP_LINESEQ, block, newOP(OP_UNSTACK, 0));
6193 o = new_logop(OP_AND, 0, &expr, &listop);
6196 ((LISTOP*)listop)->op_last->op_next = LINKLIST(o);
6198 if (once && o != listop)
6199 o->op_next = ((LOGOP*)cUNOPo->op_first)->op_other;
6202 o = newUNOP(OP_NULL, 0, o); /* or do {} while 1 loses outer block */
6204 o->op_flags |= flags;
6206 o->op_flags |= OPf_SPECIAL; /* suppress POPBLOCK curpm restoration*/
6211 =for apidoc Am|OP *|newWHILEOP|I32 flags|I32 debuggable|LOOP *loop|OP *expr|OP *block|OP *cont|I32 has_my
6213 Constructs, checks, and returns an op tree expressing a C<while> loop.
6214 This is a heavyweight loop, with structure that allows exiting the loop
6215 by C<last> and suchlike.
6217 I<loop> is an optional preconstructed C<enterloop> op to use in the
6218 loop; if it is null then a suitable op will be constructed automatically.
6219 I<expr> supplies the loop's controlling expression. I<block> supplies the
6220 main body of the loop, and I<cont> optionally supplies a C<continue> block
6221 that operates as a second half of the body. All of these optree inputs
6222 are consumed by this function and become part of the constructed op tree.
6224 I<flags> gives the eight bits of C<op_flags> for the C<leaveloop>
6225 op and, shifted up eight bits, the eight bits of C<op_private> for
6226 the C<leaveloop> op, except that (in both cases) some bits will be set
6227 automatically. I<debuggable> is currently unused and should always be 1.
6228 I<has_my> can be supplied as true to force the
6229 loop body to be enclosed in its own scope.
6235 Perl_newWHILEOP(pTHX_ I32 flags, I32 debuggable, LOOP *loop,
6236 OP *expr, OP *block, OP *cont, I32 has_my)
6245 PERL_UNUSED_ARG(debuggable);
6248 if (expr->op_type == OP_READLINE
6249 || expr->op_type == OP_READDIR
6250 || expr->op_type == OP_GLOB
6251 || expr->op_type == OP_EACH || expr->op_type == OP_AEACH
6252 || (expr->op_type == OP_NULL && expr->op_targ == OP_GLOB)) {
6253 expr = newUNOP(OP_DEFINED, 0,
6254 newASSIGNOP(0, newDEFSVOP(), 0, expr) );
6255 } else if (expr->op_flags & OPf_KIDS) {
6256 const OP * const k1 = ((UNOP*)expr)->op_first;
6257 const OP * const k2 = (k1) ? k1->op_sibling : NULL;
6258 switch (expr->op_type) {
6260 if (k2 && (k2->op_type == OP_READLINE || k2->op_type == OP_READDIR)
6261 && (k2->op_flags & OPf_STACKED)
6262 && ((k1->op_flags & OPf_WANT) == OPf_WANT_SCALAR))
6263 expr = newUNOP(OP_DEFINED, 0, expr);
6267 if (k1 && (k1->op_type == OP_READDIR
6268 || k1->op_type == OP_GLOB
6269 || (k1->op_type == OP_NULL && k1->op_targ == OP_GLOB)
6270 || k1->op_type == OP_EACH
6271 || k1->op_type == OP_AEACH))
6272 expr = newUNOP(OP_DEFINED, 0, expr);
6279 block = newOP(OP_NULL, 0);
6280 else if (cont || has_my) {
6281 block = op_scope(block);
6285 next = LINKLIST(cont);
6288 OP * const unstack = newOP(OP_UNSTACK, 0);
6291 cont = op_append_elem(OP_LINESEQ, cont, unstack);
6295 listop = op_append_list(OP_LINESEQ, block, cont);
6297 redo = LINKLIST(listop);
6301 o = new_logop(OP_AND, 0, &expr, &listop);
6302 if (o == expr && o->op_type == OP_CONST && !SvTRUE(cSVOPo->op_sv)) {
6304 return expr; /* listop already freed by new_logop */
6307 ((LISTOP*)listop)->op_last->op_next =
6308 (o == listop ? redo : LINKLIST(o));
6314 NewOp(1101,loop,1,LOOP);
6315 loop->op_type = OP_ENTERLOOP;
6316 loop->op_ppaddr = PL_ppaddr[OP_ENTERLOOP];
6317 loop->op_private = 0;
6318 loop->op_next = (OP*)loop;
6321 o = newBINOP(OP_LEAVELOOP, 0, (OP*)loop, o);
6323 loop->op_redoop = redo;
6324 loop->op_lastop = o;
6325 o->op_private |= loopflags;
6328 loop->op_nextop = next;
6330 loop->op_nextop = o;
6332 o->op_flags |= flags;
6333 o->op_private |= (flags >> 8);
6338 =for apidoc Am|OP *|newFOROP|I32 flags|OP *sv|OP *expr|OP *block|OP *cont
6340 Constructs, checks, and returns an op tree expressing a C<foreach>
6341 loop (iteration through a list of values). This is a heavyweight loop,
6342 with structure that allows exiting the loop by C<last> and suchlike.
6344 I<sv> optionally supplies the variable that will be aliased to each
6345 item in turn; if null, it defaults to C<$_> (either lexical or global).
6346 I<expr> supplies the list of values to iterate over. I<block> supplies
6347 the main body of the loop, and I<cont> optionally supplies a C<continue>
6348 block that operates as a second half of the body. All of these optree
6349 inputs are consumed by this function and become part of the constructed
6352 I<flags> gives the eight bits of C<op_flags> for the C<leaveloop>
6353 op and, shifted up eight bits, the eight bits of C<op_private> for
6354 the C<leaveloop> op, except that (in both cases) some bits will be set
6361 Perl_newFOROP(pTHX_ I32 flags, OP *sv, OP *expr, OP *block, OP *cont)
6366 PADOFFSET padoff = 0;
6371 PERL_ARGS_ASSERT_NEWFOROP;
6374 if (sv->op_type == OP_RV2SV) { /* symbol table variable */
6375 iterpflags = sv->op_private & OPpOUR_INTRO; /* for our $x () */
6376 sv->op_type = OP_RV2GV;
6377 sv->op_ppaddr = PL_ppaddr[OP_RV2GV];
6379 /* The op_type check is needed to prevent a possible segfault
6380 * if the loop variable is undeclared and 'strict vars' is in
6381 * effect. This is illegal but is nonetheless parsed, so we
6382 * may reach this point with an OP_CONST where we're expecting
6385 if (cUNOPx(sv)->op_first->op_type == OP_GV
6386 && cGVOPx_gv(cUNOPx(sv)->op_first) == PL_defgv)
6387 iterpflags |= OPpITER_DEF;
6389 else if (sv->op_type == OP_PADSV) { /* private variable */
6390 iterpflags = sv->op_private & OPpLVAL_INTRO; /* for my $x () */
6391 padoff = sv->op_targ;
6401 Perl_croak(aTHX_ "Can't use %s for loop variable", PL_op_desc[sv->op_type]);
6403 SV *const namesv = PAD_COMPNAME_SV(padoff);
6405 const char *const name = SvPV_const(namesv, len);
6407 if (len == 2 && name[0] == '$' && name[1] == '_')
6408 iterpflags |= OPpITER_DEF;
6412 const PADOFFSET offset = pad_findmy_pvs("$_", 0);
6413 if (offset == NOT_IN_PAD || PAD_COMPNAME_FLAGS_isOUR(offset)) {
6414 sv = newGVOP(OP_GV, 0, PL_defgv);
6419 iterpflags |= OPpITER_DEF;
6421 if (expr->op_type == OP_RV2AV || expr->op_type == OP_PADAV) {
6422 expr = op_lvalue(force_list(scalar(ref(expr, OP_ITER))), OP_GREPSTART);
6423 iterflags |= OPf_STACKED;
6425 else if (expr->op_type == OP_NULL &&
6426 (expr->op_flags & OPf_KIDS) &&
6427 ((BINOP*)expr)->op_first->op_type == OP_FLOP)
6429 /* Basically turn for($x..$y) into the same as for($x,$y), but we
6430 * set the STACKED flag to indicate that these values are to be
6431 * treated as min/max values by 'pp_enteriter'.
6433 const UNOP* const flip = (UNOP*)((UNOP*)((BINOP*)expr)->op_first)->op_first;
6434 LOGOP* const range = (LOGOP*) flip->op_first;
6435 OP* const left = range->op_first;
6436 OP* const right = left->op_sibling;
6439 range->op_flags &= ~OPf_KIDS;
6440 range->op_first = NULL;
6442 listop = (LISTOP*)newLISTOP(OP_LIST, 0, left, right);
6443 listop->op_first->op_next = range->op_next;
6444 left->op_next = range->op_other;
6445 right->op_next = (OP*)listop;
6446 listop->op_next = listop->op_first;
6449 op_getmad(expr,(OP*)listop,'O');
6453 expr = (OP*)(listop);
6455 iterflags |= OPf_STACKED;
6458 expr = op_lvalue(force_list(expr), OP_GREPSTART);
6461 loop = (LOOP*)list(convert(OP_ENTERITER, iterflags,
6462 op_append_elem(OP_LIST, expr, scalar(sv))));
6463 assert(!loop->op_next);
6464 /* for my $x () sets OPpLVAL_INTRO;
6465 * for our $x () sets OPpOUR_INTRO */
6466 loop->op_private = (U8)iterpflags;
6467 if (loop->op_slabbed
6468 && DIFF(loop, OpSLOT(loop)->opslot_next)
6469 < SIZE_TO_PSIZE(sizeof(LOOP)))
6472 NewOp(1234,tmp,1,LOOP);
6473 Copy(loop,tmp,1,LISTOP);
6474 S_op_destroy(aTHX_ (OP*)loop);
6477 else if (!loop->op_slabbed)
6478 loop = (LOOP*)PerlMemShared_realloc(loop, sizeof(LOOP));
6479 loop->op_targ = padoff;
6480 wop = newWHILEOP(flags, 1, loop, newOP(OP_ITER, 0), block, cont, 0);
6482 op_getmad(madsv, (OP*)loop, 'v');
6487 =for apidoc Am|OP *|newLOOPEX|I32 type|OP *label
6489 Constructs, checks, and returns a loop-exiting op (such as C<goto>
6490 or C<last>). I<type> is the opcode. I<label> supplies the parameter
6491 determining the target of the op; it is consumed by this function and
6492 becomes part of the constructed op tree.
6498 Perl_newLOOPEX(pTHX_ I32 type, OP *label)
6503 PERL_ARGS_ASSERT_NEWLOOPEX;
6505 assert((PL_opargs[type] & OA_CLASS_MASK) == OA_LOOPEXOP);
6507 if (type != OP_GOTO) {
6508 /* "last()" means "last" */
6509 if (label->op_type == OP_STUB && (label->op_flags & OPf_PARENS)) {
6510 o = newOP(type, OPf_SPECIAL);
6514 /* Check whether it's going to be a goto &function */
6515 if (label->op_type == OP_ENTERSUB
6516 && !(label->op_flags & OPf_STACKED))
6517 label = newUNOP(OP_REFGEN, 0, op_lvalue(label, OP_REFGEN));
6520 /* Check for a constant argument */
6521 if (label->op_type == OP_CONST) {
6522 SV * const sv = ((SVOP *)label)->op_sv;
6524 const char *s = SvPV_const(sv,l);
6525 if (l == strlen(s)) {
6527 SvUTF8(((SVOP*)label)->op_sv),
6529 SvPV_nolen_const(((SVOP*)label)->op_sv)));
6533 /* If we have already created an op, we do not need the label. */
6536 op_getmad(label,o,'L');
6540 else o = newUNOP(type, OPf_STACKED, label);
6542 PL_hints |= HINT_BLOCK_SCOPE;
6546 /* if the condition is a literal array or hash
6547 (or @{ ... } etc), make a reference to it.
6550 S_ref_array_or_hash(pTHX_ OP *cond)
6553 && (cond->op_type == OP_RV2AV
6554 || cond->op_type == OP_PADAV
6555 || cond->op_type == OP_RV2HV
6556 || cond->op_type == OP_PADHV))
6558 return newUNOP(OP_REFGEN, 0, op_lvalue(cond, OP_REFGEN));
6561 && (cond->op_type == OP_ASLICE
6562 || cond->op_type == OP_HSLICE)) {
6564 /* anonlist now needs a list from this op, was previously used in
6566 cond->op_flags |= ~(OPf_WANT_SCALAR | OPf_REF);
6567 cond->op_flags |= OPf_WANT_LIST;
6569 return newANONLIST(op_lvalue(cond, OP_ANONLIST));
6576 /* These construct the optree fragments representing given()
6579 entergiven and enterwhen are LOGOPs; the op_other pointer
6580 points up to the associated leave op. We need this so we
6581 can put it in the context and make break/continue work.
6582 (Also, of course, pp_enterwhen will jump straight to
6583 op_other if the match fails.)
6587 S_newGIVWHENOP(pTHX_ OP *cond, OP *block,
6588 I32 enter_opcode, I32 leave_opcode,
6589 PADOFFSET entertarg)
6595 PERL_ARGS_ASSERT_NEWGIVWHENOP;
6597 NewOp(1101, enterop, 1, LOGOP);
6598 enterop->op_type = (Optype)enter_opcode;
6599 enterop->op_ppaddr = PL_ppaddr[enter_opcode];
6600 enterop->op_flags = (U8) OPf_KIDS;
6601 enterop->op_targ = ((entertarg == NOT_IN_PAD) ? 0 : entertarg);
6602 enterop->op_private = 0;
6604 o = newUNOP(leave_opcode, 0, (OP *) enterop);
6607 enterop->op_first = scalar(cond);
6608 cond->op_sibling = block;
6610 o->op_next = LINKLIST(cond);
6611 cond->op_next = (OP *) enterop;
6614 /* This is a default {} block */
6615 enterop->op_first = block;
6616 enterop->op_flags |= OPf_SPECIAL;
6617 o ->op_flags |= OPf_SPECIAL;
6619 o->op_next = (OP *) enterop;
6622 CHECKOP(enter_opcode, enterop); /* Currently does nothing, since
6623 entergiven and enterwhen both
6626 enterop->op_next = LINKLIST(block);
6627 block->op_next = enterop->op_other = o;
6632 /* Does this look like a boolean operation? For these purposes
6633 a boolean operation is:
6634 - a subroutine call [*]
6635 - a logical connective
6636 - a comparison operator
6637 - a filetest operator, with the exception of -s -M -A -C
6638 - defined(), exists() or eof()
6639 - /$re/ or $foo =~ /$re/
6641 [*] possibly surprising
6644 S_looks_like_bool(pTHX_ const OP *o)
6648 PERL_ARGS_ASSERT_LOOKS_LIKE_BOOL;
6650 switch(o->op_type) {
6653 return looks_like_bool(cLOGOPo->op_first);
6657 looks_like_bool(cLOGOPo->op_first)
6658 && looks_like_bool(cLOGOPo->op_first->op_sibling));
6663 o->op_flags & OPf_KIDS
6664 && looks_like_bool(cUNOPo->op_first));
6668 case OP_NOT: case OP_XOR:
6670 case OP_EQ: case OP_NE: case OP_LT:
6671 case OP_GT: case OP_LE: case OP_GE:
6673 case OP_I_EQ: case OP_I_NE: case OP_I_LT:
6674 case OP_I_GT: case OP_I_LE: case OP_I_GE:
6676 case OP_SEQ: case OP_SNE: case OP_SLT:
6677 case OP_SGT: case OP_SLE: case OP_SGE:
6681 case OP_FTRREAD: case OP_FTRWRITE: case OP_FTREXEC:
6682 case OP_FTEREAD: case OP_FTEWRITE: case OP_FTEEXEC:
6683 case OP_FTIS: case OP_FTEOWNED: case OP_FTROWNED:
6684 case OP_FTZERO: case OP_FTSOCK: case OP_FTCHR:
6685 case OP_FTBLK: case OP_FTFILE: case OP_FTDIR:
6686 case OP_FTPIPE: case OP_FTLINK: case OP_FTSUID:
6687 case OP_FTSGID: case OP_FTSVTX: case OP_FTTTY:
6688 case OP_FTTEXT: case OP_FTBINARY:
6690 case OP_DEFINED: case OP_EXISTS:
6691 case OP_MATCH: case OP_EOF:
6698 /* Detect comparisons that have been optimized away */
6699 if (cSVOPo->op_sv == &PL_sv_yes
6700 || cSVOPo->op_sv == &PL_sv_no)
6713 =for apidoc Am|OP *|newGIVENOP|OP *cond|OP *block|PADOFFSET defsv_off
6715 Constructs, checks, and returns an op tree expressing a C<given> block.
6716 I<cond> supplies the expression that will be locally assigned to a lexical
6717 variable, and I<block> supplies the body of the C<given> construct; they
6718 are consumed by this function and become part of&n