OS/2 update
[p5sagit/p5-mst-13.2.git] / regcomp.sym
CommitLineData
d09b2d29 1# Format:
2# NAME \t TYPE, arg-description [num-args] [longjump-len] \t DESCRIPTION
3
4# Empty rows and #-comment rows are ignored.
5
6# Exit points
7END END, no End of program.
8SUCCEED END, no Return from a subroutine, basically.
9
10# Anchors:
11BOL BOL, no Match "" at beginning of line.
12MBOL BOL, no Same, assuming multiline.
13SBOL BOL, no Same, assuming singleline.
b85d18e9 14EOS EOL, no Match "" at end of string.
d09b2d29 15EOL EOL, no Match "" at end of line.
16MEOL EOL, no Same, assuming multiline.
17SEOL EOL, no Same, assuming singleline.
18BOUND BOUND, no Match "" at any word boundary
19BOUNDL BOUND, no Match "" at any word boundary
20NBOUND NBOUND, no Match "" at any word non-boundary
21NBOUNDL NBOUND, no Match "" at any word non-boundary
22GPOS GPOS, no Matches where last m//g left off.
23
24# [Special] alternatives
25ANY ANY, no Match any one character (except newline).
26SANY ANY, no Match any one character.
27ANYOF ANYOF, sv Match character in (or not in) this class.
28ALNUM ALNUM, no Match any alphanumeric character
29ALNUML ALNUM, no Match any alphanumeric char in locale
30NALNUM NALNUM, no Match any non-alphanumeric character
31NALNUML NALNUM, no Match any non-alphanumeric char in locale
32SPACE SPACE, no Match any whitespace character
33SPACEL SPACE, no Match any whitespace char in locale
34NSPACE NSPACE, no Match any non-whitespace character
35NSPACEL NSPACE, no Match any non-whitespace char in locale
36DIGIT DIGIT, no Match any numeric character
37NDIGIT NDIGIT, no Match any non-numeric character
38
39# BRANCH The set of branches constituting a single choice are hooked
40# together with their "next" pointers, since precedence prevents
41# anything being concatenated to any individual branch. The
42# "next" pointer of the last BRANCH in a choice points to the
43# thing following the whole choice. This is also where the
44# final "next" pointer of each individual branch points; each
45# branch starts with the operand node of a BRANCH node.
46#
47BRANCH BRANCH, node Match this alternative, or the next...
48
49# BACK Normal "next" pointers all implicitly point forward; BACK
50# exists to make loop structures possible.
51# not used
52BACK BACK, no Match "", "next" ptr points backward.
53
54# Literals
55EXACT EXACT, sv Match this string (preceded by length).
56EXACTF EXACT, sv Match this string, folded (prec. by length).
57EXACTFL EXACT, sv Match this string, folded in locale (w/len).
58
59# Do nothing
60NOTHING NOTHING,no Match empty string.
61# A variant of above which delimits a group, thus stops optimizations
62TAIL NOTHING,no Match empty string. Can jump here from outside.
63
64# STAR,PLUS '?', and complex '*' and '+', are implemented as circular
65# BRANCH structures using BACK. Simple cases (one character
66# per match) are implemented with STAR and PLUS for speed
67# and to minimize recursive plunges.
68#
69STAR STAR, node Match this (simple) thing 0 or more times.
70PLUS PLUS, node Match this (simple) thing 1 or more times.
71
72CURLY CURLY, sv 2 Match this simple thing {n,m} times.
73CURLYN CURLY, no 2 Match next-after-this simple thing
74# {n,m} times, set parenths.
75CURLYM CURLY, no 2 Match this medium-complex thing {n,m} times.
76CURLYX CURLY, sv 2 Match this complex thing {n,m} times.
77
78# This terminator creates a loop structure for CURLYX
79WHILEM WHILEM, no Do curly processing and see if rest matches.
80
81# OPEN,CLOSE,GROUPP ...are numbered at compile time.
82OPEN OPEN, num 1 Mark this point in input as start of #n.
83CLOSE CLOSE, num 1 Analogous to OPEN.
84
85REF REF, num 1 Match some already matched string
86REFF REF, num 1 Match already matched string, folded
87REFFL REF, num 1 Match already matched string, folded in loc.
88
89# grouping assertions
90IFMATCH BRANCHJ,off 1 2 Succeeds if the following matches.
91UNLESSM BRANCHJ,off 1 2 Fails if the following matches.
92SUSPEND BRANCHJ,off 1 1 "Independent" sub-RE.
93IFTHEN BRANCHJ,off 1 1 Switch, should be preceeded by switcher .
94GROUPP GROUPP, num 1 Whether the group matched.
95
96# Support for long RE
97LONGJMP LONGJMP,off 1 1 Jump far away.
98BRANCHJ BRANCHJ,off 1 1 BRANCH with long offset.
99
100# The heavy worker
101EVAL EVAL, evl 1 Execute some Perl code.
102
103# Modifiers
104MINMOD MINMOD, no Next operator is not greedy.
105LOGICAL LOGICAL,no Next opcode should set the flag only.
106
107# This is not used yet
108RENUM BRANCHJ,off 1 1 Group with independently numbered parens.
109
110# This is not really a node, but an optimized away piece of a "long" node.
111# To simplify debugging output, we mark it as if it were a node
112OPTIMIZED NOTHING,off Placeholder for dump.