Cross Reference: /openbsd-current/gnu/usr.bin/perl/regen/op_private

5 This file contains all the definitions of the meanings of the flags in the
6 op_private field of an OP.
18 F<opcode.h> gains a series of C<OPp*> defines, and a few static data
28 Perl_do_op_dump() to dump the op_private field of an op.
31 The basic idea is that you keep calling addbits() to add definitions of
32 what a particular bit or range of bits in op_private means for a
57 unsigned integer. Instead of two string arguments, it just has a single
60 subset of the possible values of the bit field are given their own defines
61 and labels. The full syntax of this hash is explained further below.
81 There are some utility functions for generating a list of ops from
88 which respectively return a list of op names where:
90     field 3 of regen/opcodes specifies 'ck_foo' as the check function;
91     field 4 of regen/opcodes has flag or type 'X' set;
92     argument field N of regen/opcodes matches 'XYZ';
104 Here is a full example of a bit field hash:
131 The optional enum list specifies a set of defines and labels for (possibly
132 a subset of) the possible values of the bit field (which in this example
170     # The lower few bits of op_private often indicate the number of
185     # types of op is for completeness (so we can account for every bit
199     # find which ops use 0,1,2,3 or 4 bits of op_private for arg count info
205     # For now, ban use of bits 0..1 as an arg count, in order to detect
206     # any residual code which conflates use of the HINT_INTEGER and
291 # Are these bit ops in the scope of 'use integer'?
303 # of PL_hints, although only bits 6 & 7 are officially used for that
351 # Additional mode of failure: the opcode can modify TARG before it "used"
353 # If the target coincides with one of the arguments ==> kaboom.
364 #	Suspicious wrt "additional mode of failure" (and only it):
378 #		"additional mode of failure"
393 #	Suspicious wrt "additional mode of failure": warn, die, select.
430 # Defer creation of array/hash elem
491 # where FOO is typically the name of an op, and the flag is used by a
497 # OPpOUR_INTRO depending on the type of the LH child, .e.g.
508 # there *may* be common scalar items on both sides of a list assign:
561 #   context - application of scalar/ref/lvalue context applies the flag
568 # is no conversion of op type.
593 # note that some of these flags are just left-over from when an entersub
679     5 => qw(OPpKVSLICE KVSLICE), # Operating on a list of key/value pairs
680     6 => qw(OPpSLICE   SLICE  ), # Operating on a list of keys
720 # this flag is set only on a subset of the FT* ops
737     1 => qw(OPpEVAL_HAS_HH       HAS_HH ), # Does it have a copy of %^H ?
837     # so that the first concat's PADTMP (which holds the result of $a.$b)