This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Update File-Temp to CPAN version 0.2301
[perl5.git] / regcomp.c
1 /*    regcomp.c
2  */
3
4 /*
5  * 'A fair jaw-cracker dwarf-language must be.'            --Samwise Gamgee
6  *
7  *     [p.285 of _The Lord of the Rings_, II/iii: "The Ring Goes South"]
8  */
9
10 /* This file contains functions for compiling a regular expression.  See
11  * also regexec.c which funnily enough, contains functions for executing
12  * a regular expression.
13  *
14  * This file is also copied at build time to ext/re/re_comp.c, where
15  * it's built with -DPERL_EXT_RE_BUILD -DPERL_EXT_RE_DEBUG -DPERL_EXT.
16  * This causes the main functions to be compiled under new names and with
17  * debugging support added, which makes "use re 'debug'" work.
18  */
19
20 /* NOTE: this is derived from Henry Spencer's regexp code, and should not
21  * confused with the original package (see point 3 below).  Thanks, Henry!
22  */
23
24 /* Additional note: this code is very heavily munged from Henry's version
25  * in places.  In some spots I've traded clarity for efficiency, so don't
26  * blame Henry for some of the lack of readability.
27  */
28
29 /* The names of the functions have been changed from regcomp and
30  * regexec to pregcomp and pregexec in order to avoid conflicts
31  * with the POSIX routines of the same names.
32 */
33
34 #ifdef PERL_EXT_RE_BUILD
35 #include "re_top.h"
36 #endif
37
38 /*
39  * pregcomp and pregexec -- regsub and regerror are not used in perl
40  *
41  *      Copyright (c) 1986 by University of Toronto.
42  *      Written by Henry Spencer.  Not derived from licensed software.
43  *
44  *      Permission is granted to anyone to use this software for any
45  *      purpose on any computer system, and to redistribute it freely,
46  *      subject to the following restrictions:
47  *
48  *      1. The author is not responsible for the consequences of use of
49  *              this software, no matter how awful, even if they arise
50  *              from defects in it.
51  *
52  *      2. The origin of this software must not be misrepresented, either
53  *              by explicit claim or by omission.
54  *
55  *      3. Altered versions must be plainly marked as such, and must not
56  *              be misrepresented as being the original software.
57  *
58  *
59  ****    Alterations to Henry's code are...
60  ****
61  ****    Copyright (C) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
62  ****    2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008
63  ****    by Larry Wall and others
64  ****
65  ****    You may distribute under the terms of either the GNU General Public
66  ****    License or the Artistic License, as specified in the README file.
67
68  *
69  * Beware that some of this code is subtly aware of the way operator
70  * precedence is structured in regular expressions.  Serious changes in
71  * regular-expression syntax might require a total rethink.
72  */
73 #include "EXTERN.h"
74 #define PERL_IN_REGCOMP_C
75 #include "perl.h"
76
77 #ifndef PERL_IN_XSUB_RE
78 #  include "INTERN.h"
79 #endif
80
81 #define REG_COMP_C
82 #ifdef PERL_IN_XSUB_RE
83 #  include "re_comp.h"
84 extern const struct regexp_engine my_reg_engine;
85 #else
86 #  include "regcomp.h"
87 #endif
88
89 #include "dquote_static.c"
90 #include "charclass_invlists.h"
91 #include "inline_invlist.c"
92 #include "unicode_constants.h"
93
94 #define HAS_NONLATIN1_FOLD_CLOSURE(i) _HAS_NONLATIN1_FOLD_CLOSURE_ONLY_FOR_USE_BY_REGCOMP_DOT_C_AND_REGEXEC_DOT_C(i)
95 #define IS_NON_FINAL_FOLD(c) _IS_NON_FINAL_FOLD_ONLY_FOR_USE_BY_REGCOMP_DOT_C(c)
96 #define IS_IN_SOME_FOLD_L1(c) _IS_IN_SOME_FOLD_ONLY_FOR_USE_BY_REGCOMP_DOT_C(c)
97
98 #ifdef op
99 #undef op
100 #endif /* op */
101
102 #ifdef MSDOS
103 #  if defined(BUGGY_MSC6)
104  /* MSC 6.00A breaks on op/regexp.t test 85 unless we turn this off */
105 #    pragma optimize("a",off)
106  /* But MSC 6.00A is happy with 'w', for aliases only across function calls*/
107 #    pragma optimize("w",on )
108 #  endif /* BUGGY_MSC6 */
109 #endif /* MSDOS */
110
111 #ifndef STATIC
112 #define STATIC  static
113 #endif
114
115
116 typedef struct RExC_state_t {
117     U32         flags;                  /* RXf_* are we folding, multilining? */
118     U32         pm_flags;               /* PMf_* stuff from the calling PMOP */
119     char        *precomp;               /* uncompiled string. */
120     REGEXP      *rx_sv;                 /* The SV that is the regexp. */
121     regexp      *rx;                    /* perl core regexp structure */
122     regexp_internal     *rxi;           /* internal data for regexp object pprivate field */        
123     char        *start;                 /* Start of input for compile */
124     char        *end;                   /* End of input for compile */
125     char        *parse;                 /* Input-scan pointer. */
126     I32         whilem_seen;            /* number of WHILEM in this expr */
127     regnode     *emit_start;            /* Start of emitted-code area */
128     regnode     *emit_bound;            /* First regnode outside of the allocated space */
129     regnode     *emit;                  /* Code-emit pointer; &regdummy = don't = compiling */
130     I32         naughty;                /* How bad is this pattern? */
131     I32         sawback;                /* Did we see \1, ...? */
132     U32         seen;
133     I32         size;                   /* Code size. */
134     I32         npar;                   /* Capture buffer count, (OPEN). */
135     I32         cpar;                   /* Capture buffer count, (CLOSE). */
136     I32         nestroot;               /* root parens we are in - used by accept */
137     I32         extralen;
138     I32         seen_zerolen;
139     regnode     **open_parens;          /* pointers to open parens */
140     regnode     **close_parens;         /* pointers to close parens */
141     regnode     *opend;                 /* END node in program */
142     I32         utf8;           /* whether the pattern is utf8 or not */
143     I32         orig_utf8;      /* whether the pattern was originally in utf8 */
144                                 /* XXX use this for future optimisation of case
145                                  * where pattern must be upgraded to utf8. */
146     I32         uni_semantics;  /* If a d charset modifier should use unicode
147                                    rules, even if the pattern is not in
148                                    utf8 */
149     HV          *paren_names;           /* Paren names */
150     
151     regnode     **recurse;              /* Recurse regops */
152     I32         recurse_count;          /* Number of recurse regops */
153     I32         in_lookbehind;
154     I32         contains_locale;
155     I32         override_recoding;
156     I32         in_multi_char_class;
157     struct reg_code_block *code_blocks; /* positions of literal (?{})
158                                             within pattern */
159     int         num_code_blocks;        /* size of code_blocks[] */
160     int         code_index;             /* next code_blocks[] slot */
161 #if ADD_TO_REGEXEC
162     char        *starttry;              /* -Dr: where regtry was called. */
163 #define RExC_starttry   (pRExC_state->starttry)
164 #endif
165     SV          *runtime_code_qr;       /* qr with the runtime code blocks */
166 #ifdef DEBUGGING
167     const char  *lastparse;
168     I32         lastnum;
169     AV          *paren_name_list;       /* idx -> name */
170 #define RExC_lastparse  (pRExC_state->lastparse)
171 #define RExC_lastnum    (pRExC_state->lastnum)
172 #define RExC_paren_name_list    (pRExC_state->paren_name_list)
173 #endif
174 } RExC_state_t;
175
176 #define RExC_flags      (pRExC_state->flags)
177 #define RExC_pm_flags   (pRExC_state->pm_flags)
178 #define RExC_precomp    (pRExC_state->precomp)
179 #define RExC_rx_sv      (pRExC_state->rx_sv)
180 #define RExC_rx         (pRExC_state->rx)
181 #define RExC_rxi        (pRExC_state->rxi)
182 #define RExC_start      (pRExC_state->start)
183 #define RExC_end        (pRExC_state->end)
184 #define RExC_parse      (pRExC_state->parse)
185 #define RExC_whilem_seen        (pRExC_state->whilem_seen)
186 #ifdef RE_TRACK_PATTERN_OFFSETS
187 #define RExC_offsets    (pRExC_state->rxi->u.offsets) /* I am not like the others */
188 #endif
189 #define RExC_emit       (pRExC_state->emit)
190 #define RExC_emit_start (pRExC_state->emit_start)
191 #define RExC_emit_bound (pRExC_state->emit_bound)
192 #define RExC_naughty    (pRExC_state->naughty)
193 #define RExC_sawback    (pRExC_state->sawback)
194 #define RExC_seen       (pRExC_state->seen)
195 #define RExC_size       (pRExC_state->size)
196 #define RExC_npar       (pRExC_state->npar)
197 #define RExC_nestroot   (pRExC_state->nestroot)
198 #define RExC_extralen   (pRExC_state->extralen)
199 #define RExC_seen_zerolen       (pRExC_state->seen_zerolen)
200 #define RExC_utf8       (pRExC_state->utf8)
201 #define RExC_uni_semantics      (pRExC_state->uni_semantics)
202 #define RExC_orig_utf8  (pRExC_state->orig_utf8)
203 #define RExC_open_parens        (pRExC_state->open_parens)
204 #define RExC_close_parens       (pRExC_state->close_parens)
205 #define RExC_opend      (pRExC_state->opend)
206 #define RExC_paren_names        (pRExC_state->paren_names)
207 #define RExC_recurse    (pRExC_state->recurse)
208 #define RExC_recurse_count      (pRExC_state->recurse_count)
209 #define RExC_in_lookbehind      (pRExC_state->in_lookbehind)
210 #define RExC_contains_locale    (pRExC_state->contains_locale)
211 #define RExC_override_recoding (pRExC_state->override_recoding)
212 #define RExC_in_multi_char_class (pRExC_state->in_multi_char_class)
213
214
215 #define ISMULT1(c)      ((c) == '*' || (c) == '+' || (c) == '?')
216 #define ISMULT2(s)      ((*s) == '*' || (*s) == '+' || (*s) == '?' || \
217         ((*s) == '{' && regcurly(s, FALSE)))
218
219 #ifdef SPSTART
220 #undef SPSTART          /* dratted cpp namespace... */
221 #endif
222 /*
223  * Flags to be passed up and down.
224  */
225 #define WORST           0       /* Worst case. */
226 #define HASWIDTH        0x01    /* Known to match non-null strings. */
227
228 /* Simple enough to be STAR/PLUS operand; in an EXACTish node must be a single
229  * character.  (There needs to be a case: in the switch statement in regexec.c
230  * for any node marked SIMPLE.)  Note that this is not the same thing as
231  * REGNODE_SIMPLE */
232 #define SIMPLE          0x02
233 #define SPSTART         0x04    /* Starts with * or + */
234 #define POSTPONED       0x08    /* (?1),(?&name), (??{...}) or similar */
235 #define TRYAGAIN        0x10    /* Weeded out a declaration. */
236 #define RESTART_UTF8    0x20    /* Restart, need to calcuate sizes as UTF-8 */
237
238 #define REG_NODE_NUM(x) ((x) ? (int)((x)-RExC_emit_start) : -1)
239
240 /* whether trie related optimizations are enabled */
241 #if PERL_ENABLE_EXTENDED_TRIE_OPTIMISATION
242 #define TRIE_STUDY_OPT
243 #define FULL_TRIE_STUDY
244 #define TRIE_STCLASS
245 #endif
246
247
248
249 #define PBYTE(u8str,paren) ((U8*)(u8str))[(paren) >> 3]
250 #define PBITVAL(paren) (1 << ((paren) & 7))
251 #define PAREN_TEST(u8str,paren) ( PBYTE(u8str,paren) & PBITVAL(paren))
252 #define PAREN_SET(u8str,paren) PBYTE(u8str,paren) |= PBITVAL(paren)
253 #define PAREN_UNSET(u8str,paren) PBYTE(u8str,paren) &= (~PBITVAL(paren))
254
255 #define REQUIRE_UTF8    STMT_START {                                       \
256                                      if (!UTF) {                           \
257                                          *flagp = RESTART_UTF8;            \
258                                          return NULL;                      \
259                                      }                                     \
260                         } STMT_END
261
262 /* This converts the named class defined in regcomp.h to its equivalent class
263  * number defined in handy.h. */
264 #define namedclass_to_classnum(class)  ((int) ((class) / 2))
265 #define classnum_to_namedclass(classnum)  ((classnum) * 2)
266
267 /* About scan_data_t.
268
269   During optimisation we recurse through the regexp program performing
270   various inplace (keyhole style) optimisations. In addition study_chunk
271   and scan_commit populate this data structure with information about
272   what strings MUST appear in the pattern. We look for the longest 
273   string that must appear at a fixed location, and we look for the
274   longest string that may appear at a floating location. So for instance
275   in the pattern:
276   
277     /FOO[xX]A.*B[xX]BAR/
278     
279   Both 'FOO' and 'A' are fixed strings. Both 'B' and 'BAR' are floating
280   strings (because they follow a .* construct). study_chunk will identify
281   both FOO and BAR as being the longest fixed and floating strings respectively.
282   
283   The strings can be composites, for instance
284   
285      /(f)(o)(o)/
286      
287   will result in a composite fixed substring 'foo'.
288   
289   For each string some basic information is maintained:
290   
291   - offset or min_offset
292     This is the position the string must appear at, or not before.
293     It also implicitly (when combined with minlenp) tells us how many
294     characters must match before the string we are searching for.
295     Likewise when combined with minlenp and the length of the string it
296     tells us how many characters must appear after the string we have 
297     found.
298   
299   - max_offset
300     Only used for floating strings. This is the rightmost point that
301     the string can appear at. If set to I32 max it indicates that the
302     string can occur infinitely far to the right.
303   
304   - minlenp
305     A pointer to the minimum number of characters of the pattern that the
306     string was found inside. This is important as in the case of positive
307     lookahead or positive lookbehind we can have multiple patterns 
308     involved. Consider
309     
310     /(?=FOO).*F/
311     
312     The minimum length of the pattern overall is 3, the minimum length
313     of the lookahead part is 3, but the minimum length of the part that
314     will actually match is 1. So 'FOO's minimum length is 3, but the 
315     minimum length for the F is 1. This is important as the minimum length
316     is used to determine offsets in front of and behind the string being 
317     looked for.  Since strings can be composites this is the length of the
318     pattern at the time it was committed with a scan_commit. Note that
319     the length is calculated by study_chunk, so that the minimum lengths
320     are not known until the full pattern has been compiled, thus the 
321     pointer to the value.
322   
323   - lookbehind
324   
325     In the case of lookbehind the string being searched for can be
326     offset past the start point of the final matching string. 
327     If this value was just blithely removed from the min_offset it would
328     invalidate some of the calculations for how many chars must match
329     before or after (as they are derived from min_offset and minlen and
330     the length of the string being searched for). 
331     When the final pattern is compiled and the data is moved from the
332     scan_data_t structure into the regexp structure the information
333     about lookbehind is factored in, with the information that would 
334     have been lost precalculated in the end_shift field for the 
335     associated string.
336
337   The fields pos_min and pos_delta are used to store the minimum offset
338   and the delta to the maximum offset at the current point in the pattern.    
339
340 */
341
342 typedef struct scan_data_t {
343     /*I32 len_min;      unused */
344     /*I32 len_delta;    unused */
345     I32 pos_min;
346     I32 pos_delta;
347     SV *last_found;
348     I32 last_end;           /* min value, <0 unless valid. */
349     I32 last_start_min;
350     I32 last_start_max;
351     SV **longest;           /* Either &l_fixed, or &l_float. */
352     SV *longest_fixed;      /* longest fixed string found in pattern */
353     I32 offset_fixed;       /* offset where it starts */
354     I32 *minlen_fixed;      /* pointer to the minlen relevant to the string */
355     I32 lookbehind_fixed;   /* is the position of the string modfied by LB */
356     SV *longest_float;      /* longest floating string found in pattern */
357     I32 offset_float_min;   /* earliest point in string it can appear */
358     I32 offset_float_max;   /* latest point in string it can appear */
359     I32 *minlen_float;      /* pointer to the minlen relevant to the string */
360     I32 lookbehind_float;   /* is the position of the string modified by LB */
361     I32 flags;
362     I32 whilem_c;
363     I32 *last_closep;
364     struct regnode_charclass_class *start_class;
365 } scan_data_t;
366
367 /*
368  * Forward declarations for pregcomp()'s friends.
369  */
370
371 static const scan_data_t zero_scan_data =
372   { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 ,0};
373
374 #define SF_BEFORE_EOL           (SF_BEFORE_SEOL|SF_BEFORE_MEOL)
375 #define SF_BEFORE_SEOL          0x0001
376 #define SF_BEFORE_MEOL          0x0002
377 #define SF_FIX_BEFORE_EOL       (SF_FIX_BEFORE_SEOL|SF_FIX_BEFORE_MEOL)
378 #define SF_FL_BEFORE_EOL        (SF_FL_BEFORE_SEOL|SF_FL_BEFORE_MEOL)
379
380 #ifdef NO_UNARY_PLUS
381 #  define SF_FIX_SHIFT_EOL      (0+2)
382 #  define SF_FL_SHIFT_EOL               (0+4)
383 #else
384 #  define SF_FIX_SHIFT_EOL      (+2)
385 #  define SF_FL_SHIFT_EOL               (+4)
386 #endif
387
388 #define SF_FIX_BEFORE_SEOL      (SF_BEFORE_SEOL << SF_FIX_SHIFT_EOL)
389 #define SF_FIX_BEFORE_MEOL      (SF_BEFORE_MEOL << SF_FIX_SHIFT_EOL)
390
391 #define SF_FL_BEFORE_SEOL       (SF_BEFORE_SEOL << SF_FL_SHIFT_EOL)
392 #define SF_FL_BEFORE_MEOL       (SF_BEFORE_MEOL << SF_FL_SHIFT_EOL) /* 0x20 */
393 #define SF_IS_INF               0x0040
394 #define SF_HAS_PAR              0x0080
395 #define SF_IN_PAR               0x0100
396 #define SF_HAS_EVAL             0x0200
397 #define SCF_DO_SUBSTR           0x0400
398 #define SCF_DO_STCLASS_AND      0x0800
399 #define SCF_DO_STCLASS_OR       0x1000
400 #define SCF_DO_STCLASS          (SCF_DO_STCLASS_AND|SCF_DO_STCLASS_OR)
401 #define SCF_WHILEM_VISITED_POS  0x2000
402
403 #define SCF_TRIE_RESTUDY        0x4000 /* Do restudy? */
404 #define SCF_SEEN_ACCEPT         0x8000 
405
406 #define UTF cBOOL(RExC_utf8)
407
408 /* The enums for all these are ordered so things work out correctly */
409 #define LOC (get_regex_charset(RExC_flags) == REGEX_LOCALE_CHARSET)
410 #define DEPENDS_SEMANTICS (get_regex_charset(RExC_flags) == REGEX_DEPENDS_CHARSET)
411 #define UNI_SEMANTICS (get_regex_charset(RExC_flags) == REGEX_UNICODE_CHARSET)
412 #define AT_LEAST_UNI_SEMANTICS (get_regex_charset(RExC_flags) >= REGEX_UNICODE_CHARSET)
413 #define ASCII_RESTRICTED (get_regex_charset(RExC_flags) == REGEX_ASCII_RESTRICTED_CHARSET)
414 #define AT_LEAST_ASCII_RESTRICTED (get_regex_charset(RExC_flags) >= REGEX_ASCII_RESTRICTED_CHARSET)
415 #define ASCII_FOLD_RESTRICTED (get_regex_charset(RExC_flags) == REGEX_ASCII_MORE_RESTRICTED_CHARSET)
416
417 #define FOLD cBOOL(RExC_flags & RXf_PMf_FOLD)
418
419 #define OOB_NAMEDCLASS          -1
420
421 /* There is no code point that is out-of-bounds, so this is problematic.  But
422  * its only current use is to initialize a variable that is always set before
423  * looked at. */
424 #define OOB_UNICODE             0xDEADBEEF
425
426 #define CHR_SVLEN(sv) (UTF ? sv_len_utf8(sv) : SvCUR(sv))
427 #define CHR_DIST(a,b) (UTF ? utf8_distance(a,b) : a - b)
428
429
430 /* length of regex to show in messages that don't mark a position within */
431 #define RegexLengthToShowInErrorMessages 127
432
433 /*
434  * If MARKER[12] are adjusted, be sure to adjust the constants at the top
435  * of t/op/regmesg.t, the tests in t/op/re_tests, and those in
436  * op/pragma/warn/regcomp.
437  */
438 #define MARKER1 "<-- HERE"    /* marker as it appears in the description */
439 #define MARKER2 " <-- HERE "  /* marker as it appears within the regex */
440
441 #define REPORT_LOCATION " in regex; marked by " MARKER1 " in m/%.*s" MARKER2 "%s/"
442
443 /*
444  * Calls SAVEDESTRUCTOR_X if needed, then calls Perl_croak with the given
445  * arg. Show regex, up to a maximum length. If it's too long, chop and add
446  * "...".
447  */
448 #define _FAIL(code) STMT_START {                                        \
449     const char *ellipses = "";                                          \
450     IV len = RExC_end - RExC_precomp;                                   \
451                                                                         \
452     if (!SIZE_ONLY)                                                     \
453         SAVEFREESV(RExC_rx_sv);                                         \
454     if (len > RegexLengthToShowInErrorMessages) {                       \
455         /* chop 10 shorter than the max, to ensure meaning of "..." */  \
456         len = RegexLengthToShowInErrorMessages - 10;                    \
457         ellipses = "...";                                               \
458     }                                                                   \
459     code;                                                               \
460 } STMT_END
461
462 #define FAIL(msg) _FAIL(                            \
463     Perl_croak(aTHX_ "%s in regex m/%.*s%s/",       \
464             msg, (int)len, RExC_precomp, ellipses))
465
466 #define FAIL2(msg,arg) _FAIL(                       \
467     Perl_croak(aTHX_ msg " in regex m/%.*s%s/",     \
468             arg, (int)len, RExC_precomp, ellipses))
469
470 /*
471  * Simple_vFAIL -- like FAIL, but marks the current location in the scan
472  */
473 #define Simple_vFAIL(m) STMT_START {                                    \
474     const IV offset = RExC_parse - RExC_precomp;                        \
475     Perl_croak(aTHX_ "%s" REPORT_LOCATION,                              \
476             m, (int)offset, RExC_precomp, RExC_precomp + offset);       \
477 } STMT_END
478
479 /*
480  * Calls SAVEDESTRUCTOR_X if needed, then Simple_vFAIL()
481  */
482 #define vFAIL(m) STMT_START {                           \
483     if (!SIZE_ONLY)                                     \
484         SAVEFREESV(RExC_rx_sv);                         \
485     Simple_vFAIL(m);                                    \
486 } STMT_END
487
488 /*
489  * Like Simple_vFAIL(), but accepts two arguments.
490  */
491 #define Simple_vFAIL2(m,a1) STMT_START {                        \
492     const IV offset = RExC_parse - RExC_precomp;                        \
493     S_re_croak2(aTHX_ m, REPORT_LOCATION, a1,                   \
494             (int)offset, RExC_precomp, RExC_precomp + offset);  \
495 } STMT_END
496
497 /*
498  * Calls SAVEDESTRUCTOR_X if needed, then Simple_vFAIL2().
499  */
500 #define vFAIL2(m,a1) STMT_START {                       \
501     if (!SIZE_ONLY)                                     \
502         SAVEFREESV(RExC_rx_sv);                         \
503     Simple_vFAIL2(m, a1);                               \
504 } STMT_END
505
506
507 /*
508  * Like Simple_vFAIL(), but accepts three arguments.
509  */
510 #define Simple_vFAIL3(m, a1, a2) STMT_START {                   \
511     const IV offset = RExC_parse - RExC_precomp;                \
512     S_re_croak2(aTHX_ m, REPORT_LOCATION, a1, a2,               \
513             (int)offset, RExC_precomp, RExC_precomp + offset);  \
514 } STMT_END
515
516 /*
517  * Calls SAVEDESTRUCTOR_X if needed, then Simple_vFAIL3().
518  */
519 #define vFAIL3(m,a1,a2) STMT_START {                    \
520     if (!SIZE_ONLY)                                     \
521         SAVEFREESV(RExC_rx_sv);                         \
522     Simple_vFAIL3(m, a1, a2);                           \
523 } STMT_END
524
525 /*
526  * Like Simple_vFAIL(), but accepts four arguments.
527  */
528 #define Simple_vFAIL4(m, a1, a2, a3) STMT_START {               \
529     const IV offset = RExC_parse - RExC_precomp;                \
530     S_re_croak2(aTHX_ m, REPORT_LOCATION, a1, a2, a3,           \
531             (int)offset, RExC_precomp, RExC_precomp + offset);  \
532 } STMT_END
533
534 #define vFAIL4(m,a1,a2,a3) STMT_START {                 \
535     if (!SIZE_ONLY)                                     \
536         SAVEFREESV(RExC_rx_sv);                         \
537     Simple_vFAIL4(m, a1, a2, a3);                       \
538 } STMT_END
539
540 /* m is not necessarily a "literal string", in this macro */
541 #define reg_warn_non_literal_string(loc, m) STMT_START {                \
542     const IV offset = loc - RExC_precomp;                               \
543     Perl_warner(aTHX_ packWARN(WARN_REGEXP), "%s" REPORT_LOCATION,      \
544             m, (int)offset, RExC_precomp, RExC_precomp + offset);       \
545 } STMT_END
546
547 #define ckWARNreg(loc,m) STMT_START {                                   \
548     const IV offset = loc - RExC_precomp;                               \
549     Perl_ck_warner(aTHX_ packWARN(WARN_REGEXP), m REPORT_LOCATION,      \
550             (int)offset, RExC_precomp, RExC_precomp + offset);          \
551 } STMT_END
552
553 #define vWARN_dep(loc, m) STMT_START {                                  \
554     const IV offset = loc - RExC_precomp;                               \
555     Perl_warner(aTHX_ packWARN(WARN_DEPRECATED), m REPORT_LOCATION,     \
556             (int)offset, RExC_precomp, RExC_precomp + offset);          \
557 } STMT_END
558
559 #define ckWARNdep(loc,m) STMT_START {                                   \
560     const IV offset = loc - RExC_precomp;                               \
561     Perl_ck_warner_d(aTHX_ packWARN(WARN_DEPRECATED),                   \
562             m REPORT_LOCATION,                                          \
563             (int)offset, RExC_precomp, RExC_precomp + offset);          \
564 } STMT_END
565
566 #define ckWARNregdep(loc,m) STMT_START {                                \
567     const IV offset = loc - RExC_precomp;                               \
568     Perl_ck_warner_d(aTHX_ packWARN2(WARN_DEPRECATED, WARN_REGEXP),     \
569             m REPORT_LOCATION,                                          \
570             (int)offset, RExC_precomp, RExC_precomp + offset);          \
571 } STMT_END
572
573 #define ckWARN2regdep(loc,m, a1) STMT_START {                           \
574     const IV offset = loc - RExC_precomp;                               \
575     Perl_ck_warner_d(aTHX_ packWARN2(WARN_DEPRECATED, WARN_REGEXP),     \
576             m REPORT_LOCATION,                                          \
577             a1, (int)offset, RExC_precomp, RExC_precomp + offset);      \
578 } STMT_END
579
580 #define ckWARN2reg(loc, m, a1) STMT_START {                             \
581     const IV offset = loc - RExC_precomp;                               \
582     Perl_ck_warner(aTHX_ packWARN(WARN_REGEXP), m REPORT_LOCATION,      \
583             a1, (int)offset, RExC_precomp, RExC_precomp + offset);      \
584 } STMT_END
585
586 #define vWARN3(loc, m, a1, a2) STMT_START {                             \
587     const IV offset = loc - RExC_precomp;                               \
588     Perl_warner(aTHX_ packWARN(WARN_REGEXP), m REPORT_LOCATION,         \
589             a1, a2, (int)offset, RExC_precomp, RExC_precomp + offset);  \
590 } STMT_END
591
592 #define ckWARN3reg(loc, m, a1, a2) STMT_START {                         \
593     const IV offset = loc - RExC_precomp;                               \
594     Perl_ck_warner(aTHX_ packWARN(WARN_REGEXP), m REPORT_LOCATION,      \
595             a1, a2, (int)offset, RExC_precomp, RExC_precomp + offset);  \
596 } STMT_END
597
598 #define vWARN4(loc, m, a1, a2, a3) STMT_START {                         \
599     const IV offset = loc - RExC_precomp;                               \
600     Perl_warner(aTHX_ packWARN(WARN_REGEXP), m REPORT_LOCATION,         \
601             a1, a2, a3, (int)offset, RExC_precomp, RExC_precomp + offset); \
602 } STMT_END
603
604 #define ckWARN4reg(loc, m, a1, a2, a3) STMT_START {                     \
605     const IV offset = loc - RExC_precomp;                               \
606     Perl_ck_warner(aTHX_ packWARN(WARN_REGEXP), m REPORT_LOCATION,      \
607             a1, a2, a3, (int)offset, RExC_precomp, RExC_precomp + offset); \
608 } STMT_END
609
610 #define vWARN5(loc, m, a1, a2, a3, a4) STMT_START {                     \
611     const IV offset = loc - RExC_precomp;                               \
612     Perl_warner(aTHX_ packWARN(WARN_REGEXP), m REPORT_LOCATION,         \
613             a1, a2, a3, a4, (int)offset, RExC_precomp, RExC_precomp + offset); \
614 } STMT_END
615
616
617 /* Allow for side effects in s */
618 #define REGC(c,s) STMT_START {                  \
619     if (!SIZE_ONLY) *(s) = (c); else (void)(s); \
620 } STMT_END
621
622 /* Macros for recording node offsets.   20001227 mjd@plover.com 
623  * Nodes are numbered 1, 2, 3, 4.  Node #n's position is recorded in
624  * element 2*n-1 of the array.  Element #2n holds the byte length node #n.
625  * Element 0 holds the number n.
626  * Position is 1 indexed.
627  */
628 #ifndef RE_TRACK_PATTERN_OFFSETS
629 #define Set_Node_Offset_To_R(node,byte)
630 #define Set_Node_Offset(node,byte)
631 #define Set_Cur_Node_Offset
632 #define Set_Node_Length_To_R(node,len)
633 #define Set_Node_Length(node,len)
634 #define Set_Node_Cur_Length(node)
635 #define Node_Offset(n) 
636 #define Node_Length(n) 
637 #define Set_Node_Offset_Length(node,offset,len)
638 #define ProgLen(ri) ri->u.proglen
639 #define SetProgLen(ri,x) ri->u.proglen = x
640 #else
641 #define ProgLen(ri) ri->u.offsets[0]
642 #define SetProgLen(ri,x) ri->u.offsets[0] = x
643 #define Set_Node_Offset_To_R(node,byte) STMT_START {                    \
644     if (! SIZE_ONLY) {                                                  \
645         MJD_OFFSET_DEBUG(("** (%d) offset of node %d is %d.\n",         \
646                     __LINE__, (int)(node), (int)(byte)));               \
647         if((node) < 0) {                                                \
648             Perl_croak(aTHX_ "value of node is %d in Offset macro", (int)(node)); \
649         } else {                                                        \
650             RExC_offsets[2*(node)-1] = (byte);                          \
651         }                                                               \
652     }                                                                   \
653 } STMT_END
654
655 #define Set_Node_Offset(node,byte) \
656     Set_Node_Offset_To_R((node)-RExC_emit_start, (byte)-RExC_start)
657 #define Set_Cur_Node_Offset Set_Node_Offset(RExC_emit, RExC_parse)
658
659 #define Set_Node_Length_To_R(node,len) STMT_START {                     \
660     if (! SIZE_ONLY) {                                                  \
661         MJD_OFFSET_DEBUG(("** (%d) size of node %d is %d.\n",           \
662                 __LINE__, (int)(node), (int)(len)));                    \
663         if((node) < 0) {                                                \
664             Perl_croak(aTHX_ "value of node is %d in Length macro", (int)(node)); \
665         } else {                                                        \
666             RExC_offsets[2*(node)] = (len);                             \
667         }                                                               \
668     }                                                                   \
669 } STMT_END
670
671 #define Set_Node_Length(node,len) \
672     Set_Node_Length_To_R((node)-RExC_emit_start, len)
673 #define Set_Cur_Node_Length(len) Set_Node_Length(RExC_emit, len)
674 #define Set_Node_Cur_Length(node) \
675     Set_Node_Length(node, RExC_parse - parse_start)
676
677 /* Get offsets and lengths */
678 #define Node_Offset(n) (RExC_offsets[2*((n)-RExC_emit_start)-1])
679 #define Node_Length(n) (RExC_offsets[2*((n)-RExC_emit_start)])
680
681 #define Set_Node_Offset_Length(node,offset,len) STMT_START {    \
682     Set_Node_Offset_To_R((node)-RExC_emit_start, (offset));     \
683     Set_Node_Length_To_R((node)-RExC_emit_start, (len));        \
684 } STMT_END
685 #endif
686
687 #if PERL_ENABLE_EXPERIMENTAL_REGEX_OPTIMISATIONS
688 #define EXPERIMENTAL_INPLACESCAN
689 #endif /*PERL_ENABLE_EXPERIMENTAL_REGEX_OPTIMISATIONS*/
690
691 #define DEBUG_STUDYDATA(str,data,depth)                              \
692 DEBUG_OPTIMISE_MORE_r(if(data){                                      \
693     PerlIO_printf(Perl_debug_log,                                    \
694         "%*s" str "Pos:%"IVdf"/%"IVdf                                \
695         " Flags: 0x%"UVXf" Whilem_c: %"IVdf" Lcp: %"IVdf" %s",       \
696         (int)(depth)*2, "",                                          \
697         (IV)((data)->pos_min),                                       \
698         (IV)((data)->pos_delta),                                     \
699         (UV)((data)->flags),                                         \
700         (IV)((data)->whilem_c),                                      \
701         (IV)((data)->last_closep ? *((data)->last_closep) : -1),     \
702         is_inf ? "INF " : ""                                         \
703     );                                                               \
704     if ((data)->last_found)                                          \
705         PerlIO_printf(Perl_debug_log,                                \
706             "Last:'%s' %"IVdf":%"IVdf"/%"IVdf" %sFixed:'%s' @ %"IVdf \
707             " %sFloat: '%s' @ %"IVdf"/%"IVdf"",                      \
708             SvPVX_const((data)->last_found),                         \
709             (IV)((data)->last_end),                                  \
710             (IV)((data)->last_start_min),                            \
711             (IV)((data)->last_start_max),                            \
712             ((data)->longest &&                                      \
713              (data)->longest==&((data)->longest_fixed)) ? "*" : "",  \
714             SvPVX_const((data)->longest_fixed),                      \
715             (IV)((data)->offset_fixed),                              \
716             ((data)->longest &&                                      \
717              (data)->longest==&((data)->longest_float)) ? "*" : "",  \
718             SvPVX_const((data)->longest_float),                      \
719             (IV)((data)->offset_float_min),                          \
720             (IV)((data)->offset_float_max)                           \
721         );                                                           \
722     PerlIO_printf(Perl_debug_log,"\n");                              \
723 });
724
725 /* Mark that we cannot extend a found fixed substring at this point.
726    Update the longest found anchored substring and the longest found
727    floating substrings if needed. */
728
729 STATIC void
730 S_scan_commit(pTHX_ const RExC_state_t *pRExC_state, scan_data_t *data, I32 *minlenp, int is_inf)
731 {
732     const STRLEN l = CHR_SVLEN(data->last_found);
733     const STRLEN old_l = CHR_SVLEN(*data->longest);
734     GET_RE_DEBUG_FLAGS_DECL;
735
736     PERL_ARGS_ASSERT_SCAN_COMMIT;
737
738     if ((l >= old_l) && ((l > old_l) || (data->flags & SF_BEFORE_EOL))) {
739         SvSetMagicSV(*data->longest, data->last_found);
740         if (*data->longest == data->longest_fixed) {
741             data->offset_fixed = l ? data->last_start_min : data->pos_min;
742             if (data->flags & SF_BEFORE_EOL)
743                 data->flags
744                     |= ((data->flags & SF_BEFORE_EOL) << SF_FIX_SHIFT_EOL);
745             else
746                 data->flags &= ~SF_FIX_BEFORE_EOL;
747             data->minlen_fixed=minlenp;
748             data->lookbehind_fixed=0;
749         }
750         else { /* *data->longest == data->longest_float */
751             data->offset_float_min = l ? data->last_start_min : data->pos_min;
752             data->offset_float_max = (l
753                                       ? data->last_start_max
754                                       : (data->pos_delta == I32_MAX ? I32_MAX : data->pos_min + data->pos_delta));
755             if (is_inf || (U32)data->offset_float_max > (U32)I32_MAX)
756                 data->offset_float_max = I32_MAX;
757             if (data->flags & SF_BEFORE_EOL)
758                 data->flags
759                     |= ((data->flags & SF_BEFORE_EOL) << SF_FL_SHIFT_EOL);
760             else
761                 data->flags &= ~SF_FL_BEFORE_EOL;
762             data->minlen_float=minlenp;
763             data->lookbehind_float=0;
764         }
765     }
766     SvCUR_set(data->last_found, 0);
767     {
768         SV * const sv = data->last_found;
769         if (SvUTF8(sv) && SvMAGICAL(sv)) {
770             MAGIC * const mg = mg_find(sv, PERL_MAGIC_utf8);
771             if (mg)
772                 mg->mg_len = 0;
773         }
774     }
775     data->last_end = -1;
776     data->flags &= ~SF_BEFORE_EOL;
777     DEBUG_STUDYDATA("commit: ",data,0);
778 }
779
780 /* These macros set, clear and test whether the synthetic start class ('ssc',
781  * given by the parameter) matches an empty string (EOS).  This uses the
782  * 'next_off' field in the node, to save a bit in the flags field.  The ssc
783  * stands alone, so there is never a next_off, so this field is otherwise
784  * unused.  The EOS information is used only for compilation, but theoretically
785  * it could be passed on to the execution code.  This could be used to store
786  * more than one bit of information, but only this one is currently used. */
787 #define SET_SSC_EOS(node)   STMT_START { (node)->next_off = TRUE; } STMT_END
788 #define CLEAR_SSC_EOS(node) STMT_START { (node)->next_off = FALSE; } STMT_END
789 #define TEST_SSC_EOS(node)  cBOOL((node)->next_off)
790
791 /* Can match anything (initialization) */
792 STATIC void
793 S_cl_anything(const RExC_state_t *pRExC_state, struct regnode_charclass_class *cl)
794 {
795     PERL_ARGS_ASSERT_CL_ANYTHING;
796
797     ANYOF_BITMAP_SETALL(cl);
798     cl->flags = ANYOF_UNICODE_ALL;
799     SET_SSC_EOS(cl);
800
801     /* If any portion of the regex is to operate under locale rules,
802      * initialization includes it.  The reason this isn't done for all regexes
803      * is that the optimizer was written under the assumption that locale was
804      * all-or-nothing.  Given the complexity and lack of documentation in the
805      * optimizer, and that there are inadequate test cases for locale, so many
806      * parts of it may not work properly, it is safest to avoid locale unless
807      * necessary. */
808     if (RExC_contains_locale) {
809         ANYOF_CLASS_SETALL(cl);     /* /l uses class */
810         cl->flags |= ANYOF_LOCALE|ANYOF_CLASS|ANYOF_LOC_FOLD;
811     }
812     else {
813         ANYOF_CLASS_ZERO(cl);       /* Only /l uses class now */
814     }
815 }
816
817 /* Can match anything (initialization) */
818 STATIC int
819 S_cl_is_anything(const struct regnode_charclass_class *cl)
820 {
821     int value;
822
823     PERL_ARGS_ASSERT_CL_IS_ANYTHING;
824
825     for (value = 0; value < ANYOF_MAX; value += 2)
826         if (ANYOF_CLASS_TEST(cl, value) && ANYOF_CLASS_TEST(cl, value + 1))
827             return 1;
828     if (!(cl->flags & ANYOF_UNICODE_ALL))
829         return 0;
830     if (!ANYOF_BITMAP_TESTALLSET((const void*)cl))
831         return 0;
832     return 1;
833 }
834
835 /* Can match anything (initialization) */
836 STATIC void
837 S_cl_init(const RExC_state_t *pRExC_state, struct regnode_charclass_class *cl)
838 {
839     PERL_ARGS_ASSERT_CL_INIT;
840
841     Zero(cl, 1, struct regnode_charclass_class);
842     cl->type = ANYOF;
843     cl_anything(pRExC_state, cl);
844     ARG_SET(cl, ANYOF_NONBITMAP_EMPTY);
845 }
846
847 /* These two functions currently do the exact same thing */
848 #define cl_init_zero            S_cl_init
849
850 /* 'AND' a given class with another one.  Can create false positives.  'cl'
851  * should not be inverted.  'and_with->flags & ANYOF_CLASS' should be 0 if
852  * 'and_with' is a regnode_charclass instead of a regnode_charclass_class. */
853 STATIC void
854 S_cl_and(struct regnode_charclass_class *cl,
855         const struct regnode_charclass_class *and_with)
856 {
857     PERL_ARGS_ASSERT_CL_AND;
858
859     assert(PL_regkind[and_with->type] == ANYOF);
860
861     /* I (khw) am not sure all these restrictions are necessary XXX */
862     if (!(ANYOF_CLASS_TEST_ANY_SET(and_with))
863         && !(ANYOF_CLASS_TEST_ANY_SET(cl))
864         && (and_with->flags & ANYOF_LOCALE) == (cl->flags & ANYOF_LOCALE)
865         && !(and_with->flags & ANYOF_LOC_FOLD)
866         && !(cl->flags & ANYOF_LOC_FOLD)) {
867         int i;
868
869         if (and_with->flags & ANYOF_INVERT)
870             for (i = 0; i < ANYOF_BITMAP_SIZE; i++)
871                 cl->bitmap[i] &= ~and_with->bitmap[i];
872         else
873             for (i = 0; i < ANYOF_BITMAP_SIZE; i++)
874                 cl->bitmap[i] &= and_with->bitmap[i];
875     } /* XXXX: logic is complicated otherwise, leave it along for a moment. */
876
877     if (and_with->flags & ANYOF_INVERT) {
878
879         /* Here, the and'ed node is inverted.  Get the AND of the flags that
880          * aren't affected by the inversion.  Those that are affected are
881          * handled individually below */
882         U8 affected_flags = cl->flags & ~INVERSION_UNAFFECTED_FLAGS;
883         cl->flags &= (and_with->flags & INVERSION_UNAFFECTED_FLAGS);
884         cl->flags |= affected_flags;
885
886         /* We currently don't know how to deal with things that aren't in the
887          * bitmap, but we know that the intersection is no greater than what
888          * is already in cl, so let there be false positives that get sorted
889          * out after the synthetic start class succeeds, and the node is
890          * matched for real. */
891
892         /* The inversion of these two flags indicate that the resulting
893          * intersection doesn't have them */
894         if (and_with->flags & ANYOF_UNICODE_ALL) {
895             cl->flags &= ~ANYOF_UNICODE_ALL;
896         }
897         if (and_with->flags & ANYOF_NON_UTF8_LATIN1_ALL) {
898             cl->flags &= ~ANYOF_NON_UTF8_LATIN1_ALL;
899         }
900     }
901     else {   /* and'd node is not inverted */
902         U8 outside_bitmap_but_not_utf8; /* Temp variable */
903
904         if (! ANYOF_NONBITMAP(and_with)) {
905
906             /* Here 'and_with' doesn't match anything outside the bitmap
907              * (except possibly ANYOF_UNICODE_ALL), which means the
908              * intersection can't either, except for ANYOF_UNICODE_ALL, in
909              * which case we don't know what the intersection is, but it's no
910              * greater than what cl already has, so can just leave it alone,
911              * with possible false positives */
912             if (! (and_with->flags & ANYOF_UNICODE_ALL)) {
913                 ARG_SET(cl, ANYOF_NONBITMAP_EMPTY);
914                 cl->flags &= ~ANYOF_NONBITMAP_NON_UTF8;
915             }
916         }
917         else if (! ANYOF_NONBITMAP(cl)) {
918
919             /* Here, 'and_with' does match something outside the bitmap, and cl
920              * doesn't have a list of things to match outside the bitmap.  If
921              * cl can match all code points above 255, the intersection will
922              * be those above-255 code points that 'and_with' matches.  If cl
923              * can't match all Unicode code points, it means that it can't
924              * match anything outside the bitmap (since the 'if' that got us
925              * into this block tested for that), so we leave the bitmap empty.
926              */
927             if (cl->flags & ANYOF_UNICODE_ALL) {
928                 ARG_SET(cl, ARG(and_with));
929
930                 /* and_with's ARG may match things that don't require UTF8.
931                  * And now cl's will too, in spite of this being an 'and'.  See
932                  * the comments below about the kludge */
933                 cl->flags |= and_with->flags & ANYOF_NONBITMAP_NON_UTF8;
934             }
935         }
936         else {
937             /* Here, both 'and_with' and cl match something outside the
938              * bitmap.  Currently we do not do the intersection, so just match
939              * whatever cl had at the beginning.  */
940         }
941
942
943         /* Take the intersection of the two sets of flags.  However, the
944          * ANYOF_NONBITMAP_NON_UTF8 flag is treated as an 'or'.  This is a
945          * kludge around the fact that this flag is not treated like the others
946          * which are initialized in cl_anything().  The way the optimizer works
947          * is that the synthetic start class (SSC) is initialized to match
948          * anything, and then the first time a real node is encountered, its
949          * values are AND'd with the SSC's with the result being the values of
950          * the real node.  However, there are paths through the optimizer where
951          * the AND never gets called, so those initialized bits are set
952          * inappropriately, which is not usually a big deal, as they just cause
953          * false positives in the SSC, which will just mean a probably
954          * imperceptible slow down in execution.  However this bit has a
955          * higher false positive consequence in that it can cause utf8.pm,
956          * utf8_heavy.pl ... to be loaded when not necessary, which is a much
957          * bigger slowdown and also causes significant extra memory to be used.
958          * In order to prevent this, the code now takes a different tack.  The
959          * bit isn't set unless some part of the regular expression needs it,
960          * but once set it won't get cleared.  This means that these extra
961          * modules won't get loaded unless there was some path through the
962          * pattern that would have required them anyway, and  so any false
963          * positives that occur by not ANDing them out when they could be
964          * aren't as severe as they would be if we treated this bit like all
965          * the others */
966         outside_bitmap_but_not_utf8 = (cl->flags | and_with->flags)
967                                       & ANYOF_NONBITMAP_NON_UTF8;
968         cl->flags &= and_with->flags;
969         cl->flags |= outside_bitmap_but_not_utf8;
970     }
971 }
972
973 /* 'OR' a given class with another one.  Can create false positives.  'cl'
974  * should not be inverted.  'or_with->flags & ANYOF_CLASS' should be 0 if
975  * 'or_with' is a regnode_charclass instead of a regnode_charclass_class. */
976 STATIC void
977 S_cl_or(const RExC_state_t *pRExC_state, struct regnode_charclass_class *cl, const struct regnode_charclass_class *or_with)
978 {
979     PERL_ARGS_ASSERT_CL_OR;
980
981     if (or_with->flags & ANYOF_INVERT) {
982
983         /* Here, the or'd node is to be inverted.  This means we take the
984          * complement of everything not in the bitmap, but currently we don't
985          * know what that is, so give up and match anything */
986         if (ANYOF_NONBITMAP(or_with)) {
987             cl_anything(pRExC_state, cl);
988         }
989         /* We do not use
990          * (B1 | CL1) | (!B2 & !CL2) = (B1 | !B2 & !CL2) | (CL1 | (!B2 & !CL2))
991          *   <= (B1 | !B2) | (CL1 | !CL2)
992          * which is wasteful if CL2 is small, but we ignore CL2:
993          *   (B1 | CL1) | (!B2 & !CL2) <= (B1 | CL1) | !B2 = (B1 | !B2) | CL1
994          * XXXX Can we handle case-fold?  Unclear:
995          *   (OK1(i) | OK1(i')) | !(OK1(i) | OK1(i')) =
996          *   (OK1(i) | OK1(i')) | (!OK1(i) & !OK1(i'))
997          */
998         else if ( (or_with->flags & ANYOF_LOCALE) == (cl->flags & ANYOF_LOCALE)
999              && !(or_with->flags & ANYOF_LOC_FOLD)
1000              && !(cl->flags & ANYOF_LOC_FOLD) ) {
1001             int i;
1002
1003             for (i = 0; i < ANYOF_BITMAP_SIZE; i++)
1004                 cl->bitmap[i] |= ~or_with->bitmap[i];
1005         } /* XXXX: logic is complicated otherwise */
1006         else {
1007             cl_anything(pRExC_state, cl);
1008         }
1009
1010         /* And, we can just take the union of the flags that aren't affected
1011          * by the inversion */
1012         cl->flags |= or_with->flags & INVERSION_UNAFFECTED_FLAGS;
1013
1014         /* For the remaining flags:
1015             ANYOF_UNICODE_ALL and inverted means to not match anything above
1016                     255, which means that the union with cl should just be
1017                     what cl has in it, so can ignore this flag
1018             ANYOF_NON_UTF8_LATIN1_ALL and inverted means if not utf8 and ord
1019                     is 127-255 to match them, but then invert that, so the
1020                     union with cl should just be what cl has in it, so can
1021                     ignore this flag
1022          */
1023     } else {    /* 'or_with' is not inverted */
1024         /* (B1 | CL1) | (B2 | CL2) = (B1 | B2) | (CL1 | CL2)) */
1025         if ( (or_with->flags & ANYOF_LOCALE) == (cl->flags & ANYOF_LOCALE)
1026              && (!(or_with->flags & ANYOF_LOC_FOLD)
1027                  || (cl->flags & ANYOF_LOC_FOLD)) ) {
1028             int i;
1029
1030             /* OR char bitmap and class bitmap separately */
1031             for (i = 0; i < ANYOF_BITMAP_SIZE; i++)
1032                 cl->bitmap[i] |= or_with->bitmap[i];
1033             if (or_with->flags & ANYOF_CLASS) {
1034                 ANYOF_CLASS_OR(or_with, cl);
1035             }
1036         }
1037         else { /* XXXX: logic is complicated, leave it along for a moment. */
1038             cl_anything(pRExC_state, cl);
1039         }
1040
1041         if (ANYOF_NONBITMAP(or_with)) {
1042
1043             /* Use the added node's outside-the-bit-map match if there isn't a
1044              * conflict.  If there is a conflict (both nodes match something
1045              * outside the bitmap, but what they match outside is not the same
1046              * pointer, and hence not easily compared until XXX we extend
1047              * inversion lists this far), give up and allow the start class to
1048              * match everything outside the bitmap.  If that stuff is all above
1049              * 255, can just set UNICODE_ALL, otherwise caould be anything. */
1050             if (! ANYOF_NONBITMAP(cl)) {
1051                 ARG_SET(cl, ARG(or_with));
1052             }
1053             else if (ARG(cl) != ARG(or_with)) {
1054
1055                 if ((or_with->flags & ANYOF_NONBITMAP_NON_UTF8)) {
1056                     cl_anything(pRExC_state, cl);
1057                 }
1058                 else {
1059                     cl->flags |= ANYOF_UNICODE_ALL;
1060                 }
1061             }
1062         }
1063
1064         /* Take the union */
1065         cl->flags |= or_with->flags;
1066     }
1067 }
1068
1069 #define TRIE_LIST_ITEM(state,idx) (trie->states[state].trans.list)[ idx ]
1070 #define TRIE_LIST_CUR(state)  ( TRIE_LIST_ITEM( state, 0 ).forid )
1071 #define TRIE_LIST_LEN(state) ( TRIE_LIST_ITEM( state, 0 ).newstate )
1072 #define TRIE_LIST_USED(idx)  ( trie->states[state].trans.list ? (TRIE_LIST_CUR( idx ) - 1) : 0 )
1073
1074
1075 #ifdef DEBUGGING
1076 /*
1077    dump_trie(trie,widecharmap,revcharmap)
1078    dump_trie_interim_list(trie,widecharmap,revcharmap,next_alloc)
1079    dump_trie_interim_table(trie,widecharmap,revcharmap,next_alloc)
1080
1081    These routines dump out a trie in a somewhat readable format.
1082    The _interim_ variants are used for debugging the interim
1083    tables that are used to generate the final compressed
1084    representation which is what dump_trie expects.
1085
1086    Part of the reason for their existence is to provide a form
1087    of documentation as to how the different representations function.
1088
1089 */
1090
1091 /*
1092   Dumps the final compressed table form of the trie to Perl_debug_log.
1093   Used for debugging make_trie().
1094 */
1095
1096 STATIC void
1097 S_dump_trie(pTHX_ const struct _reg_trie_data *trie, HV *widecharmap,
1098             AV *revcharmap, U32 depth)
1099 {
1100     U32 state;
1101     SV *sv=sv_newmortal();
1102     int colwidth= widecharmap ? 6 : 4;
1103     U16 word;
1104     GET_RE_DEBUG_FLAGS_DECL;
1105
1106     PERL_ARGS_ASSERT_DUMP_TRIE;
1107
1108     PerlIO_printf( Perl_debug_log, "%*sChar : %-6s%-6s%-4s ",
1109         (int)depth * 2 + 2,"",
1110         "Match","Base","Ofs" );
1111
1112     for( state = 0 ; state < trie->uniquecharcount ; state++ ) {
1113         SV ** const tmp = av_fetch( revcharmap, state, 0);
1114         if ( tmp ) {
1115             PerlIO_printf( Perl_debug_log, "%*s", 
1116                 colwidth,
1117                 pv_pretty(sv, SvPV_nolen_const(*tmp), SvCUR(*tmp), colwidth, 
1118                             PL_colors[0], PL_colors[1],
1119                             (SvUTF8(*tmp) ? PERL_PV_ESCAPE_UNI : 0) |
1120                             PERL_PV_ESCAPE_FIRSTCHAR 
1121                 ) 
1122             );
1123         }
1124     }
1125     PerlIO_printf( Perl_debug_log, "\n%*sState|-----------------------",
1126         (int)depth * 2 + 2,"");
1127
1128     for( state = 0 ; state < trie->uniquecharcount ; state++ )
1129         PerlIO_printf( Perl_debug_log, "%.*s", colwidth, "--------");
1130     PerlIO_printf( Perl_debug_log, "\n");
1131
1132     for( state = 1 ; state < trie->statecount ; state++ ) {
1133         const U32 base = trie->states[ state ].trans.base;
1134
1135         PerlIO_printf( Perl_debug_log, "%*s#%4"UVXf"|", (int)depth * 2 + 2,"", (UV)state);
1136
1137         if ( trie->states[ state ].wordnum ) {
1138             PerlIO_printf( Perl_debug_log, " W%4X", trie->states[ state ].wordnum );
1139         } else {
1140             PerlIO_printf( Perl_debug_log, "%6s", "" );
1141         }
1142
1143         PerlIO_printf( Perl_debug_log, " @%4"UVXf" ", (UV)base );
1144
1145         if ( base ) {
1146             U32 ofs = 0;
1147
1148             while( ( base + ofs  < trie->uniquecharcount ) ||
1149                    ( base + ofs - trie->uniquecharcount < trie->lasttrans
1150                      && trie->trans[ base + ofs - trie->uniquecharcount ].check != state))
1151                     ofs++;
1152
1153             PerlIO_printf( Perl_debug_log, "+%2"UVXf"[ ", (UV)ofs);
1154
1155             for ( ofs = 0 ; ofs < trie->uniquecharcount ; ofs++ ) {
1156                 if ( ( base + ofs >= trie->uniquecharcount ) &&
1157                      ( base + ofs - trie->uniquecharcount < trie->lasttrans ) &&
1158                      trie->trans[ base + ofs - trie->uniquecharcount ].check == state )
1159                 {
1160                    PerlIO_printf( Perl_debug_log, "%*"UVXf,
1161                     colwidth,
1162                     (UV)trie->trans[ base + ofs - trie->uniquecharcount ].next );
1163                 } else {
1164                     PerlIO_printf( Perl_debug_log, "%*s",colwidth,"   ." );
1165                 }
1166             }
1167
1168             PerlIO_printf( Perl_debug_log, "]");
1169
1170         }
1171         PerlIO_printf( Perl_debug_log, "\n" );
1172     }
1173     PerlIO_printf(Perl_debug_log, "%*sword_info N:(prev,len)=", (int)depth*2, "");
1174     for (word=1; word <= trie->wordcount; word++) {
1175         PerlIO_printf(Perl_debug_log, " %d:(%d,%d)",
1176             (int)word, (int)(trie->wordinfo[word].prev),
1177             (int)(trie->wordinfo[word].len));
1178     }
1179     PerlIO_printf(Perl_debug_log, "\n" );
1180 }    
1181 /*
1182   Dumps a fully constructed but uncompressed trie in list form.
1183   List tries normally only are used for construction when the number of 
1184   possible chars (trie->uniquecharcount) is very high.
1185   Used for debugging make_trie().
1186 */
1187 STATIC void
1188 S_dump_trie_interim_list(pTHX_ const struct _reg_trie_data *trie,
1189                          HV *widecharmap, AV *revcharmap, U32 next_alloc,
1190                          U32 depth)
1191 {
1192     U32 state;
1193     SV *sv=sv_newmortal();
1194     int colwidth= widecharmap ? 6 : 4;
1195     GET_RE_DEBUG_FLAGS_DECL;
1196
1197     PERL_ARGS_ASSERT_DUMP_TRIE_INTERIM_LIST;
1198
1199     /* print out the table precompression.  */
1200     PerlIO_printf( Perl_debug_log, "%*sState :Word | Transition Data\n%*s%s",
1201         (int)depth * 2 + 2,"", (int)depth * 2 + 2,"",
1202         "------:-----+-----------------\n" );
1203     
1204     for( state=1 ; state < next_alloc ; state ++ ) {
1205         U16 charid;
1206     
1207         PerlIO_printf( Perl_debug_log, "%*s %4"UVXf" :",
1208             (int)depth * 2 + 2,"", (UV)state  );
1209         if ( ! trie->states[ state ].wordnum ) {
1210             PerlIO_printf( Perl_debug_log, "%5s| ","");
1211         } else {
1212             PerlIO_printf( Perl_debug_log, "W%4x| ",
1213                 trie->states[ state ].wordnum
1214             );
1215         }
1216         for( charid = 1 ; charid <= TRIE_LIST_USED( state ) ; charid++ ) {
1217             SV ** const tmp = av_fetch( revcharmap, TRIE_LIST_ITEM(state,charid).forid, 0);
1218             if ( tmp ) {
1219                 PerlIO_printf( Perl_debug_log, "%*s:%3X=%4"UVXf" | ",
1220                     colwidth,
1221                     pv_pretty(sv, SvPV_nolen_const(*tmp), SvCUR(*tmp), colwidth, 
1222                             PL_colors[0], PL_colors[1],
1223                             (SvUTF8(*tmp) ? PERL_PV_ESCAPE_UNI : 0) |
1224                             PERL_PV_ESCAPE_FIRSTCHAR 
1225                     ) ,
1226                     TRIE_LIST_ITEM(state,charid).forid,
1227                     (UV)TRIE_LIST_ITEM(state,charid).newstate
1228                 );
1229                 if (!(charid % 10)) 
1230                     PerlIO_printf(Perl_debug_log, "\n%*s| ",
1231                         (int)((depth * 2) + 14), "");
1232             }
1233         }
1234         PerlIO_printf( Perl_debug_log, "\n");
1235     }
1236 }    
1237
1238 /*
1239   Dumps a fully constructed but uncompressed trie in table form.
1240   This is the normal DFA style state transition table, with a few 
1241   twists to facilitate compression later. 
1242   Used for debugging make_trie().
1243 */
1244 STATIC void
1245 S_dump_trie_interim_table(pTHX_ const struct _reg_trie_data *trie,
1246                           HV *widecharmap, AV *revcharmap, U32 next_alloc,
1247                           U32 depth)
1248 {
1249     U32 state;
1250     U16 charid;
1251     SV *sv=sv_newmortal();
1252     int colwidth= widecharmap ? 6 : 4;
1253     GET_RE_DEBUG_FLAGS_DECL;
1254
1255     PERL_ARGS_ASSERT_DUMP_TRIE_INTERIM_TABLE;
1256     
1257     /*
1258        print out the table precompression so that we can do a visual check
1259        that they are identical.
1260      */
1261     
1262     PerlIO_printf( Perl_debug_log, "%*sChar : ",(int)depth * 2 + 2,"" );
1263
1264     for( charid = 0 ; charid < trie->uniquecharcount ; charid++ ) {
1265         SV ** const tmp = av_fetch( revcharmap, charid, 0);
1266         if ( tmp ) {
1267             PerlIO_printf( Perl_debug_log, "%*s", 
1268                 colwidth,
1269                 pv_pretty(sv, SvPV_nolen_const(*tmp), SvCUR(*tmp), colwidth, 
1270                             PL_colors[0], PL_colors[1],
1271                             (SvUTF8(*tmp) ? PERL_PV_ESCAPE_UNI : 0) |
1272                             PERL_PV_ESCAPE_FIRSTCHAR 
1273                 ) 
1274             );
1275         }
1276     }
1277
1278     PerlIO_printf( Perl_debug_log, "\n%*sState+-",(int)depth * 2 + 2,"" );
1279
1280     for( charid=0 ; charid < trie->uniquecharcount ; charid++ ) {
1281         PerlIO_printf( Perl_debug_log, "%.*s", colwidth,"--------");
1282     }
1283
1284     PerlIO_printf( Perl_debug_log, "\n" );
1285
1286     for( state=1 ; state < next_alloc ; state += trie->uniquecharcount ) {
1287
1288         PerlIO_printf( Perl_debug_log, "%*s%4"UVXf" : ", 
1289             (int)depth * 2 + 2,"",
1290             (UV)TRIE_NODENUM( state ) );
1291
1292         for( charid = 0 ; charid < trie->uniquecharcount ; charid++ ) {
1293             UV v=(UV)SAFE_TRIE_NODENUM( trie->trans[ state + charid ].next );
1294             if (v)
1295                 PerlIO_printf( Perl_debug_log, "%*"UVXf, colwidth, v );
1296             else
1297                 PerlIO_printf( Perl_debug_log, "%*s", colwidth, "." );
1298         }
1299         if ( ! trie->states[ TRIE_NODENUM( state ) ].wordnum ) {
1300             PerlIO_printf( Perl_debug_log, " (%4"UVXf")\n", (UV)trie->trans[ state ].check );
1301         } else {
1302             PerlIO_printf( Perl_debug_log, " (%4"UVXf") W%4X\n", (UV)trie->trans[ state ].check,
1303             trie->states[ TRIE_NODENUM( state ) ].wordnum );
1304         }
1305     }
1306 }
1307
1308 #endif
1309
1310
1311 /* make_trie(startbranch,first,last,tail,word_count,flags,depth)
1312   startbranch: the first branch in the whole branch sequence
1313   first      : start branch of sequence of branch-exact nodes.
1314                May be the same as startbranch
1315   last       : Thing following the last branch.
1316                May be the same as tail.
1317   tail       : item following the branch sequence
1318   count      : words in the sequence
1319   flags      : currently the OP() type we will be building one of /EXACT(|F|Fl)/
1320   depth      : indent depth
1321
1322 Inplace optimizes a sequence of 2 or more Branch-Exact nodes into a TRIE node.
1323
1324 A trie is an N'ary tree where the branches are determined by digital
1325 decomposition of the key. IE, at the root node you look up the 1st character and
1326 follow that branch repeat until you find the end of the branches. Nodes can be
1327 marked as "accepting" meaning they represent a complete word. Eg:
1328
1329   /he|she|his|hers/
1330
1331 would convert into the following structure. Numbers represent states, letters
1332 following numbers represent valid transitions on the letter from that state, if
1333 the number is in square brackets it represents an accepting state, otherwise it
1334 will be in parenthesis.
1335
1336       +-h->+-e->[3]-+-r->(8)-+-s->[9]
1337       |    |
1338       |   (2)
1339       |    |
1340      (1)   +-i->(6)-+-s->[7]
1341       |
1342       +-s->(3)-+-h->(4)-+-e->[5]
1343
1344       Accept Word Mapping: 3=>1 (he),5=>2 (she), 7=>3 (his), 9=>4 (hers)
1345
1346 This shows that when matching against the string 'hers' we will begin at state 1
1347 read 'h' and move to state 2, read 'e' and move to state 3 which is accepting,
1348 then read 'r' and go to state 8 followed by 's' which takes us to state 9 which
1349 is also accepting. Thus we know that we can match both 'he' and 'hers' with a
1350 single traverse. We store a mapping from accepting to state to which word was
1351 matched, and then when we have multiple possibilities we try to complete the
1352 rest of the regex in the order in which they occured in the alternation.
1353
1354 The only prior NFA like behaviour that would be changed by the TRIE support is
1355 the silent ignoring of duplicate alternations which are of the form:
1356
1357  / (DUPE|DUPE) X? (?{ ... }) Y /x
1358
1359 Thus EVAL blocks following a trie may be called a different number of times with
1360 and without the optimisation. With the optimisations dupes will be silently
1361 ignored. This inconsistent behaviour of EVAL type nodes is well established as
1362 the following demonstrates:
1363
1364  'words'=~/(word|word|word)(?{ print $1 })[xyz]/
1365
1366 which prints out 'word' three times, but
1367
1368  'words'=~/(word|word|word)(?{ print $1 })S/
1369
1370 which doesnt print it out at all. This is due to other optimisations kicking in.
1371
1372 Example of what happens on a structural level:
1373
1374 The regexp /(ac|ad|ab)+/ will produce the following debug output:
1375
1376    1: CURLYM[1] {1,32767}(18)
1377    5:   BRANCH(8)
1378    6:     EXACT <ac>(16)
1379    8:   BRANCH(11)
1380    9:     EXACT <ad>(16)
1381   11:   BRANCH(14)
1382   12:     EXACT <ab>(16)
1383   16:   SUCCEED(0)
1384   17:   NOTHING(18)
1385   18: END(0)
1386
1387 This would be optimizable with startbranch=5, first=5, last=16, tail=16
1388 and should turn into:
1389
1390    1: CURLYM[1] {1,32767}(18)
1391    5:   TRIE(16)
1392         [Words:3 Chars Stored:6 Unique Chars:4 States:5 NCP:1]
1393           <ac>
1394           <ad>
1395           <ab>
1396   16:   SUCCEED(0)
1397   17:   NOTHING(18)
1398   18: END(0)
1399
1400 Cases where tail != last would be like /(?foo|bar)baz/:
1401
1402    1: BRANCH(4)
1403    2:   EXACT <foo>(8)
1404    4: BRANCH(7)
1405    5:   EXACT <bar>(8)
1406    7: TAIL(8)
1407    8: EXACT <baz>(10)
1408   10: END(0)
1409
1410 which would be optimizable with startbranch=1, first=1, last=7, tail=8
1411 and would end up looking like:
1412
1413     1: TRIE(8)
1414       [Words:2 Chars Stored:6 Unique Chars:5 States:7 NCP:1]
1415         <foo>
1416         <bar>
1417    7: TAIL(8)
1418    8: EXACT <baz>(10)
1419   10: END(0)
1420
1421     d = uvuni_to_utf8_flags(d, uv, 0);
1422
1423 is the recommended Unicode-aware way of saying
1424
1425     *(d++) = uv;
1426 */
1427
1428 #define TRIE_STORE_REVCHAR(val)                                            \
1429     STMT_START {                                                           \
1430         if (UTF) {                                                         \
1431             SV *zlopp = newSV(7); /* XXX: optimize me */                   \
1432             unsigned char *flrbbbbb = (unsigned char *) SvPVX(zlopp);      \
1433             unsigned const char *const kapow = uvuni_to_utf8(flrbbbbb, val); \
1434             SvCUR_set(zlopp, kapow - flrbbbbb);                            \
1435             SvPOK_on(zlopp);                                               \
1436             SvUTF8_on(zlopp);                                              \
1437             av_push(revcharmap, zlopp);                                    \
1438         } else {                                                           \
1439             char ooooff = (char)val;                                           \
1440             av_push(revcharmap, newSVpvn(&ooooff, 1));                     \
1441         }                                                                  \
1442         } STMT_END
1443
1444 #define TRIE_READ_CHAR STMT_START {                                                     \
1445     wordlen++;                                                                          \
1446     if ( UTF ) {                                                                        \
1447         /* if it is UTF then it is either already folded, or does not need folding */   \
1448         uvc = utf8n_to_uvuni( (const U8*) uc, UTF8_MAXLEN, &len, uniflags);             \
1449     }                                                                                   \
1450     else if (folder == PL_fold_latin1) {                                                \
1451         /* if we use this folder we have to obey unicode rules on latin-1 data */       \
1452         if ( foldlen > 0 ) {                                                            \
1453            uvc = utf8n_to_uvuni( (const U8*) scan, UTF8_MAXLEN, &len, uniflags );       \
1454            foldlen -= len;                                                              \
1455            scan += len;                                                                 \
1456            len = 0;                                                                     \
1457         } else {                                                                        \
1458             len = 1;                                                                    \
1459             uvc = _to_fold_latin1( (U8) *uc, foldbuf, &foldlen, FOLD_FLAGS_FULL);       \
1460             skiplen = UNISKIP(uvc);                                                     \
1461             foldlen -= skiplen;                                                         \
1462             scan = foldbuf + skiplen;                                                   \
1463         }                                                                               \
1464     } else {                                                                            \
1465         /* raw data, will be folded later if needed */                                  \
1466         uvc = (U32)*uc;                                                                 \
1467         len = 1;                                                                        \
1468     }                                                                                   \
1469 } STMT_END
1470
1471
1472
1473 #define TRIE_LIST_PUSH(state,fid,ns) STMT_START {               \
1474     if ( TRIE_LIST_CUR( state ) >=TRIE_LIST_LEN( state ) ) {    \
1475         U32 ging = TRIE_LIST_LEN( state ) *= 2;                 \
1476         Renew( trie->states[ state ].trans.list, ging, reg_trie_trans_le ); \
1477     }                                                           \
1478     TRIE_LIST_ITEM( state, TRIE_LIST_CUR( state ) ).forid = fid;     \
1479     TRIE_LIST_ITEM( state, TRIE_LIST_CUR( state ) ).newstate = ns;   \
1480     TRIE_LIST_CUR( state )++;                                   \
1481 } STMT_END
1482
1483 #define TRIE_LIST_NEW(state) STMT_START {                       \
1484     Newxz( trie->states[ state ].trans.list,               \
1485         4, reg_trie_trans_le );                                 \
1486      TRIE_LIST_CUR( state ) = 1;                                \
1487      TRIE_LIST_LEN( state ) = 4;                                \
1488 } STMT_END
1489
1490 #define TRIE_HANDLE_WORD(state) STMT_START {                    \
1491     U16 dupe= trie->states[ state ].wordnum;                    \
1492     regnode * const noper_next = regnext( noper );              \
1493                                                                 \
1494     DEBUG_r({                                                   \
1495         /* store the word for dumping */                        \
1496         SV* tmp;                                                \
1497         if (OP(noper) != NOTHING)                               \
1498             tmp = newSVpvn_utf8(STRING(noper), STR_LEN(noper), UTF);    \
1499         else                                                    \
1500             tmp = newSVpvn_utf8( "", 0, UTF );                  \
1501         av_push( trie_words, tmp );                             \
1502     });                                                         \
1503                                                                 \
1504     curword++;                                                  \
1505     trie->wordinfo[curword].prev   = 0;                         \
1506     trie->wordinfo[curword].len    = wordlen;                   \
1507     trie->wordinfo[curword].accept = state;                     \
1508                                                                 \
1509     if ( noper_next < tail ) {                                  \
1510         if (!trie->jump)                                        \
1511             trie->jump = (U16 *) PerlMemShared_calloc( word_count + 1, sizeof(U16) ); \
1512         trie->jump[curword] = (U16)(noper_next - convert);      \
1513         if (!jumper)                                            \
1514             jumper = noper_next;                                \
1515         if (!nextbranch)                                        \
1516             nextbranch= regnext(cur);                           \
1517     }                                                           \
1518                                                                 \
1519     if ( dupe ) {                                               \
1520         /* It's a dupe. Pre-insert into the wordinfo[].prev   */\
1521         /* chain, so that when the bits of chain are later    */\
1522         /* linked together, the dups appear in the chain      */\
1523         trie->wordinfo[curword].prev = trie->wordinfo[dupe].prev; \
1524         trie->wordinfo[dupe].prev = curword;                    \
1525     } else {                                                    \
1526         /* we haven't inserted this word yet.                */ \
1527         trie->states[ state ].wordnum = curword;                \
1528     }                                                           \
1529 } STMT_END
1530
1531
1532 #define TRIE_TRANS_STATE(state,base,ucharcount,charid,special)          \
1533      ( ( base + charid >=  ucharcount                                   \
1534          && base + charid < ubound                                      \
1535          && state == trie->trans[ base - ucharcount + charid ].check    \
1536          && trie->trans[ base - ucharcount + charid ].next )            \
1537            ? trie->trans[ base - ucharcount + charid ].next             \
1538            : ( state==1 ? special : 0 )                                 \
1539       )
1540
1541 #define MADE_TRIE       1
1542 #define MADE_JUMP_TRIE  2
1543 #define MADE_EXACT_TRIE 4
1544
1545 STATIC I32
1546 S_make_trie(pTHX_ RExC_state_t *pRExC_state, regnode *startbranch, regnode *first, regnode *last, regnode *tail, U32 word_count, U32 flags, U32 depth)
1547 {
1548     dVAR;
1549     /* first pass, loop through and scan words */
1550     reg_trie_data *trie;
1551     HV *widecharmap = NULL;
1552     AV *revcharmap = newAV();
1553     regnode *cur;
1554     const U32 uniflags = UTF8_ALLOW_DEFAULT;
1555     STRLEN len = 0;
1556     UV uvc = 0;
1557     U16 curword = 0;
1558     U32 next_alloc = 0;
1559     regnode *jumper = NULL;
1560     regnode *nextbranch = NULL;
1561     regnode *convert = NULL;
1562     U32 *prev_states; /* temp array mapping each state to previous one */
1563     /* we just use folder as a flag in utf8 */
1564     const U8 * folder = NULL;
1565
1566 #ifdef DEBUGGING
1567     const U32 data_slot = add_data( pRExC_state, 4, "tuuu" );
1568     AV *trie_words = NULL;
1569     /* along with revcharmap, this only used during construction but both are
1570      * useful during debugging so we store them in the struct when debugging.
1571      */
1572 #else
1573     const U32 data_slot = add_data( pRExC_state, 2, "tu" );
1574     STRLEN trie_charcount=0;
1575 #endif
1576     SV *re_trie_maxbuff;
1577     GET_RE_DEBUG_FLAGS_DECL;
1578
1579     PERL_ARGS_ASSERT_MAKE_TRIE;
1580 #ifndef DEBUGGING
1581     PERL_UNUSED_ARG(depth);
1582 #endif
1583
1584     switch (flags) {
1585         case EXACT: break;
1586         case EXACTFA:
1587         case EXACTFU_SS:
1588         case EXACTFU_TRICKYFOLD:
1589         case EXACTFU: folder = PL_fold_latin1; break;
1590         case EXACTF:  folder = PL_fold; break;
1591         case EXACTFL: folder = PL_fold_locale; break;
1592         default: Perl_croak( aTHX_ "panic! In trie construction, unknown node type %u %s", (unsigned) flags, PL_reg_name[flags] );
1593     }
1594
1595     trie = (reg_trie_data *) PerlMemShared_calloc( 1, sizeof(reg_trie_data) );
1596     trie->refcount = 1;
1597     trie->startstate = 1;
1598     trie->wordcount = word_count;
1599     RExC_rxi->data->data[ data_slot ] = (void*)trie;
1600     trie->charmap = (U16 *) PerlMemShared_calloc( 256, sizeof(U16) );
1601     if (flags == EXACT)
1602         trie->bitmap = (char *) PerlMemShared_calloc( ANYOF_BITMAP_SIZE, 1 );
1603     trie->wordinfo = (reg_trie_wordinfo *) PerlMemShared_calloc(
1604                        trie->wordcount+1, sizeof(reg_trie_wordinfo));
1605
1606     DEBUG_r({
1607         trie_words = newAV();
1608     });
1609
1610     re_trie_maxbuff = get_sv(RE_TRIE_MAXBUF_NAME, 1);
1611     if (!SvIOK(re_trie_maxbuff)) {
1612         sv_setiv(re_trie_maxbuff, RE_TRIE_MAXBUF_INIT);
1613     }
1614     DEBUG_TRIE_COMPILE_r({
1615                 PerlIO_printf( Perl_debug_log,
1616                   "%*smake_trie start==%d, first==%d, last==%d, tail==%d depth=%d\n",
1617                   (int)depth * 2 + 2, "", 
1618                   REG_NODE_NUM(startbranch),REG_NODE_NUM(first), 
1619                   REG_NODE_NUM(last), REG_NODE_NUM(tail),
1620                   (int)depth);
1621     });
1622    
1623    /* Find the node we are going to overwrite */
1624     if ( first == startbranch && OP( last ) != BRANCH ) {
1625         /* whole branch chain */
1626         convert = first;
1627     } else {
1628         /* branch sub-chain */
1629         convert = NEXTOPER( first );
1630     }
1631         
1632     /*  -- First loop and Setup --
1633
1634        We first traverse the branches and scan each word to determine if it
1635        contains widechars, and how many unique chars there are, this is
1636        important as we have to build a table with at least as many columns as we
1637        have unique chars.
1638
1639        We use an array of integers to represent the character codes 0..255
1640        (trie->charmap) and we use a an HV* to store Unicode characters. We use the
1641        native representation of the character value as the key and IV's for the
1642        coded index.
1643
1644        *TODO* If we keep track of how many times each character is used we can
1645        remap the columns so that the table compression later on is more
1646        efficient in terms of memory by ensuring the most common value is in the
1647        middle and the least common are on the outside.  IMO this would be better
1648        than a most to least common mapping as theres a decent chance the most
1649        common letter will share a node with the least common, meaning the node
1650        will not be compressible. With a middle is most common approach the worst
1651        case is when we have the least common nodes twice.
1652
1653      */
1654
1655     for ( cur = first ; cur < last ; cur = regnext( cur ) ) {
1656         regnode *noper = NEXTOPER( cur );
1657         const U8 *uc = (U8*)STRING( noper );
1658         const U8 *e  = uc + STR_LEN( noper );
1659         STRLEN foldlen = 0;
1660         U8 foldbuf[ UTF8_MAXBYTES_CASE + 1 ];
1661         STRLEN skiplen = 0;
1662         const U8 *scan = (U8*)NULL;
1663         U32 wordlen      = 0;         /* required init */
1664         STRLEN chars = 0;
1665         bool set_bit = trie->bitmap ? 1 : 0; /*store the first char in the bitmap?*/
1666
1667         if (OP(noper) == NOTHING) {
1668             regnode *noper_next= regnext(noper);
1669             if (noper_next != tail && OP(noper_next) == flags) {
1670                 noper = noper_next;
1671                 uc= (U8*)STRING(noper);
1672                 e= uc + STR_LEN(noper);
1673                 trie->minlen= STR_LEN(noper);
1674             } else {
1675                 trie->minlen= 0;
1676                 continue;
1677             }
1678         }
1679
1680         if ( set_bit ) { /* bitmap only alloced when !(UTF&&Folding) */
1681             TRIE_BITMAP_SET(trie,*uc); /* store the raw first byte
1682                                           regardless of encoding */
1683             if (OP( noper ) == EXACTFU_SS) {
1684                 /* false positives are ok, so just set this */
1685                 TRIE_BITMAP_SET(trie,0xDF);
1686             }
1687         }
1688         for ( ; uc < e ; uc += len ) {
1689             TRIE_CHARCOUNT(trie)++;
1690             TRIE_READ_CHAR;
1691             chars++;
1692             if ( uvc < 256 ) {
1693                 if ( folder ) {
1694                     U8 folded= folder[ (U8) uvc ];
1695                     if ( !trie->charmap[ folded ] ) {
1696                         trie->charmap[ folded ]=( ++trie->uniquecharcount );
1697                         TRIE_STORE_REVCHAR( folded );
1698                     }
1699                 }
1700                 if ( !trie->charmap[ uvc ] ) {
1701                     trie->charmap[ uvc ]=( ++trie->uniquecharcount );
1702                     TRIE_STORE_REVCHAR( uvc );
1703                 }
1704                 if ( set_bit ) {
1705                     /* store the codepoint in the bitmap, and its folded
1706                      * equivalent. */
1707                     TRIE_BITMAP_SET(trie, uvc);
1708
1709                     /* store the folded codepoint */
1710                     if ( folder ) TRIE_BITMAP_SET(trie, folder[(U8) uvc ]);
1711
1712                     if ( !UTF ) {
1713                         /* store first byte of utf8 representation of
1714                            variant codepoints */
1715                         if (! UNI_IS_INVARIANT(uvc)) {
1716                             TRIE_BITMAP_SET(trie, UTF8_TWO_BYTE_HI(uvc));
1717                         }
1718                     }
1719                     set_bit = 0; /* We've done our bit :-) */
1720                 }
1721             } else {
1722                 SV** svpp;
1723                 if ( !widecharmap )
1724                     widecharmap = newHV();
1725
1726                 svpp = hv_fetch( widecharmap, (char*)&uvc, sizeof( UV ), 1 );
1727
1728                 if ( !svpp )
1729                     Perl_croak( aTHX_ "error creating/fetching widecharmap entry for 0x%"UVXf, uvc );
1730
1731                 if ( !SvTRUE( *svpp ) ) {
1732                     sv_setiv( *svpp, ++trie->uniquecharcount );
1733                     TRIE_STORE_REVCHAR(uvc);
1734                 }
1735             }
1736         }
1737         if( cur == first ) {
1738             trie->minlen = chars;
1739             trie->maxlen = chars;
1740         } else if (chars < trie->minlen) {
1741             trie->minlen = chars;
1742         } else if (chars > trie->maxlen) {
1743             trie->maxlen = chars;
1744         }
1745         if (OP( noper ) == EXACTFU_SS) {
1746             /* XXX: workaround - 'ss' could match "\x{DF}" so minlen could be 1 and not 2*/
1747             if (trie->minlen > 1)
1748                 trie->minlen= 1;
1749         }
1750         if (OP( noper ) == EXACTFU_TRICKYFOLD) {
1751             /* XXX: workround - things like "\x{1FBE}\x{0308}\x{0301}" can match "\x{0390}" 
1752              *                - We assume that any such sequence might match a 2 byte string */
1753             if (trie->minlen > 2 )
1754                 trie->minlen= 2;
1755         }
1756
1757     } /* end first pass */
1758     DEBUG_TRIE_COMPILE_r(
1759         PerlIO_printf( Perl_debug_log, "%*sTRIE(%s): W:%d C:%d Uq:%d Min:%d Max:%d\n",
1760                 (int)depth * 2 + 2,"",
1761                 ( widecharmap ? "UTF8" : "NATIVE" ), (int)word_count,
1762                 (int)TRIE_CHARCOUNT(trie), trie->uniquecharcount,
1763                 (int)trie->minlen, (int)trie->maxlen )
1764     );
1765
1766     /*
1767         We now know what we are dealing with in terms of unique chars and
1768         string sizes so we can calculate how much memory a naive
1769         representation using a flat table  will take. If it's over a reasonable
1770         limit (as specified by ${^RE_TRIE_MAXBUF}) we use a more memory
1771         conservative but potentially much slower representation using an array
1772         of lists.
1773
1774         At the end we convert both representations into the same compressed
1775         form that will be used in regexec.c for matching with. The latter
1776         is a form that cannot be used to construct with but has memory
1777         properties similar to the list form and access properties similar
1778         to the table form making it both suitable for fast searches and
1779         small enough that its feasable to store for the duration of a program.
1780
1781         See the comment in the code where the compressed table is produced
1782         inplace from the flat tabe representation for an explanation of how
1783         the compression works.
1784
1785     */
1786
1787
1788     Newx(prev_states, TRIE_CHARCOUNT(trie) + 2, U32);
1789     prev_states[1] = 0;
1790
1791     if ( (IV)( ( TRIE_CHARCOUNT(trie) + 1 ) * trie->uniquecharcount + 1) > SvIV(re_trie_maxbuff) ) {
1792         /*
1793             Second Pass -- Array Of Lists Representation
1794
1795             Each state will be represented by a list of charid:state records
1796             (reg_trie_trans_le) the first such element holds the CUR and LEN
1797             points of the allocated array. (See defines above).
1798
1799             We build the initial structure using the lists, and then convert
1800             it into the compressed table form which allows faster lookups
1801             (but cant be modified once converted).
1802         */
1803
1804         STRLEN transcount = 1;
1805
1806         DEBUG_TRIE_COMPILE_MORE_r( PerlIO_printf( Perl_debug_log, 
1807             "%*sCompiling trie using list compiler\n",
1808             (int)depth * 2 + 2, ""));
1809
1810         trie->states = (reg_trie_state *)
1811             PerlMemShared_calloc( TRIE_CHARCOUNT(trie) + 2,
1812                                   sizeof(reg_trie_state) );
1813         TRIE_LIST_NEW(1);
1814         next_alloc = 2;
1815
1816         for ( cur = first ; cur < last ; cur = regnext( cur ) ) {
1817
1818             regnode *noper   = NEXTOPER( cur );
1819             U8 *uc           = (U8*)STRING( noper );
1820             const U8 *e      = uc + STR_LEN( noper );
1821             U32 state        = 1;         /* required init */
1822             U16 charid       = 0;         /* sanity init */
1823             U8 *scan         = (U8*)NULL; /* sanity init */
1824             STRLEN foldlen   = 0;         /* required init */
1825             U32 wordlen      = 0;         /* required init */
1826             U8 foldbuf[ UTF8_MAXBYTES_CASE + 1 ];
1827             STRLEN skiplen   = 0;
1828
1829             if (OP(noper) == NOTHING) {
1830                 regnode *noper_next= regnext(noper);
1831                 if (noper_next != tail && OP(noper_next) == flags) {
1832                     noper = noper_next;
1833                     uc= (U8*)STRING(noper);
1834                     e= uc + STR_LEN(noper);
1835                 }
1836             }
1837
1838             if (OP(noper) != NOTHING) {
1839                 for ( ; uc < e ; uc += len ) {
1840
1841                     TRIE_READ_CHAR;
1842
1843                     if ( uvc < 256 ) {
1844                         charid = trie->charmap[ uvc ];
1845                     } else {
1846                         SV** const svpp = hv_fetch( widecharmap, (char*)&uvc, sizeof( UV ), 0);
1847                         if ( !svpp ) {
1848                             charid = 0;
1849                         } else {
1850                             charid=(U16)SvIV( *svpp );
1851                         }
1852                     }
1853                     /* charid is now 0 if we dont know the char read, or nonzero if we do */
1854                     if ( charid ) {
1855
1856                         U16 check;
1857                         U32 newstate = 0;
1858
1859                         charid--;
1860                         if ( !trie->states[ state ].trans.list ) {
1861                             TRIE_LIST_NEW( state );
1862                         }
1863                         for ( check = 1; check <= TRIE_LIST_USED( state ); check++ ) {
1864                             if ( TRIE_LIST_ITEM( state, check ).forid == charid ) {
1865                                 newstate = TRIE_LIST_ITEM( state, check ).newstate;
1866                                 break;
1867                             }
1868                         }
1869                         if ( ! newstate ) {
1870                             newstate = next_alloc++;
1871                             prev_states[newstate] = state;
1872                             TRIE_LIST_PUSH( state, charid, newstate );
1873                             transcount++;
1874                         }
1875                         state = newstate;
1876                     } else {
1877                         Perl_croak( aTHX_ "panic! In trie construction, no char mapping for %"IVdf, uvc );
1878                     }
1879                 }
1880             }
1881             TRIE_HANDLE_WORD(state);
1882
1883         } /* end second pass */
1884
1885         /* next alloc is the NEXT state to be allocated */
1886         trie->statecount = next_alloc; 
1887         trie->states = (reg_trie_state *)
1888             PerlMemShared_realloc( trie->states,
1889                                    next_alloc
1890                                    * sizeof(reg_trie_state) );
1891
1892         /* and now dump it out before we compress it */
1893         DEBUG_TRIE_COMPILE_MORE_r(dump_trie_interim_list(trie, widecharmap,
1894                                                          revcharmap, next_alloc,
1895                                                          depth+1)
1896         );
1897
1898         trie->trans = (reg_trie_trans *)
1899             PerlMemShared_calloc( transcount, sizeof(reg_trie_trans) );
1900         {
1901             U32 state;
1902             U32 tp = 0;
1903             U32 zp = 0;
1904
1905
1906             for( state=1 ; state < next_alloc ; state ++ ) {
1907                 U32 base=0;
1908
1909                 /*
1910                 DEBUG_TRIE_COMPILE_MORE_r(
1911                     PerlIO_printf( Perl_debug_log, "tp: %d zp: %d ",tp,zp)
1912                 );
1913                 */
1914
1915                 if (trie->states[state].trans.list) {
1916                     U16 minid=TRIE_LIST_ITEM( state, 1).forid;
1917                     U16 maxid=minid;
1918                     U16 idx;
1919
1920                     for( idx = 2 ; idx <= TRIE_LIST_USED( state ) ; idx++ ) {
1921                         const U16 forid = TRIE_LIST_ITEM( state, idx).forid;
1922                         if ( forid < minid ) {
1923                             minid=forid;
1924                         } else if ( forid > maxid ) {
1925                             maxid=forid;
1926                         }
1927                     }
1928                     if ( transcount < tp + maxid - minid + 1) {
1929                         transcount *= 2;
1930                         trie->trans = (reg_trie_trans *)
1931                             PerlMemShared_realloc( trie->trans,
1932                                                      transcount
1933                                                      * sizeof(reg_trie_trans) );
1934                         Zero( trie->trans + (transcount / 2), transcount / 2 , reg_trie_trans );
1935                     }
1936                     base = trie->uniquecharcount + tp - minid;
1937                     if ( maxid == minid ) {
1938                         U32 set = 0;
1939                         for ( ; zp < tp ; zp++ ) {
1940                             if ( ! trie->trans[ zp ].next ) {
1941                                 base = trie->uniquecharcount + zp - minid;
1942                                 trie->trans[ zp ].next = TRIE_LIST_ITEM( state, 1).newstate;
1943                                 trie->trans[ zp ].check = state;
1944                                 set = 1;
1945                                 break;
1946                             }
1947                         }
1948                         if ( !set ) {
1949                             trie->trans[ tp ].next = TRIE_LIST_ITEM( state, 1).newstate;
1950                             trie->trans[ tp ].check = state;
1951                             tp++;
1952                             zp = tp;
1953                         }
1954                     } else {
1955                         for ( idx=1; idx <= TRIE_LIST_USED( state ) ; idx++ ) {
1956                             const U32 tid = base -  trie->uniquecharcount + TRIE_LIST_ITEM( state, idx ).forid;
1957                             trie->trans[ tid ].next = TRIE_LIST_ITEM( state, idx ).newstate;
1958                             trie->trans[ tid ].check = state;
1959                         }
1960                         tp += ( maxid - minid + 1 );
1961                     }
1962                     Safefree(trie->states[ state ].trans.list);
1963                 }
1964                 /*
1965                 DEBUG_TRIE_COMPILE_MORE_r(
1966                     PerlIO_printf( Perl_debug_log, " base: %d\n",base);
1967                 );
1968                 */
1969                 trie->states[ state ].trans.base=base;
1970             }
1971             trie->lasttrans = tp + 1;
1972         }
1973     } else {
1974         /*
1975            Second Pass -- Flat Table Representation.
1976
1977            we dont use the 0 slot of either trans[] or states[] so we add 1 to each.
1978            We know that we will need Charcount+1 trans at most to store the data
1979            (one row per char at worst case) So we preallocate both structures
1980            assuming worst case.
1981
1982            We then construct the trie using only the .next slots of the entry
1983            structs.
1984
1985            We use the .check field of the first entry of the node temporarily to
1986            make compression both faster and easier by keeping track of how many non
1987            zero fields are in the node.
1988
1989            Since trans are numbered from 1 any 0 pointer in the table is a FAIL
1990            transition.
1991
1992            There are two terms at use here: state as a TRIE_NODEIDX() which is a
1993            number representing the first entry of the node, and state as a
1994            TRIE_NODENUM() which is the trans number. state 1 is TRIE_NODEIDX(1) and
1995            TRIE_NODENUM(1), state 2 is TRIE_NODEIDX(2) and TRIE_NODENUM(3) if there
1996            are 2 entrys per node. eg:
1997
1998              A B       A B
1999           1. 2 4    1. 3 7
2000           2. 0 3    3. 0 5
2001           3. 0 0    5. 0 0
2002           4. 0 0    7. 0 0
2003
2004            The table is internally in the right hand, idx form. However as we also
2005            have to deal with the states array which is indexed by nodenum we have to
2006            use TRIE_NODENUM() to convert.
2007
2008         */
2009         DEBUG_TRIE_COMPILE_MORE_r( PerlIO_printf( Perl_debug_log, 
2010             "%*sCompiling trie using table compiler\n",
2011             (int)depth * 2 + 2, ""));
2012
2013         trie->trans = (reg_trie_trans *)
2014             PerlMemShared_calloc( ( TRIE_CHARCOUNT(trie) + 1 )
2015                                   * trie->uniquecharcount + 1,
2016                                   sizeof(reg_trie_trans) );
2017         trie->states = (reg_trie_state *)
2018             PerlMemShared_calloc( TRIE_CHARCOUNT(trie) + 2,
2019                                   sizeof(reg_trie_state) );
2020         next_alloc = trie->uniquecharcount + 1;
2021
2022
2023         for ( cur = first ; cur < last ; cur = regnext( cur ) ) {
2024
2025             regnode *noper   = NEXTOPER( cur );
2026             const U8 *uc     = (U8*)STRING( noper );
2027             const U8 *e      = uc + STR_LEN( noper );
2028
2029             U32 state        = 1;         /* required init */
2030
2031             U16 charid       = 0;         /* sanity init */
2032             U32 accept_state = 0;         /* sanity init */
2033             U8 *scan         = (U8*)NULL; /* sanity init */
2034
2035             STRLEN foldlen   = 0;         /* required init */
2036             U32 wordlen      = 0;         /* required init */
2037             STRLEN skiplen   = 0;
2038             U8 foldbuf[ UTF8_MAXBYTES_CASE + 1 ];
2039
2040             if (OP(noper) == NOTHING) {
2041                 regnode *noper_next= regnext(noper);
2042                 if (noper_next != tail && OP(noper_next) == flags) {
2043                     noper = noper_next;
2044                     uc= (U8*)STRING(noper);
2045                     e= uc + STR_LEN(noper);
2046                 }
2047             }
2048
2049             if ( OP(noper) != NOTHING ) {
2050                 for ( ; uc < e ; uc += len ) {
2051
2052                     TRIE_READ_CHAR;
2053
2054                     if ( uvc < 256 ) {
2055                         charid = trie->charmap[ uvc ];
2056                     } else {
2057                         SV* const * const svpp = hv_fetch( widecharmap, (char*)&uvc, sizeof( UV ), 0);
2058                         charid = svpp ? (U16)SvIV(*svpp) : 0;
2059                     }
2060                     if ( charid ) {
2061                         charid--;
2062                         if ( !trie->trans[ state + charid ].next ) {
2063                             trie->trans[ state + charid ].next = next_alloc;
2064                             trie->trans[ state ].check++;
2065                             prev_states[TRIE_NODENUM(next_alloc)]
2066                                     = TRIE_NODENUM(state);
2067                             next_alloc += trie->uniquecharcount;
2068                         }
2069                         state = trie->trans[ state + charid ].next;
2070                     } else {
2071                         Perl_croak( aTHX_ "panic! In trie construction, no char mapping for %"IVdf, uvc );
2072                     }
2073                     /* charid is now 0 if we dont know the char read, or nonzero if we do */
2074                 }
2075             }
2076             accept_state = TRIE_NODENUM( state );
2077             TRIE_HANDLE_WORD(accept_state);
2078
2079         } /* end second pass */
2080
2081         /* and now dump it out before we compress it */
2082         DEBUG_TRIE_COMPILE_MORE_r(dump_trie_interim_table(trie, widecharmap,
2083                                                           revcharmap,
2084                                                           next_alloc, depth+1));
2085
2086         {
2087         /*
2088            * Inplace compress the table.*
2089
2090            For sparse data sets the table constructed by the trie algorithm will
2091            be mostly 0/FAIL transitions or to put it another way mostly empty.
2092            (Note that leaf nodes will not contain any transitions.)
2093
2094            This algorithm compresses the tables by eliminating most such
2095            transitions, at the cost of a modest bit of extra work during lookup:
2096
2097            - Each states[] entry contains a .base field which indicates the
2098            index in the state[] array wheres its transition data is stored.
2099
2100            - If .base is 0 there are no valid transitions from that node.
2101
2102            - If .base is nonzero then charid is added to it to find an entry in
2103            the trans array.
2104
2105            -If trans[states[state].base+charid].check!=state then the
2106            transition is taken to be a 0/Fail transition. Thus if there are fail
2107            transitions at the front of the node then the .base offset will point
2108            somewhere inside the previous nodes data (or maybe even into a node
2109            even earlier), but the .check field determines if the transition is
2110            valid.
2111
2112            XXX - wrong maybe?
2113            The following process inplace converts the table to the compressed
2114            table: We first do not compress the root node 1,and mark all its
2115            .check pointers as 1 and set its .base pointer as 1 as well. This
2116            allows us to do a DFA construction from the compressed table later,
2117            and ensures that any .base pointers we calculate later are greater
2118            than 0.
2119
2120            - We set 'pos' to indicate the first entry of the second node.
2121
2122            - We then iterate over the columns of the node, finding the first and
2123            last used entry at l and m. We then copy l..m into pos..(pos+m-l),
2124            and set the .check pointers accordingly, and advance pos
2125            appropriately and repreat for the next node. Note that when we copy
2126            the next pointers we have to convert them from the original
2127            NODEIDX form to NODENUM form as the former is not valid post
2128            compression.
2129
2130            - If a node has no transitions used we mark its base as 0 and do not
2131            advance the pos pointer.
2132
2133            - If a node only has one transition we use a second pointer into the
2134            structure to fill in allocated fail transitions from other states.
2135            This pointer is independent of the main pointer and scans forward
2136            looking for null transitions that are allocated to a state. When it
2137            finds one it writes the single transition into the "hole".  If the
2138            pointer doesnt find one the single transition is appended as normal.
2139
2140            - Once compressed we can Renew/realloc the structures to release the
2141            excess space.
2142
2143            See "Table-Compression Methods" in sec 3.9 of the Red Dragon,
2144            specifically Fig 3.47 and the associated pseudocode.
2145
2146            demq
2147         */
2148         const U32 laststate = TRIE_NODENUM( next_alloc );
2149         U32 state, charid;
2150         U32 pos = 0, zp=0;
2151         trie->statecount = laststate;
2152
2153         for ( state = 1 ; state < laststate ; state++ ) {
2154             U8 flag = 0;
2155             const U32 stateidx = TRIE_NODEIDX( state );
2156             const U32 o_used = trie->trans[ stateidx ].check;
2157             U32 used = trie->trans[ stateidx ].check;
2158             trie->trans[ stateidx ].check = 0;
2159
2160             for ( charid = 0 ; used && charid < trie->uniquecharcount ; charid++ ) {
2161                 if ( flag || trie->trans[ stateidx + charid ].next ) {
2162                     if ( trie->trans[ stateidx + charid ].next ) {
2163                         if (o_used == 1) {
2164                             for ( ; zp < pos ; zp++ ) {
2165                                 if ( ! trie->trans[ zp ].next ) {
2166                                     break;
2167                                 }
2168                             }
2169                             trie->states[ state ].trans.base = zp + trie->uniquecharcount - charid ;
2170                             trie->trans[ zp ].next = SAFE_TRIE_NODENUM( trie->trans[ stateidx + charid ].next );
2171                             trie->trans[ zp ].check = state;
2172                             if ( ++zp > pos ) pos = zp;
2173                             break;
2174                         }
2175                         used--;
2176                     }
2177                     if ( !flag ) {
2178                         flag = 1;
2179                         trie->states[ state ].trans.base = pos + trie->uniquecharcount - charid ;
2180                     }
2181                     trie->trans[ pos ].next = SAFE_TRIE_NODENUM( trie->trans[ stateidx + charid ].next );
2182                     trie->trans[ pos ].check = state;
2183                     pos++;
2184                 }
2185             }
2186         }
2187         trie->lasttrans = pos + 1;
2188         trie->states = (reg_trie_state *)
2189             PerlMemShared_realloc( trie->states, laststate
2190                                    * sizeof(reg_trie_state) );
2191         DEBUG_TRIE_COMPILE_MORE_r(
2192                 PerlIO_printf( Perl_debug_log,
2193                     "%*sAlloc: %d Orig: %"IVdf" elements, Final:%"IVdf". Savings of %%%5.2f\n",
2194                     (int)depth * 2 + 2,"",
2195                     (int)( ( TRIE_CHARCOUNT(trie) + 1 ) * trie->uniquecharcount + 1 ),
2196                     (IV)next_alloc,
2197                     (IV)pos,
2198                     ( ( next_alloc - pos ) * 100 ) / (double)next_alloc );
2199             );
2200
2201         } /* end table compress */
2202     }
2203     DEBUG_TRIE_COMPILE_MORE_r(
2204             PerlIO_printf(Perl_debug_log, "%*sStatecount:%"UVxf" Lasttrans:%"UVxf"\n",
2205                 (int)depth * 2 + 2, "",
2206                 (UV)trie->statecount,
2207                 (UV)trie->lasttrans)
2208     );
2209     /* resize the trans array to remove unused space */
2210     trie->trans = (reg_trie_trans *)
2211         PerlMemShared_realloc( trie->trans, trie->lasttrans
2212                                * sizeof(reg_trie_trans) );
2213
2214     {   /* Modify the program and insert the new TRIE node */ 
2215         U8 nodetype =(U8)(flags & 0xFF);
2216         char *str=NULL;
2217         
2218 #ifdef DEBUGGING
2219         regnode *optimize = NULL;
2220 #ifdef RE_TRACK_PATTERN_OFFSETS
2221
2222         U32 mjd_offset = 0;
2223         U32 mjd_nodelen = 0;
2224 #endif /* RE_TRACK_PATTERN_OFFSETS */
2225 #endif /* DEBUGGING */
2226         /*
2227            This means we convert either the first branch or the first Exact,
2228            depending on whether the thing following (in 'last') is a branch
2229            or not and whther first is the startbranch (ie is it a sub part of
2230            the alternation or is it the whole thing.)
2231            Assuming its a sub part we convert the EXACT otherwise we convert
2232            the whole branch sequence, including the first.
2233          */
2234         /* Find the node we are going to overwrite */
2235         if ( first != startbranch || OP( last ) == BRANCH ) {
2236             /* branch sub-chain */
2237             NEXT_OFF( first ) = (U16)(last - first);
2238 #ifdef RE_TRACK_PATTERN_OFFSETS
2239             DEBUG_r({
2240                 mjd_offset= Node_Offset((convert));
2241                 mjd_nodelen= Node_Length((convert));
2242             });
2243 #endif
2244             /* whole branch chain */
2245         }
2246 #ifdef RE_TRACK_PATTERN_OFFSETS
2247         else {
2248             DEBUG_r({
2249                 const  regnode *nop = NEXTOPER( convert );
2250                 mjd_offset= Node_Offset((nop));
2251                 mjd_nodelen= Node_Length((nop));
2252             });
2253         }
2254         DEBUG_OPTIMISE_r(
2255             PerlIO_printf(Perl_debug_log, "%*sMJD offset:%"UVuf" MJD length:%"UVuf"\n",
2256                 (int)depth * 2 + 2, "",
2257                 (UV)mjd_offset, (UV)mjd_nodelen)
2258         );
2259 #endif
2260         /* But first we check to see if there is a common prefix we can 
2261            split out as an EXACT and put in front of the TRIE node.  */
2262         trie->startstate= 1;
2263         if ( trie->bitmap && !widecharmap && !trie->jump  ) {
2264             U32 state;
2265             for ( state = 1 ; state < trie->statecount-1 ; state++ ) {
2266                 U32 ofs = 0;
2267                 I32 idx = -1;
2268                 U32 count = 0;
2269                 const U32 base = trie->states[ state ].trans.base;
2270
2271                 if ( trie->states[state].wordnum )
2272                         count = 1;
2273
2274                 for ( ofs = 0 ; ofs < trie->uniquecharcount ; ofs++ ) {
2275                     if ( ( base + ofs >= trie->uniquecharcount ) &&
2276                          ( base + ofs - trie->uniquecharcount < trie->lasttrans ) &&
2277                          trie->trans[ base + ofs - trie->uniquecharcount ].check == state )
2278                     {
2279                         if ( ++count > 1 ) {
2280                             SV **tmp = av_fetch( revcharmap, ofs, 0);
2281                             const U8 *ch = (U8*)SvPV_nolen_const( *tmp );
2282                             if ( state == 1 ) break;
2283                             if ( count == 2 ) {
2284                                 Zero(trie->bitmap, ANYOF_BITMAP_SIZE, char);
2285                                 DEBUG_OPTIMISE_r(
2286                                     PerlIO_printf(Perl_debug_log,
2287                                         "%*sNew Start State=%"UVuf" Class: [",
2288                                         (int)depth * 2 + 2, "",
2289                                         (UV)state));
2290                                 if (idx >= 0) {
2291                                     SV ** const tmp = av_fetch( revcharmap, idx, 0);
2292                                     const U8 * const ch = (U8*)SvPV_nolen_const( *tmp );
2293
2294                                     TRIE_BITMAP_SET(trie,*ch);
2295                                     if ( folder )
2296                                         TRIE_BITMAP_SET(trie, folder[ *ch ]);
2297                                     DEBUG_OPTIMISE_r(
2298                                         PerlIO_printf(Perl_debug_log, "%s", (char*)ch)
2299                                     );
2300                                 }
2301                             }
2302                             TRIE_BITMAP_SET(trie,*ch);
2303                             if ( folder )
2304                                 TRIE_BITMAP_SET(trie,folder[ *ch ]);
2305                             DEBUG_OPTIMISE_r(PerlIO_printf( Perl_debug_log,"%s", ch));
2306                         }
2307                         idx = ofs;
2308                     }
2309                 }
2310                 if ( count == 1 ) {
2311                     SV **tmp = av_fetch( revcharmap, idx, 0);
2312                     STRLEN len;
2313                     char *ch = SvPV( *tmp, len );
2314                     DEBUG_OPTIMISE_r({
2315                         SV *sv=sv_newmortal();
2316                         PerlIO_printf( Perl_debug_log,
2317                             "%*sPrefix State: %"UVuf" Idx:%"UVuf" Char='%s'\n",
2318                             (int)depth * 2 + 2, "",
2319                             (UV)state, (UV)idx, 
2320                             pv_pretty(sv, SvPV_nolen_const(*tmp), SvCUR(*tmp), 6, 
2321                                 PL_colors[0], PL_colors[1],
2322                                 (SvUTF8(*tmp) ? PERL_PV_ESCAPE_UNI : 0) |
2323                                 PERL_PV_ESCAPE_FIRSTCHAR 
2324                             )
2325                         );
2326                     });
2327                     if ( state==1 ) {
2328                         OP( convert ) = nodetype;
2329                         str=STRING(convert);
2330                         STR_LEN(convert)=0;
2331                     }
2332                     STR_LEN(convert) += len;
2333                     while (len--)
2334                         *str++ = *ch++;
2335                 } else {
2336 #ifdef DEBUGGING            
2337                     if (state>1)
2338                         DEBUG_OPTIMISE_r(PerlIO_printf( Perl_debug_log,"]\n"));
2339 #endif
2340                     break;
2341                 }
2342             }
2343             trie->prefixlen = (state-1);
2344             if (str) {
2345                 regnode *n = convert+NODE_SZ_STR(convert);
2346                 NEXT_OFF(convert) = NODE_SZ_STR(convert);
2347                 trie->startstate = state;
2348                 trie->minlen -= (state - 1);
2349                 trie->maxlen -= (state - 1);
2350 #ifdef DEBUGGING
2351                /* At least the UNICOS C compiler choked on this
2352                 * being argument to DEBUG_r(), so let's just have
2353                 * it right here. */
2354                if (
2355 #ifdef PERL_EXT_RE_BUILD
2356                    1
2357 #else
2358                    DEBUG_r_TEST
2359 #endif
2360                    ) {
2361                    regnode *fix = convert;
2362                    U32 word = trie->wordcount;
2363                    mjd_nodelen++;
2364                    Set_Node_Offset_Length(convert, mjd_offset, state - 1);
2365                    while( ++fix < n ) {
2366                        Set_Node_Offset_Length(fix, 0, 0);
2367                    }
2368                    while (word--) {
2369                        SV ** const tmp = av_fetch( trie_words, word, 0 );
2370                        if (tmp) {
2371                            if ( STR_LEN(convert) <= SvCUR(*tmp) )
2372                                sv_chop(*tmp, SvPV_nolen(*tmp) + STR_LEN(convert));
2373                            else
2374                                sv_chop(*tmp, SvPV_nolen(*tmp) + SvCUR(*tmp));
2375                        }
2376                    }
2377                }
2378 #endif
2379                 if (trie->maxlen) {
2380                     convert = n;
2381                 } else {
2382                     NEXT_OFF(convert) = (U16)(tail - convert);
2383                     DEBUG_r(optimize= n);
2384                 }
2385             }
2386         }
2387         if (!jumper) 
2388             jumper = last; 
2389         if ( trie->maxlen ) {
2390             NEXT_OFF( convert ) = (U16)(tail - convert);
2391             ARG_SET( convert, data_slot );
2392             /* Store the offset to the first unabsorbed branch in 
2393                jump[0], which is otherwise unused by the jump logic. 
2394                We use this when dumping a trie and during optimisation. */
2395             if (trie->jump) 
2396                 trie->jump[0] = (U16)(nextbranch - convert);
2397             
2398             /* If the start state is not accepting (meaning there is no empty string/NOTHING)
2399              *   and there is a bitmap
2400              *   and the first "jump target" node we found leaves enough room
2401              * then convert the TRIE node into a TRIEC node, with the bitmap
2402              * embedded inline in the opcode - this is hypothetically faster.
2403              */
2404             if ( !trie->states[trie->startstate].wordnum
2405                  && trie->bitmap
2406                  && ( (char *)jumper - (char *)convert) >= (int)sizeof(struct regnode_charclass) )
2407             {
2408                 OP( convert ) = TRIEC;
2409                 Copy(trie->bitmap, ((struct regnode_charclass *)convert)->bitmap, ANYOF_BITMAP_SIZE, char);
2410                 PerlMemShared_free(trie->bitmap);
2411                 trie->bitmap= NULL;
2412             } else 
2413                 OP( convert ) = TRIE;
2414
2415             /* store the type in the flags */
2416             convert->flags = nodetype;
2417             DEBUG_r({
2418             optimize = convert 
2419                       + NODE_STEP_REGNODE 
2420                       + regarglen[ OP( convert ) ];
2421             });
2422             /* XXX We really should free up the resource in trie now, 
2423                    as we won't use them - (which resources?) dmq */
2424         }
2425         /* needed for dumping*/
2426         DEBUG_r(if (optimize) {
2427             regnode *opt = convert;
2428
2429             while ( ++opt < optimize) {
2430                 Set_Node_Offset_Length(opt,0,0);
2431             }
2432             /* 
2433                 Try to clean up some of the debris left after the 
2434                 optimisation.
2435              */
2436             while( optimize < jumper ) {
2437                 mjd_nodelen += Node_Length((optimize));
2438                 OP( optimize ) = OPTIMIZED;
2439                 Set_Node_Offset_Length(optimize,0,0);
2440                 optimize++;
2441             }
2442             Set_Node_Offset_Length(convert,mjd_offset,mjd_nodelen);
2443         });
2444     } /* end node insert */
2445
2446     /*  Finish populating the prev field of the wordinfo array.  Walk back
2447      *  from each accept state until we find another accept state, and if
2448      *  so, point the first word's .prev field at the second word. If the
2449      *  second already has a .prev field set, stop now. This will be the
2450      *  case either if we've already processed that word's accept state,
2451      *  or that state had multiple words, and the overspill words were
2452      *  already linked up earlier.
2453      */
2454     {
2455         U16 word;
2456         U32 state;
2457         U16 prev;
2458
2459         for (word=1; word <= trie->wordcount; word++) {
2460             prev = 0;
2461             if (trie->wordinfo[word].prev)
2462                 continue;
2463             state = trie->wordinfo[word].accept;
2464             while (state) {
2465                 state = prev_states[state];
2466                 if (!state)
2467                     break;
2468                 prev = trie->states[state].wordnum;
2469                 if (prev)
2470                     break;
2471             }
2472             trie->wordinfo[word].prev = prev;
2473         }
2474         Safefree(prev_states);
2475     }
2476
2477
2478     /* and now dump out the compressed format */
2479     DEBUG_TRIE_COMPILE_r(dump_trie(trie, widecharmap, revcharmap, depth+1));
2480
2481     RExC_rxi->data->data[ data_slot + 1 ] = (void*)widecharmap;
2482 #ifdef DEBUGGING
2483     RExC_rxi->data->data[ data_slot + TRIE_WORDS_OFFSET ] = (void*)trie_words;
2484     RExC_rxi->data->data[ data_slot + 3 ] = (void*)revcharmap;
2485 #else
2486     SvREFCNT_dec_NN(revcharmap);
2487 #endif
2488     return trie->jump 
2489            ? MADE_JUMP_TRIE 
2490            : trie->startstate>1 
2491              ? MADE_EXACT_TRIE 
2492              : MADE_TRIE;
2493 }
2494
2495 STATIC void
2496 S_make_trie_failtable(pTHX_ RExC_state_t *pRExC_state, regnode *source,  regnode *stclass, U32 depth)
2497 {
2498 /* The Trie is constructed and compressed now so we can build a fail array if it's needed
2499
2500    This is basically the Aho-Corasick algorithm. Its from exercise 3.31 and 3.32 in the
2501    "Red Dragon" -- Compilers, principles, techniques, and tools. Aho, Sethi, Ullman 1985/88
2502    ISBN 0-201-10088-6
2503
2504    We find the fail state for each state in the trie, this state is the longest proper
2505    suffix of the current state's 'word' that is also a proper prefix of another word in our
2506    trie. State 1 represents the word '' and is thus the default fail state. This allows
2507    the DFA not to have to restart after its tried and failed a word at a given point, it
2508    simply continues as though it had been matching the other word in the first place.
2509    Consider
2510       'abcdgu'=~/abcdefg|cdgu/
2511    When we get to 'd' we are still matching the first word, we would encounter 'g' which would
2512    fail, which would bring us to the state representing 'd' in the second word where we would
2513    try 'g' and succeed, proceeding to match 'cdgu'.
2514  */
2515  /* add a fail transition */
2516     const U32 trie_offset = ARG(source);
2517     reg_trie_data *trie=(reg_trie_data *)RExC_rxi->data->data[trie_offset];
2518     U32 *q;
2519     const U32 ucharcount = trie->uniquecharcount;
2520     const U32 numstates = trie->statecount;
2521     const U32 ubound = trie->lasttrans + ucharcount;
2522     U32 q_read = 0;
2523     U32 q_write = 0;
2524     U32 charid;
2525     U32 base = trie->states[ 1 ].trans.base;
2526     U32 *fail;
2527     reg_ac_data *aho;
2528     const U32 data_slot = add_data( pRExC_state, 1, "T" );
2529     GET_RE_DEBUG_FLAGS_DECL;
2530
2531     PERL_ARGS_ASSERT_MAKE_TRIE_FAILTABLE;
2532 #ifndef DEBUGGING
2533     PERL_UNUSED_ARG(depth);
2534 #endif
2535
2536
2537     ARG_SET( stclass, data_slot );
2538     aho = (reg_ac_data *) PerlMemShared_calloc( 1, sizeof(reg_ac_data) );
2539     RExC_rxi->data->data[ data_slot ] = (void*)aho;
2540     aho->trie=trie_offset;
2541     aho->states=(reg_trie_state *)PerlMemShared_malloc( numstates * sizeof(reg_trie_state) );
2542     Copy( trie->states, aho->states, numstates, reg_trie_state );
2543     Newxz( q, numstates, U32);
2544     aho->fail = (U32 *) PerlMemShared_calloc( numstates, sizeof(U32) );
2545     aho->refcount = 1;
2546     fail = aho->fail;
2547     /* initialize fail[0..1] to be 1 so that we always have
2548        a valid final fail state */
2549     fail[ 0 ] = fail[ 1 ] = 1;
2550
2551     for ( charid = 0; charid < ucharcount ; charid++ ) {
2552         const U32 newstate = TRIE_TRANS_STATE( 1, base, ucharcount, charid, 0 );
2553         if ( newstate ) {
2554             q[ q_write ] = newstate;
2555             /* set to point at the root */
2556             fail[ q[ q_write++ ] ]=1;
2557         }
2558     }
2559     while ( q_read < q_write) {
2560         const U32 cur = q[ q_read++ % numstates ];
2561         base = trie->states[ cur ].trans.base;
2562
2563         for ( charid = 0 ; charid < ucharcount ; charid++ ) {
2564             const U32 ch_state = TRIE_TRANS_STATE( cur, base, ucharcount, charid, 1 );
2565             if (ch_state) {
2566                 U32 fail_state = cur;
2567                 U32 fail_base;
2568                 do {
2569                     fail_state = fail[ fail_state ];
2570                     fail_base = aho->states[ fail_state ].trans.base;
2571                 } while ( !TRIE_TRANS_STATE( fail_state, fail_base, ucharcount, charid, 1 ) );
2572
2573                 fail_state = TRIE_TRANS_STATE( fail_state, fail_base, ucharcount, charid, 1 );
2574                 fail[ ch_state ] = fail_state;
2575                 if ( !aho->states[ ch_state ].wordnum && aho->states[ fail_state ].wordnum )
2576                 {
2577                         aho->states[ ch_state ].wordnum =  aho->states[ fail_state ].wordnum;
2578                 }
2579                 q[ q_write++ % numstates] = ch_state;
2580             }
2581         }
2582     }
2583     /* restore fail[0..1] to 0 so that we "fall out" of the AC loop
2584        when we fail in state 1, this allows us to use the
2585        charclass scan to find a valid start char. This is based on the principle
2586        that theres a good chance the string being searched contains lots of stuff
2587        that cant be a start char.
2588      */
2589     fail[ 0 ] = fail[ 1 ] = 0;
2590     DEBUG_TRIE_COMPILE_r({
2591         PerlIO_printf(Perl_debug_log,
2592                       "%*sStclass Failtable (%"UVuf" states): 0", 
2593                       (int)(depth * 2), "", (UV)numstates
2594         );
2595         for( q_read=1; q_read<numstates; q_read++ ) {
2596             PerlIO_printf(Perl_debug_log, ", %"UVuf, (UV)fail[q_read]);
2597         }
2598         PerlIO_printf(Perl_debug_log, "\n");
2599     });
2600     Safefree(q);
2601     /*RExC_seen |= REG_SEEN_TRIEDFA;*/
2602 }
2603
2604
2605 /*
2606  * There are strange code-generation bugs caused on sparc64 by gcc-2.95.2.
2607  * These need to be revisited when a newer toolchain becomes available.
2608  */
2609 #if defined(__sparc64__) && defined(__GNUC__)
2610 #   if __GNUC__ < 2 || (__GNUC__ == 2 && __GNUC_MINOR__ < 96)
2611 #       undef  SPARC64_GCC_WORKAROUND
2612 #       define SPARC64_GCC_WORKAROUND 1
2613 #   endif
2614 #endif
2615
2616 #define DEBUG_PEEP(str,scan,depth) \
2617     DEBUG_OPTIMISE_r({if (scan){ \
2618        SV * const mysv=sv_newmortal(); \
2619        regnode *Next = regnext(scan); \
2620        regprop(RExC_rx, mysv, scan); \
2621        PerlIO_printf(Perl_debug_log, "%*s" str ">%3d: %s (%d)\n", \
2622        (int)depth*2, "", REG_NODE_NUM(scan), SvPV_nolen_const(mysv),\
2623        Next ? (REG_NODE_NUM(Next)) : 0 ); \
2624    }});
2625
2626
2627 /* The below joins as many adjacent EXACTish nodes as possible into a single
2628  * one.  The regop may be changed if the node(s) contain certain sequences that
2629  * require special handling.  The joining is only done if:
2630  * 1) there is room in the current conglomerated node to entirely contain the
2631  *    next one.
2632  * 2) they are the exact same node type
2633  *
2634  * The adjacent nodes actually may be separated by NOTHING-kind nodes, and
2635  * these get optimized out
2636  *
2637  * If a node is to match under /i (folded), the number of characters it matches
2638  * can be different than its character length if it contains a multi-character
2639  * fold.  *min_subtract is set to the total delta of the input nodes.
2640  *
2641  * And *has_exactf_sharp_s is set to indicate whether or not the node is EXACTF
2642  * and contains LATIN SMALL LETTER SHARP S
2643  *
2644  * This is as good a place as any to discuss the design of handling these
2645  * multi-character fold sequences.  It's been wrong in Perl for a very long
2646  * time.  There are three code points in Unicode whose multi-character folds
2647  * were long ago discovered to mess things up.  The previous designs for
2648  * dealing with these involved assigning a special node for them.  This
2649  * approach doesn't work, as evidenced by this example:
2650  *      "\xDFs" =~ /s\xDF/ui    # Used to fail before these patches
2651  * Both these fold to "sss", but if the pattern is parsed to create a node that
2652  * would match just the \xDF, it won't be able to handle the case where a
2653  * successful match would have to cross the node's boundary.  The new approach
2654  * that hopefully generally solves the problem generates an EXACTFU_SS node
2655  * that is "sss".
2656  *
2657  * It turns out that there are problems with all multi-character folds, and not
2658  * just these three.  Now the code is general, for all such cases, but the
2659  * three still have some special handling.  The approach taken is:
2660  * 1)   This routine examines each EXACTFish node that could contain multi-
2661  *      character fold sequences.  It returns in *min_subtract how much to
2662  *      subtract from the the actual length of the string to get a real minimum
2663  *      match length; it is 0 if there are no multi-char folds.  This delta is
2664  *      used by the caller to adjust the min length of the match, and the delta
2665  *      between min and max, so that the optimizer doesn't reject these
2666  *      possibilities based on size constraints.
2667  * 2)   Certain of these sequences require special handling by the trie code,
2668  *      so, if found, this code changes the joined node type to special ops:
2669  *      EXACTFU_TRICKYFOLD and EXACTFU_SS.
2670  * 3)   For the sequence involving the Sharp s (\xDF), the node type EXACTFU_SS
2671  *      is used for an EXACTFU node that contains at least one "ss" sequence in
2672  *      it.  For non-UTF-8 patterns and strings, this is the only case where
2673  *      there is a possible fold length change.  That means that a regular
2674  *      EXACTFU node without UTF-8 involvement doesn't have to concern itself
2675  *      with length changes, and so can be processed faster.  regexec.c takes
2676  *      advantage of this.  Generally, an EXACTFish node that is in UTF-8 is
2677  *      pre-folded by regcomp.c.  This saves effort in regex matching.
2678  *      However, the pre-folding isn't done for non-UTF8 patterns because the
2679  *      fold of the MICRO SIGN requires UTF-8, and we don't want to slow things
2680  *      down by forcing the pattern into UTF8 unless necessary.  Also what
2681  *      EXACTF and EXACTFL nodes fold to isn't known until runtime.  The fold
2682  *      possibilities for the non-UTF8 patterns are quite simple, except for
2683  *      the sharp s.  All the ones that don't involve a UTF-8 target string are
2684  *      members of a fold-pair, and arrays are set up for all of them so that
2685  *      the other member of the pair can be found quickly.  Code elsewhere in
2686  *      this file makes sure that in EXACTFU nodes, the sharp s gets folded to
2687  *      'ss', even if the pattern isn't UTF-8.  This avoids the issues
2688  *      described in the next item.
2689  * 4)   A problem remains for the sharp s in EXACTF and EXACTFA nodes when the
2690  *      pattern isn't in UTF-8. (BTW, there cannot be an EXACTF node with a
2691  *      UTF-8 pattern.)  An assumption that the optimizer part of regexec.c
2692  *      (probably unwittingly, in Perl_regexec_flags()) makes is that a
2693  *      character in the pattern corresponds to at most a single character in
2694  *      the target string.  (And I do mean character, and not byte here, unlike
2695  *      other parts of the documentation that have never been updated to
2696  *      account for multibyte Unicode.)  sharp s in EXACTF nodes can match the
2697  *      two character string 'ss'; in EXACTFA nodes it can match
2698  *      "\x{17F}\x{17F}".  These violate the assumption, and they are the only
2699  *      instances where it is violated.  I'm reluctant to try to change the
2700  *      assumption, as the code involved is impenetrable to me (khw), so
2701  *      instead the code here punts.  This routine examines (when the pattern
2702  *      isn't UTF-8) EXACTF and EXACTFA nodes for the sharp s, and returns a
2703  *      boolean indicating whether or not the node contains a sharp s.  When it
2704  *      is true, the caller sets a flag that later causes the optimizer in this
2705  *      file to not set values for the floating and fixed string lengths, and
2706  *      thus avoids the optimizer code in regexec.c that makes the invalid
2707  *      assumption.  Thus, there is no optimization based on string lengths for
2708  *      non-UTF8-pattern EXACTF and EXACTFA nodes that contain the sharp s.
2709  *      (The reason the assumption is wrong only in these two cases is that all
2710  *      other non-UTF-8 folds are 1-1; and, for UTF-8 patterns, we pre-fold all
2711  *      other folds to their expanded versions.  We can't prefold sharp s to
2712  *      'ss' in EXACTF nodes because we don't know at compile time if it
2713  *      actually matches 'ss' or not.  It will match iff the target string is
2714  *      in UTF-8, unlike the EXACTFU nodes, where it always matches; and
2715  *      EXACTFA and EXACTFL where it never does.  In an EXACTFA node in a UTF-8
2716  *      pattern, sharp s is folded to "\x{17F}\x{17F}, avoiding the problem;
2717  *      but in a non-UTF8 pattern, folding it to that above-Latin1 string would
2718  *      require the pattern to be forced into UTF-8, the overhead of which we
2719  *      want to avoid.)
2720  */
2721
2722 #define JOIN_EXACT(scan,min_subtract,has_exactf_sharp_s, flags) \
2723     if (PL_regkind[OP(scan)] == EXACT) \
2724         join_exact(pRExC_state,(scan),(min_subtract),has_exactf_sharp_s, (flags),NULL,depth+1)
2725
2726 STATIC U32
2727 S_join_exact(pTHX_ RExC_state_t *pRExC_state, regnode *scan, UV *min_subtract, bool *has_exactf_sharp_s, U32 flags,regnode *val, U32 depth) {
2728     /* Merge several consecutive EXACTish nodes into one. */
2729     regnode *n = regnext(scan);
2730     U32 stringok = 1;
2731     regnode *next = scan + NODE_SZ_STR(scan);
2732     U32 merged = 0;
2733     U32 stopnow = 0;
2734 #ifdef DEBUGGING
2735     regnode *stop = scan;
2736     GET_RE_DEBUG_FLAGS_DECL;
2737 #else
2738     PERL_UNUSED_ARG(depth);
2739 #endif
2740
2741     PERL_ARGS_ASSERT_JOIN_EXACT;
2742 #ifndef EXPERIMENTAL_INPLACESCAN
2743     PERL_UNUSED_ARG(flags);
2744     PERL_UNUSED_ARG(val);
2745 #endif
2746     DEBUG_PEEP("join",scan,depth);
2747
2748     /* Look through the subsequent nodes in the chain.  Skip NOTHING, merge
2749      * EXACT ones that are mergeable to the current one. */
2750     while (n
2751            && (PL_regkind[OP(n)] == NOTHING
2752                || (stringok && OP(n) == OP(scan)))
2753            && NEXT_OFF(n)
2754            && NEXT_OFF(scan) + NEXT_OFF(n) < I16_MAX)
2755     {
2756         
2757         if (OP(n) == TAIL || n > next)
2758             stringok = 0;
2759         if (PL_regkind[OP(n)] == NOTHING) {
2760             DEBUG_PEEP("skip:",n,depth);
2761             NEXT_OFF(scan) += NEXT_OFF(n);
2762             next = n + NODE_STEP_REGNODE;
2763 #ifdef DEBUGGING
2764             if (stringok)
2765                 stop = n;
2766 #endif
2767             n = regnext(n);
2768         }
2769         else if (stringok) {
2770             const unsigned int oldl = STR_LEN(scan);
2771             regnode * const nnext = regnext(n);
2772
2773             /* XXX I (khw) kind of doubt that this works on platforms where
2774              * U8_MAX is above 255 because of lots of other assumptions */
2775             /* Don't join if the sum can't fit into a single node */
2776             if (oldl + STR_LEN(n) > U8_MAX)
2777                 break;
2778             
2779             DEBUG_PEEP("merg",n,depth);
2780             merged++;
2781
2782             NEXT_OFF(scan) += NEXT_OFF(n);
2783             STR_LEN(scan) += STR_LEN(n);
2784             next = n + NODE_SZ_STR(n);
2785             /* Now we can overwrite *n : */
2786             Move(STRING(n), STRING(scan) + oldl, STR_LEN(n), char);
2787 #ifdef DEBUGGING
2788             stop = next - 1;
2789 #endif
2790             n = nnext;
2791             if (stopnow) break;
2792         }
2793
2794 #ifdef EXPERIMENTAL_INPLACESCAN
2795         if (flags && !NEXT_OFF(n)) {
2796             DEBUG_PEEP("atch", val, depth);
2797             if (reg_off_by_arg[OP(n)]) {
2798                 ARG_SET(n, val - n);
2799             }
2800             else {
2801                 NEXT_OFF(n) = val - n;
2802             }
2803             stopnow = 1;
2804         }
2805 #endif
2806     }
2807
2808     *min_subtract = 0;
2809     *has_exactf_sharp_s = FALSE;
2810
2811     /* Here, all the adjacent mergeable EXACTish nodes have been merged.  We
2812      * can now analyze for sequences of problematic code points.  (Prior to
2813      * this final joining, sequences could have been split over boundaries, and
2814      * hence missed).  The sequences only happen in folding, hence for any
2815      * non-EXACT EXACTish node */
2816     if (OP(scan) != EXACT) {
2817         const U8 * const s0 = (U8*) STRING(scan);
2818         const U8 * s = s0;
2819         const U8 * const s_end = s0 + STR_LEN(scan);
2820
2821         /* One pass is made over the node's string looking for all the
2822          * possibilities.  to avoid some tests in the loop, there are two main
2823          * cases, for UTF-8 patterns (which can't have EXACTF nodes) and
2824          * non-UTF-8 */
2825         if (UTF) {
2826
2827             /* Examine the string for a multi-character fold sequence.  UTF-8
2828              * patterns have all characters pre-folded by the time this code is
2829              * executed */
2830             while (s < s_end - 1) /* Can stop 1 before the end, as minimum
2831                                      length sequence we are looking for is 2 */
2832             {
2833                 int count = 0;
2834                 int len = is_MULTI_CHAR_FOLD_utf8_safe(s, s_end);
2835                 if (! len) {    /* Not a multi-char fold: get next char */
2836                     s += UTF8SKIP(s);
2837                     continue;
2838                 }
2839
2840                 /* Nodes with 'ss' require special handling, except for EXACTFL
2841                  * and EXACTFA for which there is no multi-char fold to this */
2842                 if (len == 2 && *s == 's' && *(s+1) == 's'
2843                     && OP(scan) != EXACTFL && OP(scan) != EXACTFA)
2844                 {
2845                     count = 2;
2846                     OP(scan) = EXACTFU_SS;
2847                     s += 2;
2848                 }
2849                 else if (len == 6   /* len is the same in both ASCII and EBCDIC
2850                                        for these */
2851                          && (memEQ(s, GREEK_SMALL_LETTER_IOTA_UTF8
2852                                       COMBINING_DIAERESIS_UTF8
2853                                       COMBINING_ACUTE_ACCENT_UTF8,
2854                                    6)
2855                              || memEQ(s, GREEK_SMALL_LETTER_UPSILON_UTF8
2856                                          COMBINING_DIAERESIS_UTF8
2857                                          COMBINING_ACUTE_ACCENT_UTF8,
2858                                      6)))
2859                 {
2860                     count = 3;
2861
2862                     /* These two folds require special handling by trie's, so
2863                      * change the node type to indicate this.  If EXACTFA and
2864                      * EXACTFL were ever to be handled by trie's, this would
2865                      * have to be changed.  If this node has already been
2866                      * changed to EXACTFU_SS in this loop, leave it as is.  (I
2867                      * (khw) think it doesn't matter in regexec.c for UTF
2868                      * patterns, but no need to change it */
2869                     if (OP(scan) == EXACTFU) {
2870                         OP(scan) = EXACTFU_TRICKYFOLD;
2871                     }
2872                     s += 6;
2873                 }
2874                 else { /* Here is a generic multi-char fold. */
2875                     const U8* multi_end  = s + len;
2876
2877                     /* Count how many characters in it.  In the case of /l and
2878                      * /aa, no folds which contain ASCII code points are
2879                      * allowed, so check for those, and skip if found.  (In
2880                      * EXACTFL, no folds are allowed to any Latin1 code point,
2881                      * not just ASCII.  But there aren't any of these
2882                      * currently, nor ever likely, so don't take the time to
2883                      * test for them.  The code that generates the
2884                      * is_MULTI_foo() macros croaks should one actually get put
2885                      * into Unicode .) */
2886                     if (OP(scan) != EXACTFL && OP(scan) != EXACTFA) {
2887                         count = utf8_length(s, multi_end);
2888                         s = multi_end;
2889                     }
2890                     else {
2891                         while (s < multi_end) {
2892                             if (isASCII(*s)) {
2893                                 s++;
2894                                 goto next_iteration;
2895                             }
2896                             else {
2897                                 s += UTF8SKIP(s);
2898                             }
2899                             count++;
2900                         }
2901                     }
2902                 }
2903
2904                 /* The delta is how long the sequence is minus 1 (1 is how long
2905                  * the character that folds to the sequence is) */
2906                 *min_subtract += count - 1;
2907             next_iteration: ;
2908             }
2909         }
2910         else if (OP(scan) == EXACTFA) {
2911
2912             /* Non-UTF-8 pattern, EXACTFA node.  There can't be a multi-char
2913              * fold to the ASCII range (and there are no existing ones in the
2914              * upper latin1 range).  But, as outlined in the comments preceding
2915              * this function, we need to flag any occurrences of the sharp s */
2916             while (s < s_end) {
2917                 if (*s == LATIN_SMALL_LETTER_SHARP_S) {
2918                     *has_exactf_sharp_s = TRUE;
2919                     break;
2920                 }
2921                 s++;
2922                 continue;
2923             }
2924         }
2925         else if (OP(scan) != EXACTFL) {
2926
2927             /* Non-UTF-8 pattern, not EXACTFA nor EXACTFL node.  Look for the
2928              * multi-char folds that are all Latin1.  (This code knows that
2929              * there are no current multi-char folds possible with EXACTFL,
2930              * relying on fold_grind.t to catch any errors if the very unlikely
2931              * event happens that some get added in future Unicode versions.)
2932              * As explained in the comments preceding this function, we look
2933              * also for the sharp s in EXACTF nodes; it can be in the final
2934              * position.  Otherwise we can stop looking 1 byte earlier because
2935              * have to find at least two characters for a multi-fold */
2936             const U8* upper = (OP(scan) == EXACTF) ? s_end : s_end -1;
2937
2938             /* The below is perhaps overboard, but this allows us to save a
2939              * test each time through the loop at the expense of a mask.  This
2940              * is because on both EBCDIC and ASCII machines, 'S' and 's' differ
2941              * by a single bit.  On ASCII they are 32 apart; on EBCDIC, they
2942              * are 64.  This uses an exclusive 'or' to find that bit and then
2943              * inverts it to form a mask, with just a single 0, in the bit
2944              * position where 'S' and 's' differ. */
2945             const U8 S_or_s_mask = (U8) ~ ('S' ^ 's');
2946             const U8 s_masked = 's' & S_or_s_mask;
2947
2948             while (s < upper) {
2949                 int len = is_MULTI_CHAR_FOLD_latin1_safe(s, s_end);
2950                 if (! len) {    /* Not a multi-char fold. */
2951                     if (*s == LATIN_SMALL_LETTER_SHARP_S && OP(scan) == EXACTF)
2952                     {
2953                         *has_exactf_sharp_s = TRUE;
2954                     }
2955                     s++;
2956                     continue;
2957                 }
2958
2959                 if (len == 2
2960                     && ((*s & S_or_s_mask) == s_masked)
2961                     && ((*(s+1) & S_or_s_mask) == s_masked))
2962                 {
2963
2964                     /* EXACTF nodes need to know that the minimum length
2965                      * changed so that a sharp s in the string can match this
2966                      * ss in the pattern, but they remain EXACTF nodes, as they
2967                      * won't match this unless the target string is is UTF-8,
2968                      * which we don't know until runtime */
2969                     if (OP(scan) != EXACTF) {
2970                         OP(scan) = EXACTFU_SS;
2971                     }
2972                 }
2973
2974                 *min_subtract += len - 1;
2975                 s += len;
2976             }
2977         }
2978     }
2979
2980 #ifdef DEBUGGING
2981     /* Allow dumping but overwriting the collection of skipped
2982      * ops and/or strings with fake optimized ops */
2983     n = scan + NODE_SZ_STR(scan);
2984     while (n <= stop) {
2985         OP(n) = OPTIMIZED;
2986         FLAGS(n) = 0;
2987         NEXT_OFF(n) = 0;
2988         n++;
2989     }
2990 #endif
2991     DEBUG_OPTIMISE_r(if (merged){DEBUG_PEEP("finl",scan,depth)});
2992     return stopnow;
2993 }
2994
2995 /* REx optimizer.  Converts nodes into quicker variants "in place".
2996    Finds fixed substrings.  */
2997
2998 /* Stops at toplevel WHILEM as well as at "last". At end *scanp is set
2999    to the position after last scanned or to NULL. */
3000
3001 #define INIT_AND_WITHP \
3002     assert(!and_withp); \
3003     Newx(and_withp,1,struct regnode_charclass_class); \
3004     SAVEFREEPV(and_withp)
3005
3006 /* this is a chain of data about sub patterns we are processing that
3007    need to be handled separately/specially in study_chunk. Its so
3008    we can simulate recursion without losing state.  */
3009 struct scan_frame;
3010 typedef struct scan_frame {
3011     regnode *last;  /* last node to process in this frame */
3012     regnode *next;  /* next node to process when last is reached */
3013     struct scan_frame *prev; /*previous frame*/
3014     I32 stop; /* what stopparen do we use */
3015 } scan_frame;
3016
3017
3018 #define SCAN_COMMIT(s, data, m) scan_commit(s, data, m, is_inf)
3019
3020 STATIC I32
3021 S_study_chunk(pTHX_ RExC_state_t *pRExC_state, regnode **scanp,
3022                         I32 *minlenp, I32 *deltap,
3023                         regnode *last,
3024                         scan_data_t *data,
3025                         I32 stopparen,
3026                         U8* recursed,
3027                         struct regnode_charclass_class *and_withp,
3028                         U32 flags, U32 depth)
3029                         /* scanp: Start here (read-write). */
3030                         /* deltap: Write maxlen-minlen here. */
3031                         /* last: Stop before this one. */
3032                         /* data: string data about the pattern */
3033                         /* stopparen: treat close N as END */
3034                         /* recursed: which subroutines have we recursed into */
3035                         /* and_withp: Valid if flags & SCF_DO_STCLASS_OR */
3036 {
3037     dVAR;
3038     I32 min = 0;    /* There must be at least this number of characters to match */
3039     I32 pars = 0, code;
3040     regnode *scan = *scanp, *next;
3041     I32 delta = 0;
3042     int is_inf = (flags & SCF_DO_SUBSTR) && (data->flags & SF_IS_INF);
3043     int is_inf_internal = 0;            /* The studied chunk is infinite */
3044     I32 is_par = OP(scan) == OPEN ? ARG(scan) : 0;
3045     scan_data_t data_fake;
3046     SV *re_trie_maxbuff = NULL;
3047     regnode *first_non_open = scan;
3048     I32 stopmin = I32_MAX;
3049     scan_frame *frame = NULL;
3050     GET_RE_DEBUG_FLAGS_DECL;
3051
3052     PERL_ARGS_ASSERT_STUDY_CHUNK;
3053
3054 #ifdef DEBUGGING
3055     StructCopy(&zero_scan_data, &data_fake, scan_data_t);
3056 #endif
3057
3058     if ( depth == 0 ) {
3059         while (first_non_open && OP(first_non_open) == OPEN)
3060             first_non_open=regnext(first_non_open);
3061     }
3062
3063
3064   fake_study_recurse:
3065     while ( scan && OP(scan) != END && scan < last ){
3066         UV min_subtract = 0;    /* How mmany chars to subtract from the minimum
3067                                    node length to get a real minimum (because
3068                                    the folded version may be shorter) */
3069         bool has_exactf_sharp_s = FALSE;
3070         /* Peephole optimizer: */
3071         DEBUG_STUDYDATA("Peep:", data,depth);
3072         DEBUG_PEEP("Peep",scan,depth);
3073
3074         /* Its not clear to khw or hv why this is done here, and not in the
3075          * clauses that deal with EXACT nodes.  khw's guess is that it's
3076          * because of a previous design */
3077         JOIN_EXACT(scan,&min_subtract, &has_exactf_sharp_s, 0);
3078
3079         /* Follow the next-chain of the current node and optimize
3080            away all the NOTHINGs from it.  */
3081         if (OP(scan) != CURLYX) {
3082             const int max = (reg_off_by_arg[OP(scan)]
3083                        ? I32_MAX
3084                        /* I32 may be smaller than U16 on CRAYs! */
3085                        : (I32_MAX < U16_MAX ? I32_MAX : U16_MAX));
3086             int off = (reg_off_by_arg[OP(scan)] ? ARG(scan) : NEXT_OFF(scan));
3087             int noff;
3088             regnode *n = scan;
3089
3090             /* Skip NOTHING and LONGJMP. */
3091             while ((n = regnext(n))
3092                    && ((PL_regkind[OP(n)] == NOTHING && (noff = NEXT_OFF(n)))
3093                        || ((OP(n) == LONGJMP) && (noff = ARG(n))))
3094                    && off + noff < max)
3095                 off += noff;
3096             if (reg_off_by_arg[OP(scan)])
3097                 ARG(scan) = off;
3098             else
3099                 NEXT_OFF(scan) = off;
3100         }
3101
3102
3103
3104         /* The principal pseudo-switch.  Cannot be a switch, since we
3105            look into several different things.  */
3106         if (OP(scan) == BRANCH || OP(scan) == BRANCHJ
3107                    || OP(scan) == IFTHEN) {
3108             next = regnext(scan);
3109             code = OP(scan);
3110             /* demq: the op(next)==code check is to see if we have "branch-branch" AFAICT */
3111
3112             if (OP(next) == code || code == IFTHEN) {
3113                 /* NOTE - There is similar code to this block below for handling
3114                    TRIE nodes on a re-study.  If you change stuff here check there
3115                    too. */
3116                 I32 max1 = 0, min1 = I32_MAX, num = 0;
3117                 struct regnode_charclass_class accum;
3118                 regnode * const startbranch=scan;
3119
3120                 if (flags & SCF_DO_SUBSTR)
3121                     SCAN_COMMIT(pRExC_state, data, minlenp); /* Cannot merge strings after this. */
3122                 if (flags & SCF_DO_STCLASS)
3123                     cl_init_zero(pRExC_state, &accum);
3124
3125                 while (OP(scan) == code) {
3126                     I32 deltanext, minnext, f = 0, fake;
3127                     struct regnode_charclass_class this_class;
3128
3129                     num++;
3130                     data_fake.flags = 0;
3131                     if (data) {
3132                         data_fake.whilem_c = data->whilem_c;
3133                         data_fake.last_closep = data->last_closep;
3134                     }
3135                     else
3136                         data_fake.last_closep = &fake;
3137
3138                     data_fake.pos_delta = delta;
3139                     next = regnext(scan);
3140                     scan = NEXTOPER(scan);
3141                     if (code != BRANCH)
3142                         scan = NEXTOPER(scan);
3143                     if (flags & SCF_DO_STCLASS) {
3144                         cl_init(pRExC_state, &this_class);
3145                         data_fake.start_class = &this_class;
3146                         f = SCF_DO_STCLASS_AND;
3147                     }
3148                     if (flags & SCF_WHILEM_VISITED_POS)
3149                         f |= SCF_WHILEM_VISITED_POS;
3150
3151                     /* we suppose the run is continuous, last=next...*/
3152                     minnext = study_chunk(pRExC_state, &scan, minlenp, &deltanext,
3153                                           next, &data_fake,
3154                                           stopparen, recursed, NULL, f,depth+1);
3155                     if (min1 > minnext)
3156                         min1 = minnext;
3157                     if (deltanext == I32_MAX) {
3158                         is_inf = is_inf_internal = 1;
3159                         max1 = I32_MAX;
3160                     } else if (max1 < minnext + deltanext)
3161                         max1 = minnext + deltanext;
3162                     scan = next;
3163                     if (data_fake.flags & (SF_HAS_PAR|SF_IN_PAR))
3164                         pars++;
3165                     if (data_fake.flags & SCF_SEEN_ACCEPT) {
3166                         if ( stopmin > minnext) 
3167                             stopmin = min + min1;
3168                         flags &= ~SCF_DO_SUBSTR;
3169                         if (data)
3170                             data->flags |= SCF_SEEN_ACCEPT;
3171                     }
3172                     if (data) {
3173                         if (data_fake.flags & SF_HAS_EVAL)
3174                             data->flags |= SF_HAS_EVAL;
3175                         data->whilem_c = data_fake.whilem_c;
3176                     }
3177                     if (flags & SCF_DO_STCLASS)
3178                         cl_or(pRExC_state, &accum, &this_class);
3179                 }
3180                 if (code == IFTHEN && num < 2) /* Empty ELSE branch */
3181                     min1 = 0;
3182                 if (flags & SCF_DO_SUBSTR) {
3183                     data->pos_min += min1;
3184                     if (data->pos_delta >= I32_MAX - (max1 - min1))
3185                         data->pos_delta = I32_MAX;
3186                     else
3187                         data->pos_delta += max1 - min1;
3188                     if (max1 != min1 || is_inf)
3189                         data->longest = &(data->longest_float);
3190                 }
3191                 min += min1;
3192                 if (delta == I32_MAX || I32_MAX - delta - (max1 - min1) < 0)
3193                     delta = I32_MAX;
3194                 else
3195                     delta += max1 - min1;
3196                 if (flags & SCF_DO_STCLASS_OR) {
3197                     cl_or(pRExC_state, data->start_class, &accum);
3198                     if (min1) {
3199                         cl_and(data->start_class, and_withp);
3200                         flags &= ~SCF_DO_STCLASS;
3201                     }
3202                 }
3203                 else if (flags & SCF_DO_STCLASS_AND) {
3204                     if (min1) {
3205                         cl_and(data->start_class, &accum);
3206                         flags &= ~SCF_DO_STCLASS;
3207                     }
3208                     else {
3209                         /* Switch to OR mode: cache the old value of
3210                          * data->start_class */
3211                         INIT_AND_WITHP;
3212                         StructCopy(data->start_class, and_withp,
3213                                    struct regnode_charclass_class);
3214                         flags &= ~SCF_DO_STCLASS_AND;
3215                         StructCopy(&accum, data->start_class,
3216                                    struct regnode_charclass_class);
3217                         flags |= SCF_DO_STCLASS_OR;
3218                         SET_SSC_EOS(data->start_class);
3219                     }
3220                 }
3221
3222                 if (PERL_ENABLE_TRIE_OPTIMISATION && OP( startbranch ) == BRANCH ) {
3223                 /* demq.
3224
3225                    Assuming this was/is a branch we are dealing with: 'scan' now
3226                    points at the item that follows the branch sequence, whatever
3227                    it is. We now start at the beginning of the sequence and look
3228                    for subsequences of
3229
3230                    BRANCH->EXACT=>x1
3231                    BRANCH->EXACT=>x2
3232                    tail
3233
3234                    which would be constructed from a pattern like /A|LIST|OF|WORDS/
3235
3236                    If we can find such a subsequence we need to turn the first
3237                    element into a trie and then add the subsequent branch exact
3238                    strings to the trie.
3239
3240                    We have two cases
3241
3242                      1. patterns where the whole set of branches can be converted. 
3243
3244                      2. patterns where only a subset can be converted.
3245
3246                    In case 1 we can replace the whole set with a single regop
3247                    for the trie. In case 2 we need to keep the start and end
3248                    branches so
3249
3250                      'BRANCH EXACT; BRANCH EXACT; BRANCH X'
3251                      becomes BRANCH TRIE; BRANCH X;
3252
3253                   There is an additional case, that being where there is a 
3254                   common prefix, which gets split out into an EXACT like node
3255                   preceding the TRIE node.
3256
3257                   If x(1..n)==tail then we can do a simple trie, if not we make
3258                   a "jump" trie, such that when we match the appropriate word
3259                   we "jump" to the appropriate tail node. Essentially we turn
3260                   a nested if into a case structure of sorts.
3261
3262                 */
3263
3264                     int made=0;
3265                     if (!re_trie_maxbuff) {
3266                         re_trie_maxbuff = get_sv(RE_TRIE_MAXBUF_NAME, 1);
3267                         if (!SvIOK(re_trie_maxbuff))
3268                             sv_setiv(re_trie_maxbuff, RE_TRIE_MAXBUF_INIT);
3269                     }
3270                     if ( SvIV(re_trie_maxbuff)>=0  ) {
3271                         regnode *cur;
3272                         regnode *first = (regnode *)NULL;
3273                         regnode *last = (regnode *)NULL;
3274                         regnode *tail = scan;
3275                         U8 trietype = 0;
3276                         U32 count=0;
3277
3278 #ifdef DEBUGGING
3279                         SV * const mysv = sv_newmortal();       /* for dumping */
3280 #endif
3281                         /* var tail is used because there may be a TAIL
3282                            regop in the way. Ie, the exacts will point to the
3283                            thing following the TAIL, but the last branch will
3284                            point at the TAIL. So we advance tail. If we
3285                            have nested (?:) we may have to move through several
3286                            tails.
3287                          */
3288
3289                         while ( OP( tail ) == TAIL ) {
3290                             /* this is the TAIL generated by (?:) */
3291                             tail = regnext( tail );
3292                         }
3293
3294                         
3295                         DEBUG_TRIE_COMPILE_r({
3296                             regprop(RExC_rx, mysv, tail );
3297                             PerlIO_printf( Perl_debug_log, "%*s%s%s\n",
3298                                 (int)depth * 2 + 2, "", 
3299                                 "Looking for TRIE'able sequences. Tail node is: ", 
3300                                 SvPV_nolen_const( mysv )
3301                             );
3302                         });
3303                         
3304                         /*
3305
3306                             Step through the branches
3307                                 cur represents each branch,
3308                                 noper is the first thing to be matched as part of that branch
3309                                 noper_next is the regnext() of that node.
3310
3311                             We normally handle a case like this /FOO[xyz]|BAR[pqr]/
3312                             via a "jump trie" but we also support building with NOJUMPTRIE,
3313                             which restricts the trie logic to structures like /FOO|BAR/.
3314
3315                             If noper is a trieable nodetype then the branch is a possible optimization
3316                             target. If we are building under NOJUMPTRIE then we require that noper_next
3317                             is the same as scan (our current position in the regex program).
3318
3319                             Once we have two or more consecutive such branches we can create a
3320                             trie of the EXACT's contents and stitch it in place into the program.
3321
3322                             If the sequence represents all of the branches in the alternation we
3323                             replace the entire thing with a single TRIE node.
3324
3325                             Otherwise when it is a subsequence we need to stitch it in place and
3326                             replace only the relevant branches. This means the first branch has
3327                             to remain as it is used by the alternation logic, and its next pointer,
3328                             and needs to be repointed at the item on the branch chain following
3329                             the last branch we have optimized away.
3330
3331                             This could be either a BRANCH, in which case the subsequence is internal,
3332                             or it could be the item following the branch sequence in which case the
3333                             subsequence is at the end (which does not necessarily mean the first node
3334                             is the start of the alternation).
3335
3336                             TRIE_TYPE(X) is a define which maps the optype to a trietype.
3337
3338                                 optype          |  trietype
3339                                 ----------------+-----------
3340                                 NOTHING         | NOTHING
3341                                 EXACT           | EXACT
3342                                 EXACTFU         | EXACTFU
3343                                 EXACTFU_SS      | EXACTFU
3344                                 EXACTFU_TRICKYFOLD | EXACTFU
3345                                 EXACTFA         | 0
3346
3347
3348                         */
3349 #define TRIE_TYPE(X) ( ( NOTHING == (X) ) ? NOTHING :   \
3350                        ( EXACT == (X) )   ? EXACT :        \
3351                        ( EXACTFU == (X) || EXACTFU_SS == (X) || EXACTFU_TRICKYFOLD == (X) ) ? EXACTFU :        \
3352                        0 )
3353
3354                         /* dont use tail as the end marker for this traverse */
3355                         for ( cur = startbranch ; cur != scan ; cur = regnext( cur ) ) {
3356                             regnode * const noper = NEXTOPER( cur );
3357                             U8 noper_type = OP( noper );
3358                             U8 noper_trietype = TRIE_TYPE( noper_type );
3359 #if defined(DEBUGGING) || defined(NOJUMPTRIE)
3360                             regnode * const noper_next = regnext( noper );
3361                             U8 noper_next_type = (noper_next && noper_next != tail) ? OP(noper_next) : 0;
3362                             U8 noper_next_trietype = (noper_next && noper_next != tail) ? TRIE_TYPE( noper_next_type ) :0;
3363 #endif
3364
3365                             DEBUG_TRIE_COMPILE_r({
3366                                 regprop(RExC_rx, mysv, cur);
3367                                 PerlIO_printf( Perl_debug_log, "%*s- %s (%d)",
3368                                    (int)depth * 2 + 2,"", SvPV_nolen_const( mysv ), REG_NODE_NUM(cur) );
3369
3370                                 regprop(RExC_rx, mysv, noper);
3371                                 PerlIO_printf( Perl_debug_log, " -> %s",
3372                                     SvPV_nolen_const(mysv));
3373
3374                                 if ( noper_next ) {
3375                                   regprop(RExC_rx, mysv, noper_next );
3376                                   PerlIO_printf( Perl_debug_log,"\t=> %s\t",
3377                                     SvPV_nolen_const(mysv));
3378                                 }
3379                                 PerlIO_printf( Perl_debug_log, "(First==%d,Last==%d,Cur==%d,tt==%s,nt==%s,nnt==%s)\n",
3380                                    REG_NODE_NUM(first), REG_NODE_NUM(last), REG_NODE_NUM(cur),
3381                                    PL_reg_name[trietype], PL_reg_name[noper_trietype], PL_reg_name[noper_next_trietype] 
3382                                 );
3383                             });
3384
3385                             /* Is noper a trieable nodetype that can be merged with the
3386                              * current trie (if there is one)? */
3387                             if ( noper_trietype
3388                                   &&
3389                                   (
3390                                         ( noper_trietype == NOTHING)
3391                                         || ( trietype == NOTHING )
3392                                         || ( trietype == noper_trietype )
3393                                   )
3394 #ifdef NOJUMPTRIE
3395                                   && noper_next == tail
3396 #endif
3397                                   && count < U16_MAX)
3398                             {
3399                                 /* Handle mergable triable node
3400                                  * Either we are the first node in a new trieable sequence,
3401                                  * in which case we do some bookkeeping, otherwise we update
3402                                  * the end pointer. */
3403                                 if ( !first ) {
3404                                     first = cur;
3405                                     if ( noper_trietype == NOTHING ) {
3406 #if !defined(DEBUGGING) && !defined(NOJUMPTRIE)
3407                                         regnode * const noper_next = regnext( noper );
3408                                         U8 noper_next_type = (noper_next && noper_next!=tail) ? OP(noper_next) : 0;
3409                                         U8 noper_next_trietype = noper_next_type ? TRIE_TYPE( noper_next_type ) :0;
3410 #endif
3411
3412                                         if ( noper_next_trietype ) {
3413                                             trietype = noper_next_trietype;
3414                                         } else if (noper_next_type)  {
3415                                             /* a NOTHING regop is 1 regop wide. We need at least two
3416                                              * for a trie so we can't merge this in */
3417                                             first = NULL;
3418                                         }
3419                                     } else {
3420                                         trietype = noper_trietype;
3421                                     }
3422                                 } else {
3423                                     if ( trietype == NOTHING )
3424                                         trietype = noper_trietype;
3425                                     last = cur;
3426                                 }
3427                                 if (first)
3428                                     count++;
3429                             } /* end handle mergable triable node */
3430                             else {
3431                                 /* handle unmergable node -
3432                                  * noper may either be a triable node which can not be tried
3433                                  * together with the current trie, or a non triable node */
3434                                 if ( last ) {
3435                                     /* If last is set and trietype is not NOTHING then we have found
3436                                      * at least two triable branch sequences in a row of a similar
3437                                      * trietype so we can turn them into a trie. If/when we
3438                                      * allow NOTHING to start a trie sequence this condition will be
3439                                      * required, and it isn't expensive so we leave it in for now. */
3440                                     if ( trietype && trietype != NOTHING )
3441                                         make_trie( pRExC_state,
3442                                                 startbranch, first, cur, tail, count,
3443                                                 trietype, depth+1 );
3444                                     last = NULL; /* note: we clear/update first, trietype etc below, so we dont do it here */
3445                                 }
3446                                 if ( noper_trietype
3447 #ifdef NOJUMPTRIE
3448                                      && noper_next == tail
3449 #endif
3450                                 ){
3451                                     /* noper is triable, so we can start a new trie sequence */
3452                                     count = 1;
3453                                     first = cur;
3454                                     trietype = noper_trietype;
3455                                 } else if (first) {
3456                                     /* if we already saw a first but the current node is not triable then we have
3457                                      * to reset the first information. */
3458                                     count = 0;
3459                                     first = NULL;
3460                                     trietype = 0;
3461                                 }
3462                             } /* end handle unmergable node */
3463                         } /* loop over branches */
3464                         DEBUG_TRIE_COMPILE_r({
3465                             regprop(RExC_rx, mysv, cur);
3466                             PerlIO_printf( Perl_debug_log,
3467                               "%*s- %s (%d) <SCAN FINISHED>\n", (int)depth * 2 + 2,
3468                               "", SvPV_nolen_const( mysv ),REG_NODE_NUM(cur));
3469
3470                         });
3471                         if ( last && trietype ) {
3472                             if ( trietype != NOTHING ) {
3473                                 /* the last branch of the sequence was part of a trie,
3474                                  * so we have to construct it here outside of the loop
3475                                  */
3476                                 made= make_trie( pRExC_state, startbranch, first, scan, tail, count, trietype, depth+1 );
3477 #ifdef TRIE_STUDY_OPT
3478                                 if ( ((made == MADE_EXACT_TRIE &&
3479                                      startbranch == first)
3480                                      || ( first_non_open == first )) &&
3481                                      depth==0 ) {
3482                                     flags |= SCF_TRIE_RESTUDY;
3483                                     if ( startbranch == first
3484                                          && scan == tail )
3485                                     {
3486                                         RExC_seen &=~REG_TOP_LEVEL_BRANCHES;
3487                                     }
3488                                 }
3489 #endif
3490                             } else {
3491                                 /* at this point we know whatever we have is a NOTHING sequence/branch
3492                                  * AND if 'startbranch' is 'first' then we can turn the whole thing into a NOTHING
3493                                  */
3494                                 if ( startbranch == first ) {
3495                                     regnode *opt;
3496                                     /* the entire thing is a NOTHING sequence, something like this:
3497                                      * (?:|) So we can turn it into a plain NOTHING op. */
3498                                     DEBUG_TRIE_COMPILE_r({
3499                                         regprop(RExC_rx, mysv, cur);
3500                                         PerlIO_printf( Perl_debug_log,
3501                                           "%*s- %s (%d) <NOTHING BRANCH SEQUENCE>\n", (int)depth * 2 + 2,
3502                                           "", SvPV_nolen_const( mysv ),REG_NODE_NUM(cur));
3503
3504                                     });
3505                                     OP(startbranch)= NOTHING;
3506                                     NEXT_OFF(startbranch)= tail - startbranch;
3507                                     for ( opt= startbranch + 1; opt < tail ; opt++ )
3508                                         OP(opt)= OPTIMIZED;
3509                                 }
3510                             }
3511                         } /* end if ( last) */
3512                     } /* TRIE_MAXBUF is non zero */
3513                     
3514                 } /* do trie */
3515                 
3516             }
3517             else if ( code == BRANCHJ ) {  /* single branch is optimized. */
3518                 scan = NEXTOPER(NEXTOPER(scan));
3519             } else                      /* single branch is optimized. */
3520                 scan = NEXTOPER(scan);
3521             continue;
3522         } else if (OP(scan) == SUSPEND || OP(scan) == GOSUB || OP(scan) == GOSTART) {
3523             scan_frame *newframe = NULL;
3524             I32 paren;
3525             regnode *start;
3526             regnode *end;
3527
3528             if (OP(scan) != SUSPEND) {
3529             /* set the pointer */
3530                 if (OP(scan) == GOSUB) {
3531                     paren = ARG(scan);
3532                     RExC_recurse[ARG2L(scan)] = scan;
3533                     start = RExC_open_parens[paren-1];
3534                     end   = RExC_close_parens[paren-1];
3535                 } else {
3536                     paren = 0;
3537                     start = RExC_rxi->program + 1;
3538                     end   = RExC_opend;
3539                 }
3540                 if (!recursed) {
3541                     Newxz(recursed, (((RExC_npar)>>3) +1), U8);
3542                     SAVEFREEPV(recursed);
3543                 }
3544                 if (!PAREN_TEST(recursed,paren+1)) {
3545                     PAREN_SET(recursed,paren+1);
3546                     Newx(newframe,1,scan_frame);
3547                 } else {
3548                     if (flags & SCF_DO_SUBSTR) {
3549                         SCAN_COMMIT(pRExC_state,data,minlenp);
3550                         data->longest = &(data->longest_float);
3551                     }
3552                     is_inf = is_inf_internal = 1;
3553                     if (flags & SCF_DO_STCLASS_OR) /* Allow everything */
3554                         cl_anything(pRExC_state, data->start_class);
3555                     flags &= ~SCF_DO_STCLASS;
3556                 }
3557             } else {
3558                 Newx(newframe,1,scan_frame);
3559                 paren = stopparen;
3560                 start = scan+2;
3561                 end = regnext(scan);
3562             }
3563             if (newframe) {
3564                 assert(start);
3565                 assert(end);
3566                 SAVEFREEPV(newframe);
3567                 newframe->next = regnext(scan);
3568                 newframe->last = last;
3569                 newframe->stop = stopparen;
3570                 newframe->prev = frame;
3571
3572                 frame = newframe;
3573                 scan =  start;
3574                 stopparen = paren;
3575                 last = end;
3576
3577                 continue;
3578             }
3579         }
3580         else if (OP(scan) == EXACT) {
3581             I32 l = STR_LEN(scan);
3582             UV uc;
3583             if (UTF) {
3584                 const U8 * const s = (U8*)STRING(scan);
3585                 uc = utf8_to_uvchr_buf(s, s + l, NULL);
3586                 l = utf8_length(s, s + l);
3587             } else {
3588                 uc = *((U8*)STRING(scan));
3589             }
3590             min += l;
3591             if (flags & SCF_DO_SUBSTR) { /* Update longest substr. */
3592                 /* The code below prefers earlier match for fixed
3593                    offset, later match for variable offset.  */
3594                 if (data->last_end == -1) { /* Update the start info. */
3595                     data->last_start_min = data->pos_min;
3596                     data->last_start_max = is_inf
3597                         ? I32_MAX : data->pos_min + data->pos_delta;
3598                 }
3599                 sv_catpvn(data->last_found, STRING(scan), STR_LEN(scan));
3600                 if (UTF)
3601                     SvUTF8_on(data->last_found);
3602                 {
3603                     SV * const sv = data->last_found;
3604                     MAGIC * const mg = SvUTF8(sv) && SvMAGICAL(sv) ?
3605                         mg_find(sv, PERL_MAGIC_utf8) : NULL;
3606                     if (mg && mg->mg_len >= 0)
3607                         mg->mg_len += utf8_length((U8*)STRING(scan),
3608                                                   (U8*)STRING(scan)+STR_LEN(scan));
3609                 }
3610                 data->last_end = data->pos_min + l;
3611                 data->pos_min += l; /* As in the first entry. */
3612                 data->flags &= ~SF_BEFORE_EOL;
3613             }
3614             if (flags & SCF_DO_STCLASS_AND) {
3615                 /* Check whether it is compatible with what we know already! */
3616                 int compat = 1;
3617
3618
3619                 /* If compatible, we or it in below.  It is compatible if is
3620                  * in the bitmp and either 1) its bit or its fold is set, or 2)
3621                  * it's for a locale.  Even if there isn't unicode semantics
3622                  * here, at runtime there may be because of matching against a
3623                  * utf8 string, so accept a possible false positive for
3624                  * latin1-range folds */
3625                 if (uc >= 0x100 ||
3626                     (!(data->start_class->flags & ANYOF_LOCALE)
3627                     && !ANYOF_BITMAP_TEST(data->start_class, uc)
3628                     && (!(data->start_class->flags & ANYOF_LOC_FOLD)
3629                         || !ANYOF_BITMAP_TEST(data->start_class, PL_fold_latin1[uc])))
3630                     )
3631                 {
3632                     compat = 0;
3633                 }
3634                 ANYOF_CLASS_ZERO(data->start_class);
3635                 ANYOF_BITMAP_ZERO(data->start_class);
3636                 if (compat)
3637                     ANYOF_BITMAP_SET(data->start_class, uc);
3638                 else if (uc >= 0x100) {
3639                     int i;
3640
3641                     /* Some Unicode code points fold to the Latin1 range; as
3642                      * XXX temporary code, instead of figuring out if this is
3643                      * one, just assume it is and set all the start class bits
3644                      * that could be some such above 255 code point's fold
3645                      * which will generate fals positives.  As the code
3646                      * elsewhere that does compute the fold settles down, it
3647                      * can be extracted out and re-used here */
3648                     for (i = 0; i < 256; i++){
3649                         if (HAS_NONLATIN1_FOLD_CLOSURE(i)) {
3650                             ANYOF_BITMAP_SET(data->start_class, i);
3651                         }
3652                     }
3653                 }
3654                 CLEAR_SSC_EOS(data->start_class);
3655                 if (uc < 0x100)
3656                   data->start_class->flags &= ~ANYOF_UNICODE_ALL;
3657             }
3658             else if (flags & SCF_DO_STCLASS_OR) {
3659                 /* false positive possible if the class is case-folded */
3660                 if (uc < 0x100)
3661                     ANYOF_BITMAP_SET(data->start_class, uc);
3662                 else
3663                     data->start_class->flags |= ANYOF_UNICODE_ALL;
3664                 CLEAR_SSC_EOS(data->start_class);
3665                 cl_and(data->start_class, and_withp);
3666             }
3667             flags &= ~SCF_DO_STCLASS;
3668         }
3669         else if (PL_regkind[OP(scan)] == EXACT) { /* But OP != EXACT! */
3670             I32 l = STR_LEN(scan);
3671             UV uc = *((U8*)STRING(scan));
3672
3673             /* Search for fixed substrings supports EXACT only. */
3674             if (flags & SCF_DO_SUBSTR) {
3675                 assert(data);
3676                 SCAN_COMMIT(pRExC_state, data, minlenp);
3677             }
3678             if (UTF) {
3679                 const U8 * const s = (U8 *)STRING(scan);
3680                 uc = utf8_to_uvchr_buf(s, s + l, NULL);
3681                 l = utf8_length(s, s + l);
3682             }
3683             if (has_exactf_sharp_s) {
3684                 RExC_seen |= REG_SEEN_EXACTF_SHARP_S;
3685             }
3686             min += l - min_subtract;
3687             assert (min >= 0);
3688             delta += min_subtract;
3689             if (flags & SCF_DO_SUBSTR) {
3690                 data->pos_min += l - min_subtract;
3691                 if (data->pos_min < 0) {
3692                     data->pos_min = 0;
3693                 }
3694                 data->pos_delta += min_subtract;
3695                 if (min_subtract) {
3696                     data->longest = &(data->longest_float);
3697                 }
3698             }
3699             if (flags & SCF_DO_STCLASS_AND) {
3700                 /* Check whether it is compatible with what we know already! */
3701                 int compat = 1;
3702                 if (uc >= 0x100 ||
3703                  (!(data->start_class->flags & ANYOF_LOCALE)
3704                   && !ANYOF_BITMAP_TEST(data->start_class, uc)
3705                   && !ANYOF_BITMAP_TEST(data->start_class, PL_fold_latin1[uc])))
3706                 {
3707                     compat = 0;
3708                 }
3709                 ANYOF_CLASS_ZERO(data->start_class);
3710                 ANYOF_BITMAP_ZERO(data->start_class);
3711                 if (compat) {
3712                     ANYOF_BITMAP_SET(data->start_class, uc);
3713                     CLEAR_SSC_EOS(data->start_class);
3714                     if (OP(scan) == EXACTFL) {
3715                         /* XXX This set is probably no longer necessary, and
3716                          * probably wrong as LOCALE now is on in the initial
3717                          * state */
3718                         data->start_class->flags |= ANYOF_LOCALE|ANYOF_LOC_FOLD;
3719                     }
3720                     else {
3721
3722                         /* Also set the other member of the fold pair.  In case
3723                          * that unicode semantics is called for at runtime, use
3724                          * the full latin1 fold.  (Can't do this for locale,
3725                          * because not known until runtime) */
3726                         ANYOF_BITMAP_SET(data->start_class, PL_fold_latin1[uc]);
3727
3728                         /* All other (EXACTFL handled above) folds except under
3729                          * /iaa that include s, S, and sharp_s also may include
3730                          * the others */
3731                         if (OP(scan) != EXACTFA) {
3732                             if (uc == 's' || uc == 'S') {
3733                                 ANYOF_BITMAP_SET(data->start_class,
3734                                                  LATIN_SMALL_LETTER_SHARP_S);
3735                             }
3736                             else if (uc == LATIN_SMALL_LETTER_SHARP_S) {
3737                                 ANYOF_BITMAP_SET(data->start_class, 's');
3738                                 ANYOF_BITMAP_SET(data->start_class, 'S');
3739                             }
3740                         }
3741                     }
3742                 }
3743                 else if (uc >= 0x100) {
3744                     int i;
3745                     for (i = 0; i < 256; i++){
3746                         if (_HAS_NONLATIN1_FOLD_CLOSURE_ONLY_FOR_USE_BY_REGCOMP_DOT_C_AND_REGEXEC_DOT_C(i)) {
3747                             ANYOF_BITMAP_SET(data->start_class, i);
3748                         }
3749                     }
3750                 }
3751             }
3752             else if (flags & SCF_DO_STCLASS_OR) {
3753                 if (data->start_class->flags & ANYOF_LOC_FOLD) {
3754                     /* false positive possible if the class is case-folded.
3755                        Assume that the locale settings are the same... */
3756                     if (uc < 0x100) {
3757                         ANYOF_BITMAP_SET(data->start_class, uc);
3758                         if (OP(scan) != EXACTFL) {
3759
3760                             /* And set the other member of the fold pair, but
3761                              * can't do that in locale because not known until
3762                              * run-time */
3763                             ANYOF_BITMAP_SET(data->start_class,
3764                                              PL_fold_latin1[uc]);
3765
3766                             /* All folds except under /iaa that include s, S,
3767                              * and sharp_s also may include the others */
3768                             if (OP(scan) != EXACTFA) {
3769                                 if (uc == 's' || uc == 'S') {
3770                                     ANYOF_BITMAP_SET(data->start_class,
3771                                                    LATIN_SMALL_LETTER_SHARP_S);
3772                                 }
3773                                 else if (uc == LATIN_SMALL_LETTER_SHARP_S) {
3774                                     ANYOF_BITMAP_SET(data->start_class, 's');
3775                                     ANYOF_BITMAP_SET(data->start_class, 'S');
3776                                 }
3777                             }
3778                         }
3779                     }
3780                     CLEAR_SSC_EOS(data->start_class);
3781                 }
3782                 cl_and(data->start_class, and_withp);
3783             }
3784             flags &= ~SCF_DO_STCLASS;
3785         }
3786         else if (REGNODE_VARIES(OP(scan))) {
3787             I32 mincount, maxcount, minnext, deltanext, fl = 0;
3788             I32 f = flags, pos_before = 0;
3789             regnode * const oscan = scan;
3790             struct regnode_charclass_class this_class;
3791             struct regnode_charclass_class *oclass = NULL;
3792             I32 next_is_eval = 0;
3793
3794             switch (PL_regkind[OP(scan)]) {
3795             case WHILEM:                /* End of (?:...)* . */
3796                 scan = NEXTOPER(scan);
3797                 goto finish;
3798             case PLUS:
3799                 if (flags & (SCF_DO_SUBSTR | SCF_DO_STCLASS)) {
3800                     next = NEXTOPER(scan);
3801                     if (OP(next) == EXACT || (flags & SCF_DO_STCLASS)) {
3802                         mincount = 1;
3803                         maxcount = REG_INFTY;
3804                         next = regnext(scan);
3805                         scan = NEXTOPER(scan);
3806                         goto do_curly;
3807                     }
3808                 }
3809                 if (flags & SCF_DO_SUBSTR)
3810                     data->pos_min++;
3811                 min++;
3812                 /* Fall through. */
3813             case STAR:
3814                 if (flags & SCF_DO_STCLASS) {
3815                     mincount = 0;
3816                     maxcount = REG_INFTY;
3817                     next = regnext(scan);
3818                     scan = NEXTOPER(scan);
3819                     goto do_curly;
3820                 }
3821                 is_inf = is_inf_internal = 1;
3822                 scan = regnext(scan);
3823                 if (flags & SCF_DO_SUBSTR) {
3824                     SCAN_COMMIT(pRExC_state, data, minlenp); /* Cannot extend fixed substrings */
3825                     data->longest = &(data->longest_float);
3826                 }
3827                 goto optimize_curly_tail;
3828             case CURLY:
3829                 if (stopparen>0 && (OP(scan)==CURLYN || OP(scan)==CURLYM)
3830                     && (scan->flags == stopparen))
3831                 {
3832                     mincount = 1;
3833                     maxcount = 1;
3834                 } else {
3835                     mincount = ARG1(scan);
3836                     maxcount = ARG2(scan);
3837                 }
3838                 next = regnext(scan);
3839                 if (OP(scan) == CURLYX) {
3840                     I32 lp = (data ? *(data->last_closep) : 0);
3841                     scan->flags = ((lp <= (I32)U8_MAX) ? (U8)lp : U8_MAX);
3842                 }
3843                 scan = NEXTOPER(scan) + EXTRA_STEP_2ARGS;
3844                 next_is_eval = (OP(scan) == EVAL);
3845               do_curly:
3846                 if (flags & SCF_DO_SUBSTR) {
3847                     if (mincount == 0) SCAN_COMMIT(pRExC_state,data,minlenp); /* Cannot extend fixed substrings */
3848                     pos_before = data->pos_min;
3849                 }
3850                 if (data) {
3851                     fl = data->flags;
3852                     data->flags &= ~(SF_HAS_PAR|SF_IN_PAR|SF_HAS_EVAL);
3853                     if (is_inf)
3854                         data->flags |= SF_IS_INF;
3855                 }
3856                 if (flags & SCF_DO_STCLASS) {
3857                     cl_init(pRExC_state, &this_class);
3858                     oclass = data->start_class;
3859                     data->start_class = &this_class;
3860                     f |= SCF_DO_STCLASS_AND;
3861                     f &= ~SCF_DO_STCLASS_OR;
3862                 }
3863                 /* Exclude from super-linear cache processing any {n,m}
3864                    regops for which the combination of input pos and regex
3865                    pos is not enough information to determine if a match
3866                    will be possible.
3867
3868                    For example, in the regex /foo(bar\s*){4,8}baz/ with the
3869                    regex pos at the \s*, the prospects for a match depend not
3870                    only on the input position but also on how many (bar\s*)
3871                    repeats into the {4,8} we are. */
3872                if ((mincount > 1) || (maxcount > 1 && maxcount != REG_INFTY))
3873                     f &= ~SCF_WHILEM_VISITED_POS;
3874
3875                 /* This will finish on WHILEM, setting scan, or on NULL: */
3876                 minnext = study_chunk(pRExC_state, &scan, minlenp, &deltanext, 
3877                                       last, data, stopparen, recursed, NULL,
3878                                       (mincount == 0
3879                                         ? (f & ~SCF_DO_SUBSTR) : f),depth+1);
3880
3881                 if (flags & SCF_DO_STCLASS)
3882                     data->start_class = oclass;
3883                 if (mincount == 0 || minnext == 0) {
3884                     if (flags & SCF_DO_STCLASS_OR) {
3885                         cl_or(pRExC_state, data->start_class, &this_class);
3886                     }
3887                     else if (flags & SCF_DO_STCLASS_AND) {
3888                         /* Switch to OR mode: cache the old value of
3889                          * data->start_class */
3890                         INIT_AND_WITHP;
3891                         StructCopy(data->start_class, and_withp,
3892                                    struct regnode_charclass_class);
3893                         flags &= ~SCF_DO_STCLASS_AND;
3894                         StructCopy(&this_class, data->start_class,
3895                                    struct regnode_charclass_class);
3896                         flags |= SCF_DO_STCLASS_OR;
3897                         SET_SSC_EOS(data->start_class);
3898                     }
3899                 } else {                /* Non-zero len */
3900                     if (flags & SCF_DO_STCLASS_OR) {
3901                         cl_or(pRExC_state, data->start_class, &this_class);
3902                         cl_and(data->start_class, and_withp);
3903                     }
3904                     else if (flags & SCF_DO_STCLASS_AND)
3905                         cl_and(data->start_class, &this_class);
3906                     flags &= ~SCF_DO_STCLASS;
3907                 }
3908                 if (!scan)              /* It was not CURLYX, but CURLY. */
3909                     scan = next;
3910                 if ( /* ? quantifier ok, except for (?{ ... }) */
3911                     (next_is_eval || !(mincount == 0 && maxcount == 1))
3912                     && (minnext == 0) && (deltanext == 0)
3913                     && data && !(data->flags & (SF_HAS_PAR|SF_IN_PAR))
3914                     && maxcount <= REG_INFTY/3) /* Complement check for big count */
3915                 {
3916                     /* Fatal warnings may leak the regexp without this: */
3917                     SAVEFREESV(RExC_rx_sv);
3918                     ckWARNreg(RExC_parse,
3919                               "Quantifier unexpected on zero-length expression");
3920                     (void)ReREFCNT_inc(RExC_rx_sv);
3921                 }
3922
3923                 min += minnext * mincount;
3924                 is_inf_internal |= deltanext == I32_MAX
3925                                      || (maxcount == REG_INFTY && minnext + deltanext > 0);
3926                 is_inf |= is_inf_internal;
3927                 if (is_inf)
3928                     delta = I32_MAX;
3929                 else
3930                     delta += (minnext + deltanext) * maxcount - minnext * mincount;
3931
3932                 /* Try powerful optimization CURLYX => CURLYN. */
3933                 if (  OP(oscan) == CURLYX && data
3934                       && data->flags & SF_IN_PAR
3935                       && !(data->flags & SF_HAS_EVAL)
3936                       && !deltanext && minnext == 1 ) {
3937                     /* Try to optimize to CURLYN.  */
3938                     regnode *nxt = NEXTOPER(oscan) + EXTRA_STEP_2ARGS;
3939                     regnode * const nxt1 = nxt;
3940 #ifdef DEBUGGING
3941                     regnode *nxt2;
3942 #endif
3943
3944                     /* Skip open. */
3945                     nxt = regnext(nxt);
3946                     if (!REGNODE_SIMPLE(OP(nxt))
3947                         && !(PL_regkind[OP(nxt)] == EXACT
3948                              && STR_LEN(nxt) == 1))
3949                         goto nogo;
3950 #ifdef DEBUGGING
3951                     nxt2 = nxt;
3952 #endif
3953                     nxt = regnext(nxt);
3954                     if (OP(nxt) != CLOSE)
3955                         goto nogo;
3956                     if (RExC_open_parens) {
3957                         RExC_open_parens[ARG(nxt1)-1]=oscan; /*open->CURLYM*/
3958                         RExC_close_parens[ARG(nxt1)-1]=nxt+2; /*close->while*/
3959                     }
3960                     /* Now we know that nxt2 is the only contents: */
3961                     oscan->flags = (U8)ARG(nxt);
3962                     OP(oscan) = CURLYN;
3963                     OP(nxt1) = NOTHING; /* was OPEN. */
3964
3965 #ifdef DEBUGGING
3966                     OP(nxt1 + 1) = OPTIMIZED; /* was count. */
3967                     NEXT_OFF(nxt1+ 1) = 0; /* just for consistency. */
3968                     NEXT_OFF(nxt2) = 0; /* just for consistency with CURLY. */
3969                     OP(nxt) = OPTIMIZED;        /* was CLOSE. */
3970                     OP(nxt + 1) = OPTIMIZED; /* was count. */
3971                     NEXT_OFF(nxt+ 1) = 0; /* just for consistency. */
3972 #endif
3973                 }
3974               nogo:
3975
3976                 /* Try optimization CURLYX => CURLYM. */
3977                 if (  OP(oscan) == CURLYX && data
3978                       && !(data->flags & SF_HAS_PAR)
3979                       && !(data->flags & SF_HAS_EVAL)
3980                       && !deltanext     /* atom is fixed width */
3981                       && minnext != 0   /* CURLYM can't handle zero width */
3982                       && ! (RExC_seen & REG_SEEN_EXACTF_SHARP_S) /* Nor \xDF */
3983                 ) {
3984                     /* XXXX How to optimize if data == 0? */
3985                     /* Optimize to a simpler form.  */
3986                     regnode *nxt = NEXTOPER(oscan) + EXTRA_STEP_2ARGS; /* OPEN */
3987                     regnode *nxt2;
3988
3989                     OP(oscan) = CURLYM;
3990                     while ( (nxt2 = regnext(nxt)) /* skip over embedded stuff*/
3991                             && (OP(nxt2) != WHILEM))
3992                         nxt = nxt2;
3993                     OP(nxt2)  = SUCCEED; /* Whas WHILEM */
3994                     /* Need to optimize away parenths. */
3995                     if ((data->flags & SF_IN_PAR) && OP(nxt) == CLOSE) {
3996                         /* Set the parenth number.  */
3997                         regnode *nxt1 = NEXTOPER(oscan) + EXTRA_STEP_2ARGS; /* OPEN*/
3998
3999                         oscan->flags = (U8)ARG(nxt);
4000                         if (RExC_open_parens) {
4001                             RExC_open_parens[ARG(nxt1)-1]=oscan; /*open->CURLYM*/
4002                             RExC_close_parens[ARG(nxt1)-1]=nxt2+1; /*close->NOTHING*/
4003                         }
4004                         OP(nxt1) = OPTIMIZED;   /* was OPEN. */
4005                         OP(nxt) = OPTIMIZED;    /* was CLOSE. */
4006
4007 #ifdef DEBUGGING
4008                         OP(nxt1 + 1) = OPTIMIZED; /* was count. */
4009                         OP(nxt + 1) = OPTIMIZED; /* was count. */
4010                         NEXT_OFF(nxt1 + 1) = 0; /* just for consistency. */
4011                         NEXT_OFF(nxt + 1) = 0; /* just for consistency. */
4012 #endif
4013 #if 0
4014                         while ( nxt1 && (OP(nxt1) != WHILEM)) {
4015                             regnode *nnxt = regnext(nxt1);
4016                             if (nnxt == nxt) {
4017                                 if (reg_off_by_arg[OP(nxt1)])
4018                                     ARG_SET(nxt1, nxt2 - nxt1);
4019                                 else if (nxt2 - nxt1 < U16_MAX)
4020                                     NEXT_OFF(nxt1) = nxt2 - nxt1;
4021                                 else
4022                                     OP(nxt) = NOTHING;  /* Cannot beautify */
4023                             }
4024                             nxt1 = nnxt;
4025                         }
4026 #endif
4027                         /* Optimize again: */
4028                         study_chunk(pRExC_state, &nxt1, minlenp, &deltanext, nxt,
4029                                     NULL, stopparen, recursed, NULL, 0,depth+1);
4030                     }
4031                     else
4032                         oscan->flags = 0;
4033                 }
4034                 else if ((OP(oscan) == CURLYX)
4035                          && (flags & SCF_WHILEM_VISITED_POS)
4036                          /* See the comment on a similar expression above.
4037                             However, this time it's not a subexpression
4038                             we care about, but the expression itself. */
4039                          && (maxcount == REG_INFTY)
4040                          && data && ++data->whilem_c < 16) {
4041                     /* This stays as CURLYX, we can put the count/of pair. */
4042                     /* Find WHILEM (as in regexec.c) */
4043                     regnode *nxt = oscan + NEXT_OFF(oscan);
4044
4045                     if (OP(PREVOPER(nxt)) == NOTHING) /* LONGJMP */
4046                         nxt += ARG(nxt);
4047                     PREVOPER(nxt)->flags = (U8)(data->whilem_c
4048                         | (RExC_whilem_seen << 4)); /* On WHILEM */
4049                 }
4050                 if (data && fl & (SF_HAS_PAR|SF_IN_PAR))
4051                     pars++;
4052                 if (flags & SCF_DO_SUBSTR) {
4053                     SV *last_str = NULL;
4054                     int counted = mincount != 0;
4055
4056                     if (data->last_end > 0 && mincount != 0) { /* Ends with a string. */
4057 #if defined(SPARC64_GCC_WORKAROUND)
4058                         I32 b = 0;
4059                         STRLEN l = 0;
4060                         const char *s = NULL;
4061                         I32 old = 0;
4062
4063                         if (pos_before >= data->last_start_min)
4064                             b = pos_before;
4065                         else
4066                             b = data->last_start_min;
4067
4068                         l = 0;
4069                         s = SvPV_const(data->last_found, l);
4070                         old = b - data->last_start_min;
4071
4072 #else
4073                         I32 b = pos_before >= data->last_start_min
4074                             ? pos_before : data->last_start_min;
4075                         STRLEN l;
4076                         const char * const s = SvPV_const(data->last_found, l);
4077                         I32 old = b - data->last_start_min;
4078 #endif
4079
4080                         if (UTF)
4081                             old = utf8_hop((U8*)s, old) - (U8*)s;
4082                         l -= old;
4083                         /* Get the added string: */
4084                         last_str = newSVpvn_utf8(s  + old, l, UTF);
4085                         if (deltanext == 0 && pos_before == b) {
4086                             /* What was added is a constant string */
4087                             if (mincount > 1) {
4088                                 SvGROW(last_str, (mincount * l) + 1);
4089                                 repeatcpy(SvPVX(last_str) + l,
4090                                           SvPVX_const(last_str), l, mincount - 1);
4091                                 SvCUR_set(last_str, SvCUR(last_str) * mincount);
4092                                 /* Add additional parts. */
4093                                 SvCUR_set(data->last_found,
4094                                           SvCUR(data->last_found) - l);
4095                                 sv_catsv(data->last_found, last_str);
4096                                 {
4097                                     SV * sv = data->last_found;
4098                                     MAGIC *mg =
4099                                         SvUTF8(sv) && SvMAGICAL(sv) ?
4100                                         mg_find(sv, PERL_MAGIC_utf8) : NULL;
4101                                     if (mg && mg->mg_len >= 0)
4102                                         mg->mg_len += CHR_SVLEN(last_str) - l;
4103                                 }
4104                                 data->last_end += l * (mincount - 1);
4105                             }
4106                         } else {
4107                             /* start offset must point into the last copy */
4108                             data->last_start_min += minnext * (mincount - 1);
4109                             data->last_start_max += is_inf ? I32_MAX
4110                                 : (maxcount - 1) * (minnext + data->pos_delta);
4111                         }
4112                     }
4113                     /* It is counted once already... */
4114                     data->pos_min += minnext * (mincount - counted);
4115 #if 0
4116 PerlIO_printf(Perl_debug_log, "counted=%d deltanext=%d I32_MAX=%d minnext=%d maxcount=%d mincount=%d\n",
4117     counted, deltanext, I32_MAX, minnext, maxcount, mincount);
4118 if (deltanext != I32_MAX)
4119 PerlIO_printf(Perl_debug_log, "LHS=%d RHS=%d\n", -counted * deltanext + (minnext + deltanext) * maxcount - minnext * mincount, I32_MAX - data->pos_delta);
4120 #endif
4121                     if (deltanext == I32_MAX || -counted * deltanext + (minnext + deltanext) * maxcount - minnext * mincount >= I32_MAX - data->pos_delta)
4122                         data->pos_delta = I32_MAX;
4123                     else
4124                         data->pos_delta += - counted * deltanext +
4125                         (minnext + deltanext) * maxcount - minnext * mincount;
4126                     if (mincount != maxcount) {
4127                          /* Cannot extend fixed substrings found inside
4128                             the group.  */
4129                         SCAN_COMMIT(pRExC_state,data,minlenp);
4130                         if (mincount && last_str) {
4131                             SV * const sv = data->last_found;
4132                             MAGIC * const mg = SvUTF8(sv) && SvMAGICAL(sv) ?
4133                                 mg_find(sv, PERL_MAGIC_utf8) : NULL;
4134
4135                             if (mg)
4136                                 mg->mg_len = -1;
4137                             sv_setsv(sv, last_str);
4138                             data->last_end = data->pos_min;
4139                             data->last_start_min =
4140                                 data->pos_min - CHR_SVLEN(last_str);
4141                             data->last_start_max = is_inf
4142                                 ? I32_MAX
4143                                 : data->pos_min + data->pos_delta
4144                                 - CHR_SVLEN(last_str);
4145                         }
4146                         data->longest = &(data->longest_float);
4147                     }
4148                     SvREFCNT_dec(last_str);
4149                 }
4150                 if (data && (fl & SF_HAS_EVAL))
4151                     data->flags |= SF_HAS_EVAL;
4152               optimize_curly_tail:
4153                 if (OP(oscan) != CURLYX) {
4154                     while (PL_regkind[OP(next = regnext(oscan))] == NOTHING
4155                            && NEXT_OFF(next))
4156                         NEXT_OFF(oscan) += NEXT_OFF(next);
4157                 }
4158                 continue;
4159             default:                    /* REF, and CLUMP only? */
4160                 if (flags & SCF_DO_SUBSTR) {
4161                     SCAN_COMMIT(pRExC_state,data,minlenp);      /* Cannot expect anything... */
4162                     data->longest = &(data->longest_float);
4163                 }
4164                 is_inf = is_inf_internal = 1;
4165                 if (flags & SCF_DO_STCLASS_OR)
4166                     cl_anything(pRExC_state, data->start_class);
4167                 flags &= ~SCF_DO_STCLASS;
4168                 break;
4169             }
4170         }
4171         else if (OP(scan) == LNBREAK) {
4172             if (flags & SCF_DO_STCLASS) {
4173                 int value = 0;
4174                 CLEAR_SSC_EOS(data->start_class); /* No match on empty */
4175                 if (flags & SCF_DO_STCLASS_AND) {
4176                     for (value = 0; value < 256; value++)
4177                         if (!is_VERTWS_cp(value))
4178                             ANYOF_BITMAP_CLEAR(data->start_class, value);
4179                 }
4180                 else {
4181                     for (value = 0; value < 256; value++)
4182                         if (is_VERTWS_cp(value))
4183                             ANYOF_BITMAP_SET(data->start_class, value);
4184                 }
4185                 if (flags & SCF_DO_STCLASS_OR)
4186                     cl_and(data->start_class, and_withp);
4187                 flags &= ~SCF_DO_STCLASS;
4188             }
4189             min++;
4190             delta++;    /* Because of the 2 char string cr-lf */
4191             if (flags & SCF_DO_SUBSTR) {
4192                 SCAN_COMMIT(pRExC_state,data,minlenp);  /* Cannot expect anything... */
4193                 data->pos_min += 1;
4194                 data->pos_delta += 1;
4195                 data->longest = &(data->longest_float);
4196             }
4197         }
4198         else if (REGNODE_SIMPLE(OP(scan))) {
4199             int value = 0;
4200
4201             if (flags & SCF_DO_SUBSTR) {
4202                 SCAN_COMMIT(pRExC_state,data,minlenp);
4203                 data->pos_min++;
4204             }
4205             min++;
4206             if (flags & SCF_DO_STCLASS) {
4207                 int loop_max = 256;
4208                 CLEAR_SSC_EOS(data->start_class); /* No match on empty */
4209
4210                 /* Some of the logic below assumes that switching
4211                    locale on will only add false positives. */
4212                 switch (PL_regkind[OP(scan)]) {
4213                     U8 classnum;
4214
4215                 case SANY:
4216                 default:
4217 #ifdef DEBUGGING
4218                    Perl_croak(aTHX_ "panic: unexpected simple REx opcode %d", OP(scan));
4219 #endif
4220                  do_default:
4221                     if (flags & SCF_DO_STCLASS_OR) /* Allow everything */
4222                         cl_anything(pRExC_state, data->start_class);
4223                     break;
4224                 case REG_ANY:
4225                     if (OP(scan) == SANY)
4226                         goto do_default;
4227                     if (flags & SCF_DO_STCLASS_OR) { /* Everything but \n */
4228                         value = (ANYOF_BITMAP_TEST(data->start_class,'\n')
4229                                 || ANYOF_CLASS_TEST_ANY_SET(data->start_class));
4230                         cl_anything(pRExC_state, data->start_class);
4231                     }
4232                     if (flags & SCF_DO_STCLASS_AND || !value)
4233                         ANYOF_BITMAP_CLEAR(data->start_class,'\n');
4234                     break;
4235                 case ANYOF:
4236                     if (flags & SCF_DO_STCLASS_AND)
4237                         cl_and(data->start_class,
4238                                (struct regnode_charclass_class*)scan);
4239                     else
4240                         cl_or(pRExC_state, data->start_class,
4241                               (struct regnode_charclass_class*)scan);
4242                     break;
4243                 case POSIXA:
4244                     loop_max = 128;
4245                     /* FALL THROUGH */
4246                 case POSIXL:
4247                 case POSIXD:
4248                 case POSIXU:
4249                     classnum = FLAGS(scan);
4250                     if (flags & SCF_DO_STCLASS_AND) {
4251                         if (!(data->start_class->flags & ANYOF_LOCALE)) {
4252                             ANYOF_CLASS_CLEAR(data->start_class, classnum_to_namedclass(classnum) + 1);
4253                             for (value = 0; value < loop_max; value++) {
4254                                 if (! _generic_isCC(UNI_TO_NATIVE(value), classnum)) {
4255                                     ANYOF_BITMAP_CLEAR(data->start_class, UNI_TO_NATIVE(value));
4256                                 }
4257                             }
4258                         }
4259                     }
4260                     else {
4261                         if (data->start_class->flags & ANYOF_LOCALE) {
4262                             ANYOF_CLASS_SET(data->start_class, classnum_to_namedclass(classnum));
4263                         }
4264                         else {
4265
4266                         /* Even if under locale, set the bits for non-locale
4267                          * in case it isn't a true locale-node.  This will
4268                          * create false positives if it truly is locale */
4269                         for (value = 0; value < loop_max; value++) {
4270                             if (_generic_isCC(UNI_TO_NATIVE(value), classnum)) {
4271                                 ANYOF_BITMAP_SET(data->start_class, UNI_TO_NATIVE(value));
4272                             }
4273                         }
4274                         }
4275                     }
4276                     break;
4277                 case NPOSIXA:
4278                     loop_max = 128;
4279                     /* FALL THROUGH */
4280                 case NPOSIXL:
4281                 case NPOSIXU:
4282                 case NPOSIXD:
4283                     classnum = FLAGS(scan);
4284                     if (flags & SCF_DO_STCLASS_AND) {
4285                         if (!(data->start_class->flags & ANYOF_LOCALE)) {
4286                             ANYOF_CLASS_CLEAR(data->start_class, classnum_to_namedclass(classnum));
4287                             for (value = 0; value < loop_max; value++) {
4288                                 if (_generic_isCC(UNI_TO_NATIVE(value), classnum)) {
4289                                     ANYOF_BITMAP_CLEAR(data->start_class, UNI_TO_NATIVE(value));
4290                                 }
4291                             }
4292                         }
4293                     }
4294                     else {
4295                         if (data->start_class->flags & ANYOF_LOCALE) {
4296                             ANYOF_CLASS_SET(data->start_class, classnum_to_namedclass(classnum) + 1);
4297                         }
4298                         else {
4299
4300                         /* Even if under locale, set the bits for non-locale in
4301                          * case it isn't a true locale-node.  This will create
4302                          * false positives if it truly is locale */
4303                         for (value = 0; value < loop_max; value++) {
4304                             if (! _generic_isCC(UNI_TO_NATIVE(value), classnum)) {
4305                                 ANYOF_BITMAP_SET(data->start_class, UNI_TO_NATIVE(value));
4306                             }
4307                         }
4308                         if (PL_regkind[OP(scan)] == NPOSIXD) {
4309                             data->start_class->flags |= ANYOF_NON_UTF8_LATIN1_ALL;
4310                         }
4311                         }
4312                     }
4313                     break;
4314                 }
4315                 if (flags & SCF_DO_STCLASS_OR)
4316                     cl_and(data->start_class, and_withp);
4317                 flags &= ~SCF_DO_STCLASS;
4318             }
4319         }
4320         else if (PL_regkind[OP(scan)] == EOL && flags & SCF_DO_SUBSTR) {
4321             data->flags |= (OP(scan) == MEOL
4322                             ? SF_BEFORE_MEOL
4323                             : SF_BEFORE_SEOL);
4324             SCAN_COMMIT(pRExC_state, data, minlenp);
4325
4326         }
4327         else if (  PL_regkind[OP(scan)] == BRANCHJ
4328                  /* Lookbehind, or need to calculate parens/evals/stclass: */
4329                    && (scan->flags || data || (flags & SCF_DO_STCLASS))
4330                    && (OP(scan) == IFMATCH || OP(scan) == UNLESSM)) {
4331             if ( OP(scan) == UNLESSM &&
4332                  scan->flags == 0 &&
4333                  OP(NEXTOPER(NEXTOPER(scan))) == NOTHING &&
4334                  OP(regnext(NEXTOPER(NEXTOPER(scan)))) == SUCCEED
4335             ) {
4336                 regnode *opt;
4337                 regnode *upto= regnext(scan);
4338                 DEBUG_PARSE_r({
4339                     SV * const mysv_val=sv_newmortal();
4340                     DEBUG_STUDYDATA("OPFAIL",data,depth);
4341
4342                     /*DEBUG_PARSE_MSG("opfail");*/
4343                     regprop(RExC_rx, mysv_val, upto);
4344                     PerlIO_printf(Perl_debug_log, "~ replace with OPFAIL pointed at %s (%"IVdf") offset %"IVdf"\n",
4345                                   SvPV_nolen_const(mysv_val),
4346                                   (IV)REG_NODE_NUM(upto),
4347                                   (IV)(upto - scan)
4348                     );
4349                 });
4350                 OP(scan) = OPFAIL;
4351                 NEXT_OFF(scan) = upto - scan;
4352                 for (opt= scan + 1; opt < upto ; opt++)
4353                     OP(opt) = OPTIMIZED;
4354                 scan= upto;
4355                 continue;
4356             }
4357             if ( !PERL_ENABLE_POSITIVE_ASSERTION_STUDY 
4358                 || OP(scan) == UNLESSM )
4359             {
4360                 /* Negative Lookahead/lookbehind
4361                    In this case we can't do fixed string optimisation.
4362                 */
4363
4364                 I32 deltanext, minnext, fake = 0;
4365                 regnode *nscan;
4366                 struct regnode_charclass_class intrnl;
4367                 int f = 0;
4368
4369                 data_fake.flags = 0;
4370                 if (data) {
4371                     data_fake.whilem_c = data->whilem_c;
4372                     data_fake.last_closep = data->last_closep;
4373                 }
4374                 else
4375                     data_fake.last_closep = &fake;
4376                 data_fake.pos_delta = delta;
4377                 if ( flags & SCF_DO_STCLASS && !scan->flags
4378                      && OP(scan) == IFMATCH ) { /* Lookahead */
4379                     cl_init(pRExC_state, &intrnl);
4380                     data_fake.start_class = &intrnl;
4381                     f |= SCF_DO_STCLASS_AND;
4382                 }
4383                 if (flags & SCF_WHILEM_VISITED_POS)
4384                     f |= SCF_WHILEM_VISITED_POS;
4385                 next = regnext(scan);
4386                 nscan = NEXTOPER(NEXTOPER(scan));
4387                 minnext = study_chunk(pRExC_state, &nscan, minlenp, &deltanext, 
4388                     last, &data_fake, stopparen, recursed, NULL, f, depth+1);
4389                 if (scan->flags) {
4390                     if (deltanext) {
4391                         FAIL("Variable length lookbehind not implemented");
4392                     }
4393                     else if (minnext > (I32)U8_MAX) {
4394                         FAIL2("Lookbehind longer than %"UVuf" not implemented", (UV)U8_MAX);
4395                     }
4396                     scan->flags = (U8)minnext;
4397                 }
4398                 if (data) {
4399                     if (data_fake.flags & (SF_HAS_PAR|SF_IN_PAR))
4400                         pars++;
4401                     if (data_fake.flags & SF_HAS_EVAL)
4402                         data->flags |= SF_HAS_EVAL;
4403                     data->whilem_c = data_fake.whilem_c;
4404                 }
4405                 if (f & SCF_DO_STCLASS_AND) {
4406                     if (flags & SCF_DO_STCLASS_OR) {
4407                         /* OR before, AND after: ideally we would recurse with
4408                          * data_fake to get the AND applied by study of the
4409                          * remainder of the pattern, and then derecurse;
4410                          * *** HACK *** for now just treat as "no information".
4411                          * See [perl #56690].
4412                          */
4413                         cl_init(pRExC_state, data->start_class);
4414                     }  else {
4415                         /* AND before and after: combine and continue */
4416                         const int was = TEST_SSC_EOS(data->start_class);
4417
4418                         cl_and(data->start_class, &intrnl);
4419                         if (was)
4420                             SET_SSC_EOS(data->start_class);
4421                     }
4422                 }
4423             }
4424 #if PERL_ENABLE_POSITIVE_ASSERTION_STUDY
4425             else {
4426                 /* Positive Lookahead/lookbehind
4427                    In this case we can do fixed string optimisation,
4428                    but we must be careful about it. Note in the case of
4429                    lookbehind the positions will be offset by the minimum
4430                    length of the pattern, something we won't know about
4431                    until after the recurse.
4432                 */
4433                 I32 deltanext, fake = 0;
4434                 regnode *nscan;
4435                 struct regnode_charclass_class intrnl;
4436                 int f = 0;
4437                 /* We use SAVEFREEPV so that when the full compile 
4438                     is finished perl will clean up the allocated 
4439                     minlens when it's all done. This way we don't
4440                     have to worry about freeing them when we know
4441                     they wont be used, which would be a pain.
4442                  */
4443                 I32 *minnextp;
4444                 Newx( minnextp, 1, I32 );
4445                 SAVEFREEPV(minnextp);
4446
4447                 if (data) {
4448                     StructCopy(data, &data_fake, scan_data_t);
4449                     if ((flags & SCF_DO_SUBSTR) && data->last_found) {
4450                         f |= SCF_DO_SUBSTR;
4451                         if (scan->flags) 
4452                             SCAN_COMMIT(pRExC_state, &data_fake,minlenp);
4453                         data_fake.last_found=newSVsv(data->last_found);
4454                     }
4455                 }
4456                 else
4457                     data_fake.last_closep = &fake;
4458                 data_fake.flags = 0;
4459                 data_fake.pos_delta = delta;
4460                 if (is_inf)
4461                     data_fake.flags |= SF_IS_INF;
4462                 if ( flags & SCF_DO_STCLASS && !scan->flags
4463                      && OP(scan) == IFMATCH ) { /* Lookahead */
4464                     cl_init(pRExC_state, &intrnl);
4465                     data_fake.start_class = &intrnl;
4466                     f |= SCF_DO_STCLASS_AND;
4467                 }
4468                 if (flags & SCF_WHILEM_VISITED_POS)
4469                     f |= SCF_WHILEM_VISITED_POS;
4470                 next = regnext(scan);
4471                 nscan = NEXTOPER(NEXTOPER(scan));
4472
4473                 *minnextp = study_chunk(pRExC_state, &nscan, minnextp, &deltanext, 
4474                     last, &data_fake, stopparen, recursed, NULL, f,depth+1);
4475                 if (scan->flags) {
4476                     if (deltanext) {
4477                         FAIL("Variable length lookbehind not implemented");
4478                     }
4479                     else if (*minnextp > (I32)U8_MAX) {
4480                         FAIL2("Lookbehind longer than %"UVuf" not implemented", (UV)U8_MAX);
4481                     }
4482                     scan->flags = (U8)*minnextp;
4483                 }
4484
4485                 *minnextp += min;
4486
4487                 if (f & SCF_DO_STCLASS_AND) {
4488                     const int was = TEST_SSC_EOS(data.start_class);
4489
4490                     cl_and(data->start_class, &intrnl);
4491                     if (was)
4492                         SET_SSC_EOS(data->start_class);
4493                 }
4494                 if (data) {
4495                     if (data_fake.flags & (SF_HAS_PAR|SF_IN_PAR))
4496                         pars++;
4497                     if (data_fake.flags & SF_HAS_EVAL)
4498                         data->flags |= SF_HAS_EVAL;
4499                     data->whilem_c = data_fake.whilem_c;
4500                     if ((flags & SCF_DO_SUBSTR) && data_fake.last_found) {
4501                         if (RExC_rx->minlen<*minnextp)
4502                             RExC_rx->minlen=*minnextp;
4503                         SCAN_COMMIT(pRExC_state, &data_fake, minnextp);
4504                         SvREFCNT_dec_NN(data_fake.last_found);
4505                         
4506                         if ( data_fake.minlen_fixed != minlenp ) 
4507                         {
4508                             data->offset_fixed= data_fake.offset_fixed;
4509                             data->minlen_fixed= data_fake.minlen_fixed;
4510                             data->lookbehind_fixed+= scan->flags;
4511                         }
4512                         if ( data_fake.minlen_float != minlenp )
4513                         {
4514                             data->minlen_float= data_fake.minlen_float;
4515                             data->offset_float_min=data_fake.offset_float_min;
4516                             data->offset_float_max=data_fake.offset_float_max;
4517                             data->lookbehind_float+= scan->flags;
4518                         }
4519                     }
4520                 }
4521             }
4522 #endif
4523         }
4524         else if (OP(scan) == OPEN) {
4525             if (stopparen != (I32)ARG(scan))
4526                 pars++;
4527         }
4528         else if (OP(scan) == CLOSE) {
4529             if (stopparen == (I32)ARG(scan)) {
4530                 break;
4531             }
4532             if ((I32)ARG(scan) == is_par) {
4533                 next = regnext(scan);
4534
4535                 if ( next && (OP(next) != WHILEM) && next < last)
4536                     is_par = 0;         /* Disable optimization */
4537             }
4538             if (data)
4539                 *(data->last_closep) = ARG(scan);
4540         }
4541         else if (OP(scan) == EVAL) {
4542                 if (data)
4543                     data->flags |= SF_HAS_EVAL;
4544         }
4545         else if ( PL_regkind[OP(scan)] == ENDLIKE ) {
4546             if (flags & SCF_DO_SUBSTR) {
4547                 SCAN_COMMIT(pRExC_state,data,minlenp);
4548                 flags &= ~SCF_DO_SUBSTR;
4549             }
4550             if (data && OP(scan)==ACCEPT) {
4551                 data->flags |= SCF_SEEN_ACCEPT;
4552                 if (stopmin > min)
4553                     stopmin = min;
4554             }
4555         }
4556         else if (OP(scan) == LOGICAL && scan->flags == 2) /* Embedded follows */
4557         {
4558                 if (flags & SCF_DO_SUBSTR) {
4559                     SCAN_COMMIT(pRExC_state,data,minlenp);
4560                     data->longest = &(data->longest_float);
4561                 }
4562                 is_inf = is_inf_internal = 1;
4563                 if (flags & SCF_DO_STCLASS_OR) /* Allow everything */
4564                     cl_anything(pRExC_state, data->start_class);
4565                 flags &= ~SCF_DO_STCLASS;
4566         }
4567         else if (OP(scan) == GPOS) {
4568             if (!(RExC_rx->extflags & RXf_GPOS_FLOAT) &&
4569                 !(delta || is_inf || (data && data->pos_delta))) 
4570             {
4571                 if (!(RExC_rx->extflags & RXf_ANCH) && (flags & SCF_DO_SUBSTR))
4572                     RExC_rx->extflags |= RXf_ANCH_GPOS;
4573                 if (RExC_rx->gofs < (U32)min)
4574                     RExC_rx->gofs = min;
4575             } else {
4576                 RExC_rx->extflags |= RXf_GPOS_FLOAT;
4577                 RExC_rx->gofs = 0;
4578             }       
4579         }
4580 #ifdef TRIE_STUDY_OPT
4581 #ifdef FULL_TRIE_STUDY
4582         else if (PL_regkind[OP(scan)] == TRIE) {
4583             /* NOTE - There is similar code to this block above for handling
4584                BRANCH nodes on the initial study.  If you change stuff here
4585                check there too. */
4586             regnode *trie_node= scan;
4587             regnode *tail= regnext(scan);
4588             reg_trie_data *trie = (reg_trie_data*)RExC_rxi->data->data[ ARG(scan) ];
4589             I32 max1 = 0, min1 = I32_MAX;
4590             struct regnode_charclass_class accum;
4591
4592             if (flags & SCF_DO_SUBSTR) /* XXXX Add !SUSPEND? */
4593                 SCAN_COMMIT(pRExC_state, data,minlenp); /* Cannot merge strings after this. */
4594             if (flags & SCF_DO_STCLASS)
4595                 cl_init_zero(pRExC_state, &accum);
4596                 
4597             if (!trie->jump) {
4598                 min1= trie->minlen;
4599                 max1= trie->maxlen;
4600             } else {
4601                 const regnode *nextbranch= NULL;
4602                 U32 word;
4603                 
4604                 for ( word=1 ; word <= trie->wordcount ; word++) 
4605                 {
4606                     I32 deltanext=0, minnext=0, f = 0, fake;
4607                     struct regnode_charclass_class this_class;
4608                     
4609                     data_fake.flags = 0;
4610                     if (data) {
4611                         data_fake.whilem_c = data->whilem_c;
4612                         data_fake.last_closep = data->last_closep;
4613                     }
4614                     else
4615                         data_fake.last_closep = &fake;
4616                     data_fake.pos_delta = delta;
4617                     if (flags & SCF_DO_STCLASS) {
4618                         cl_init(pRExC_state, &this_class);
4619                         data_fake.start_class = &this_class;
4620                         f = SCF_DO_STCLASS_AND;
4621                     }
4622                     if (flags & SCF_WHILEM_VISITED_POS)
4623                         f |= SCF_WHILEM_VISITED_POS;
4624     
4625                     if (trie->jump[word]) {
4626                         if (!nextbranch)
4627                             nextbranch = trie_node + trie->jump[0];
4628                         scan= trie_node + trie->jump[word];
4629                         /* We go from the jump point to the branch that follows
4630                            it. Note this means we need the vestigal unused branches
4631                            even though they arent otherwise used.
4632                          */
4633                         minnext = study_chunk(pRExC_state, &scan, minlenp, 
4634                             &deltanext, (regnode *)nextbranch, &data_fake, 
4635                             stopparen, recursed, NULL, f,depth+1);
4636                     }
4637                     if (nextbranch && PL_regkind[OP(nextbranch)]==BRANCH)
4638                         nextbranch= regnext((regnode*)nextbranch);
4639                     
4640                     if (min1 > (I32)(minnext + trie->minlen))
4641                         min1 = minnext + trie->minlen;
4642                     if (deltanext == I32_MAX) {
4643                         is_inf = is_inf_internal = 1;
4644                         max1 = I32_MAX;
4645                     } else if (max1 < (I32)(minnext + deltanext + trie->maxlen))
4646                         max1 = minnext + deltanext + trie->maxlen;
4647                     
4648                     if (data_fake.flags & (SF_HAS_PAR|SF_IN_PAR))
4649                         pars++;
4650                     if (data_fake.flags & SCF_SEEN_ACCEPT) {
4651                         if ( stopmin > min + min1) 
4652                             stopmin = min + min1;
4653                         flags &= ~SCF_DO_SUBSTR;
4654                         if (data)
4655                             data->flags |= SCF_SEEN_ACCEPT;
4656                     }
4657                     if (data) {
4658                         if (data_fake.flags & SF_HAS_EVAL)
4659                             data->flags |= SF_HAS_EVAL;
4660                         data->whilem_c = data_fake.whilem_c;
4661                     }
4662                     if (flags & SCF_DO_STCLASS)
4663                         cl_or(pRExC_state, &accum, &this_class);
4664                 }
4665             }
4666             if (flags & SCF_DO_SUBSTR) {
4667                 data->pos_min += min1;
4668                 data->pos_delta += max1 - min1;
4669                 if (max1 != min1 || is_inf)
4670                     data->longest = &(data->longest_float);
4671             }
4672             min += min1;
4673             delta += max1 - min1;
4674             if (flags & SCF_DO_STCLASS_OR) {
4675                 cl_or(pRExC_state, data->start_class, &accum);
4676                 if (min1) {
4677                     cl_and(data->start_class, and_withp);
4678                     flags &= ~SCF_DO_STCLASS;
4679                 }
4680             }
4681             else if (flags & SCF_DO_STCLASS_AND) {
4682                 if (min1) {
4683                     cl_and(data->start_class, &accum);
4684                     flags &= ~SCF_DO_STCLASS;
4685                 }
4686                 else {
4687                     /* Switch to OR mode: cache the old value of
4688                      * data->start_class */
4689                     INIT_AND_WITHP;
4690                     StructCopy(data->start_class, and_withp,
4691                                struct regnode_charclass_class);
4692                     flags &= ~SCF_DO_STCLASS_AND;
4693                     StructCopy(&accum, data->start_class,
4694                                struct regnode_charclass_class);
4695                     flags |= SCF_DO_STCLASS_OR;
4696                     SET_SSC_EOS(data->start_class);
4697                 }
4698             }
4699             scan= tail;
4700             continue;
4701         }
4702 #else
4703         else if (PL_regkind[OP(scan)] == TRIE) {
4704             reg_trie_data *trie = (reg_trie_data*)RExC_rxi->data->data[ ARG(scan) ];
4705             U8*bang=NULL;
4706             
4707             min += trie->minlen;
4708             delta += (trie->maxlen - trie->minlen);
4709             flags &= ~SCF_DO_STCLASS; /* xxx */
4710             if (flags & SCF_DO_SUBSTR) {
4711                 SCAN_COMMIT(pRExC_state,data,minlenp);  /* Cannot expect anything... */
4712                 data->pos_min += trie->minlen;
4713                 data->pos_delta += (trie->maxlen - trie->minlen);
4714                 if (trie->maxlen != trie->minlen)
4715                     data->longest = &(data->longest_float);
4716             }
4717             if (trie->jump) /* no more substrings -- for now /grr*/
4718                 flags &= ~SCF_DO_SUBSTR; 
4719         }
4720 #endif /* old or new */
4721 #endif /* TRIE_STUDY_OPT */
4722
4723         /* Else: zero-length, ignore. */
4724         scan = regnext(scan);
4725     }
4726     if (frame) {
4727         last = frame->last;
4728         scan = frame->next;
4729         stopparen = frame->stop;
4730         frame = frame->prev;
4731         goto fake_study_recurse;
4732     }
4733
4734   finish:
4735     assert(!frame);
4736     DEBUG_STUDYDATA("pre-fin:",data,depth);
4737
4738     *scanp = scan;
4739     *deltap = is_inf_internal ? I32_MAX : delta;
4740     if (flags & SCF_DO_SUBSTR && is_inf)
4741         data->pos_delta = I32_MAX - data->pos_min;
4742     if (is_par > (I32)U8_MAX)
4743         is_par = 0;
4744     if (is_par && pars==1 && data) {
4745         data->flags |= SF_IN_PAR;
4746         data->flags &= ~SF_HAS_PAR;
4747     }
4748     else if (pars && data) {
4749         data->flags |= SF_HAS_PAR;
4750         data->flags &= ~SF_IN_PAR;
4751     }
4752     if (flags & SCF_DO_STCLASS_OR)
4753         cl_and(data->start_class, and_withp);
4754     if (flags & SCF_TRIE_RESTUDY)
4755         data->flags |=  SCF_TRIE_RESTUDY;
4756     
4757     DEBUG_STUDYDATA("post-fin:",data,depth);
4758     
4759     return min < stopmin ? min : stopmin;
4760 }
4761
4762 STATIC U32
4763 S_add_data(RExC_state_t *pRExC_state, U32 n, const char *s)
4764 {
4765     U32 count = RExC_rxi->data ? RExC_rxi->data->count : 0;
4766
4767     PERL_ARGS_ASSERT_ADD_DATA;
4768
4769     Renewc(RExC_rxi->data,
4770            sizeof(*RExC_rxi->data) + sizeof(void*) * (count + n - 1),
4771            char, struct reg_data);
4772     if(count)
4773         Renew(RExC_rxi->data->what, count + n, U8);
4774     else
4775         Newx(RExC_rxi->data->what, n, U8);
4776     RExC_rxi->data->count = count + n;
4777     Copy(s, RExC_rxi->data->what + count, n, U8);
4778     return count;
4779 }
4780
4781 /*XXX: todo make this not included in a non debugging perl */
4782 #ifndef PERL_IN_XSUB_RE
4783 void
4784 Perl_reginitcolors(pTHX)
4785 {
4786     dVAR;
4787     const char * const s = PerlEnv_getenv("PERL_RE_COLORS");
4788     if (s) {
4789         char *t = savepv(s);
4790         int i = 0;
4791         PL_colors[0] = t;
4792         while (++i < 6) {
4793             t = strchr(t, '\t');
4794             if (t) {
4795                 *t = '\0';
4796                 PL_colors[i] = ++t;
4797             }
4798             else
4799                 PL_colors[i] = t = (char *)"";
4800         }
4801     } else {
4802         int i = 0;
4803         while (i < 6)
4804             PL_colors[i++] = (char *)"";
4805     }
4806     PL_colorset = 1;
4807 }
4808 #endif
4809
4810
4811 #ifdef TRIE_STUDY_OPT
4812 #define CHECK_RESTUDY_GOTO_butfirst(dOsomething)            \
4813     STMT_START {                                            \
4814         if (                                                \
4815               (data.flags & SCF_TRIE_RESTUDY)               \
4816               && ! restudied++                              \
4817         ) {                                                 \
4818             dOsomething;                                    \
4819             goto reStudy;                                   \
4820         }                                                   \
4821     } STMT_END
4822 #else
4823 #define CHECK_RESTUDY_GOTO_butfirst
4824 #endif        
4825
4826 /*
4827  * pregcomp - compile a regular expression into internal code
4828  *
4829  * Decides which engine's compiler to call based on the hint currently in
4830  * scope
4831  */
4832
4833 #ifndef PERL_IN_XSUB_RE 
4834
4835 /* return the currently in-scope regex engine (or the default if none)  */
4836
4837 regexp_engine const *
4838 Perl_current_re_engine(pTHX)
4839 {
4840     dVAR;
4841
4842     if (IN_PERL_COMPILETIME) {
4843         HV * const table = GvHV(PL_hintgv);
4844         SV **ptr;
4845
4846         if (!table)
4847             return &PL_core_reg_engine;
4848         ptr = hv_fetchs(table, "regcomp", FALSE);
4849         if ( !(ptr && SvIOK(*ptr) && SvIV(*ptr)))
4850             return &PL_core_reg_engine;
4851         return INT2PTR(regexp_engine*,SvIV(*ptr));
4852     }
4853     else {
4854         SV *ptr;
4855         if (!PL_curcop->cop_hints_hash)
4856             return &PL_core_reg_engine;
4857         ptr = cop_hints_fetch_pvs(PL_curcop, "regcomp", 0);
4858         if ( !(ptr && SvIOK(ptr) && SvIV(ptr)))
4859             return &PL_core_reg_engine;
4860         return INT2PTR(regexp_engine*,SvIV(ptr));
4861     }
4862 }
4863
4864
4865 REGEXP *
4866 Perl_pregcomp(pTHX_ SV * const pattern, const U32 flags)
4867 {
4868     dVAR;
4869     regexp_engine const *eng = current_re_engine();
4870     GET_RE_DEBUG_FLAGS_DECL;
4871
4872     PERL_ARGS_ASSERT_PREGCOMP;
4873
4874     /* Dispatch a request to compile a regexp to correct regexp engine. */
4875     DEBUG_COMPILE_r({
4876         PerlIO_printf(Perl_debug_log, "Using engine %"UVxf"\n",
4877                         PTR2UV(eng));
4878     });
4879     return CALLREGCOMP_ENG(eng, pattern, flags);
4880 }
4881 #endif
4882
4883 /* public(ish) entry point for the perl core's own regex compiling code.
4884  * It's actually a wrapper for Perl_re_op_compile that only takes an SV
4885  * pattern rather than a list of OPs, and uses the internal engine rather
4886  * than the current one */
4887
4888 REGEXP *
4889 Perl_re_compile(pTHX_ SV * const pattern, U32 rx_flags)
4890 {
4891     SV *pat = pattern; /* defeat constness! */
4892     PERL_ARGS_ASSERT_RE_COMPILE;
4893     return Perl_re_op_compile(aTHX_ &pat, 1, NULL,
4894 #ifdef PERL_IN_XSUB_RE
4895                                 &my_reg_engine,
4896 #else
4897                                 &PL_core_reg_engine,
4898 #endif
4899                                 NULL, NULL, rx_flags, 0);
4900 }
4901
4902
4903 /* upgrade pattern pat_p of length plen_p to UTF8, and if there are code
4904  * blocks, recalculate the indices. Update pat_p and plen_p in-place to
4905  * point to the realloced string and length.
4906  *
4907  * This is essentially a copy of Perl_bytes_to_utf8() with the code index
4908  * stuff added */
4909
4910 static void
4911 S_pat_upgrade_to_utf8(pTHX_ RExC_state_t * const pRExC_state,
4912                     char **pat_p, STRLEN *plen_p, int num_code_blocks)
4913 {
4914     U8 *const src = (U8*)*pat_p;
4915     U8 *dst;
4916     int n=0;
4917     STRLEN s = 0, d = 0;
4918     bool do_end = 0;
4919     GET_RE_DEBUG_FLAGS_DECL;
4920
4921     DEBUG_PARSE_r(PerlIO_printf(Perl_debug_log,
4922         "UTF8 mismatch! Converting to utf8 for resizing and compile\n"));
4923
4924     Newx(dst, *plen_p * 2 + 1, U8);
4925
4926     while (s < *plen_p) {
4927         const UV uv = NATIVE_TO_ASCII(src[s]);
4928         if (UNI_IS_INVARIANT(uv))
4929             dst[d]   = (U8)UTF_TO_NATIVE(uv);
4930         else {
4931             dst[d++] = (U8)UTF8_EIGHT_BIT_HI(uv);
4932             dst[d]   = (U8)UTF8_EIGHT_BIT_LO(uv);
4933         }
4934         if (n < num_code_blocks) {
4935             if (!do_end && pRExC_state->code_blocks[n].start == s) {
4936                 pRExC_state->code_blocks[n].start = d;
4937                 assert(dst[d] == '(');
4938                 do_end = 1;
4939             }
4940             else if (do_end && pRExC_state->code_blocks[n].end == s) {
4941                 pRExC_state->code_blocks[n].end = d;
4942                 assert(dst[d] == ')');
4943                 do_end = 0;
4944                 n++;
4945             }
4946         }
4947         s++;
4948         d++;
4949     }
4950     dst[d] = '\0';
4951     *plen_p = d;
4952     *pat_p = (char*) dst;
4953     SAVEFREEPV(*pat_p);
4954     RExC_orig_utf8 = RExC_utf8 = 1;
4955 }
4956
4957
4958
4959 /* S_concat_pat(): concatenate a list of args to the pattern string pat,
4960  * while recording any code block indices, and handling overloading,
4961  * nested qr// objects etc.  If pat is null, it will allocate a new
4962  * string, or just return the first arg, if there's only one.
4963  *
4964  * Returns the malloced/updated pat.
4965  * patternp and pat_count is the array of SVs to be concatted;
4966  * oplist is the optional list of ops that generated the SVs;
4967  * recompile_p is a pointer to a boolean that will be set if
4968  *   the regex will need to be recompiled.
4969  * delim, if non-null is an SV that will be inserted between each element
4970  */
4971
4972 static SV*
4973 S_concat_pat(pTHX_ RExC_state_t * const pRExC_state,
4974                 SV *pat, SV ** const patternp, int pat_count,
4975                 OP *oplist, bool *recompile_p, SV *delim)
4976 {
4977     SV **svp;
4978     int n = 0;
4979     bool use_delim = FALSE;
4980     bool alloced = FALSE;
4981
4982     /* if we know we have at least two args, create an empty string,
4983      * then concatenate args to that. For no args, return an empty string */
4984     if (!pat && pat_count != 1) {
4985         pat = newSVpvn("", 0);
4986         SAVEFREESV(pat);
4987         alloced = TRUE;
4988     }
4989
4990     for (svp = patternp; svp < patternp + pat_count; svp++) {
4991         SV *sv;
4992         SV *rx  = NULL;
4993         STRLEN orig_patlen = 0;
4994         bool code = 0;
4995         SV *msv = use_delim ? delim : *svp;
4996
4997         /* if we've got a delimiter, we go round the loop twice for each
4998          * svp slot (except the last), using the delimiter the second
4999          * time round */
5000         if (use_delim) {
5001             svp--;
5002             use_delim = FALSE;
5003         }
5004         else if (delim)
5005             use_delim = TRUE;
5006
5007         if (SvTYPE(msv) == SVt_PVAV) {
5008             /* we've encountered an interpolated array within
5009              * the pattern, e.g. /...@a..../. Expand the list of elements,
5010              * then recursively append elements.
5011              * The code in this block is based on S_pushav() */
5012
5013             AV *const av = (AV*)msv;
5014             const I32 maxarg = AvFILL(av) + 1;
5015             SV **array;
5016
5017             if (oplist) {
5018                 assert(oplist->op_type == OP_PADAV
5019                     || oplist->op_type == OP_RV2AV); 
5020                 oplist = oplist->op_sibling;;
5021             }
5022
5023             if (SvRMAGICAL(av)) {
5024                 U32 i;
5025
5026                 Newx(array, maxarg, SV*);
5027                 SAVEFREEPV(array);
5028                 for (i=0; i < (U32)maxarg; i++) {
5029                     SV ** const svp = av_fetch(av, i, FALSE);
5030                     array[i] = svp ? *svp : &PL_sv_undef;
5031                 }
5032             }
5033             else
5034                 array = AvARRAY(av);
5035
5036             pat = S_concat_pat(aTHX_ pRExC_state, pat,
5037                                 array, maxarg, NULL, recompile_p,
5038                                 /* $" */
5039                                 GvSV((gv_fetchpvs("\"", GV_ADDMULTI, SVt_PV))));
5040
5041             continue;
5042         }
5043
5044
5045         /* we make the assumption here that each op in the list of
5046          * op_siblings maps to one SV pushed onto the stack,
5047          * except for code blocks, with have both an OP_NULL and
5048          * and OP_CONST.
5049          * This allows us to match up the list of SVs against the
5050          * list of OPs to find the next code block.
5051          *
5052          * Note that       PUSHMARK PADSV PADSV ..
5053          * is optimised to
5054          *                 PADRANGE PADSV  PADSV  ..
5055          * so the alignment still works. */
5056
5057         if (oplist) {
5058             if (oplist->op_type == OP_NULL
5059                 && (oplist->op_flags & OPf_SPECIAL))
5060             {
5061                 assert(n < pRExC_state->num_code_blocks);
5062                 pRExC_state->code_blocks[n].start = pat ? SvCUR(pat) : 0;
5063                 pRExC_state->code_blocks[n].block = oplist;
5064                 pRExC_state->code_blocks[n].src_regex = NULL;
5065                 n++;
5066                 code = 1;
5067                 oplist = oplist->op_sibling; /* skip CONST */
5068                 assert(oplist);
5069             }
5070             oplist = oplist->op_sibling;;
5071         }
5072
5073         /* apply magic and QR overloading to arg */
5074
5075         SvGETMAGIC(msv);
5076         if (SvROK(msv) && SvAMAGIC(msv)) {
5077             SV *sv = AMG_CALLunary(msv, regexp_amg);
5078             if (sv) {
5079                 if (SvROK(sv))
5080                     sv = SvRV(sv);
5081                 if (SvTYPE(sv) != SVt_REGEXP)
5082                     Perl_croak(aTHX_ "Overloaded qr did not return a REGEXP");
5083                 msv = sv;
5084             }
5085         }
5086
5087         /* try concatenation overload ... */
5088         if (pat && (SvAMAGIC(pat) || SvAMAGIC(msv)) &&
5089                 (sv = amagic_call(pat, msv, concat_amg, AMGf_assign)))
5090         {
5091             sv_setsv(pat, sv);
5092             /* overloading involved: all bets are off over literal
5093              * code. Pretend we haven't seen it */
5094             pRExC_state->num_code_blocks -= n;
5095             n = 0;
5096         }
5097         else  {
5098             /* ... or failing that, try "" overload */
5099             while (SvAMAGIC(msv)
5100                     && (sv = AMG_CALLunary(msv, string_amg))
5101                     && sv != msv
5102                     &&  !(   SvROK(msv)
5103                           && SvROK(sv)
5104                           && SvRV(msv) == SvRV(sv))
5105             ) {
5106                 msv = sv;
5107                 SvGETMAGIC(msv);
5108             }
5109             if (SvROK(msv) && SvTYPE(SvRV(msv)) == SVt_REGEXP)
5110                 msv = SvRV(msv);
5111
5112             if (pat) {
5113                 /* this is a partially unrolled
5114                  *     sv_catsv_nomg(pat, msv);
5115                  * that allows us to adjust code block indices if
5116                  * needed */
5117                 STRLEN slen, dlen;
5118                 char *dst = SvPV_force_nomg(pat, dlen);
5119                 const char *src = SvPV_flags_const(msv, slen, 0);
5120                 orig_patlen = dlen;
5121                 if (SvUTF8(msv) && !SvUTF8(pat)) {
5122                     S_pat_upgrade_to_utf8(aTHX_ pRExC_state, &dst, &dlen, n);
5123                     sv_setpvn(pat, dst, dlen);
5124                     SvUTF8_on(pat);
5125                 }
5126                 sv_catpvn_nomg(pat, src, slen);
5127                 rx = msv;
5128             }
5129             else
5130                 pat = msv;
5131
5132             if (code)
5133                 pRExC_state->code_blocks[n-1].end = SvCUR(pat)-1;
5134         }
5135
5136         /* extract any code blocks within any embedded qr//'s */
5137         if (rx && SvTYPE(rx) == SVt_REGEXP
5138             && RX_ENGINE((REGEXP*)rx)->op_comp)
5139         {
5140
5141             RXi_GET_DECL(ReANY((REGEXP *)rx), ri);
5142             if (ri->num_code_blocks) {
5143                 int i;
5144                 /* the presence of an embedded qr// with code means
5145                  * we should always recompile: the text of the
5146                  * qr// may not have changed, but it may be a
5147                  * different closure than last time */
5148                 *recompile_p = 1;
5149                 Renew(pRExC_state->code_blocks,
5150                     pRExC_state->num_code_blocks + ri->num_code_blocks,
5151                     struct reg_code_block);
5152                 pRExC_state->num_code_blocks += ri->num_code_blocks;
5153
5154                 for (i=0; i < ri->num_code_blocks; i++) {
5155                     struct reg_code_block *src, *dst;
5156                     STRLEN offset =  orig_patlen
5157                         + ReANY((REGEXP *)rx)->pre_prefix;
5158                     assert(n < pRExC_state->num_code_blocks);
5159                     src = &ri->code_blocks[i];
5160                     dst = &pRExC_state->code_blocks[n];
5161                     dst->start      = src->start + offset;
5162                     dst->end        = src->end   + offset;
5163                     dst->block      = src->block;
5164                     dst->src_regex  = (REGEXP*) SvREFCNT_inc( (SV*)
5165                                             src->src_regex
5166                                                 ? src->src_regex
5167                                                 : (REGEXP*)rx);
5168                     n++;
5169                 }
5170             }
5171         }
5172     }
5173     /* avoid calling magic multiple times on a single element e.g. =~ $qr */
5174     if (alloced)
5175         SvSETMAGIC(pat);
5176
5177     return pat;
5178 }
5179
5180
5181
5182 /* see if there are any run-time code blocks in the pattern.
5183  * False positives are allowed */
5184
5185 static bool
5186 S_has_runtime_code(pTHX_ RExC_state_t * const pRExC_state,
5187                     char *pat, STRLEN plen)
5188 {
5189     int n = 0;
5190     STRLEN s;
5191
5192     for (s = 0; s < plen; s++) {
5193         if (n < pRExC_state->num_code_blocks
5194             && s == pRExC_state->code_blocks[n].start)
5195         {
5196             s = pRExC_state->code_blocks[n].end;
5197             n++;
5198             continue;
5199         }
5200         /* TODO ideally should handle [..], (#..), /#.../x to reduce false
5201          * positives here */
5202         if (pat[s] == '(' && s+2 <= plen && pat[s+1] == '?' &&
5203             (pat[s+2] == '{'
5204                 || (s + 2 <= plen && pat[s+2] == '?' && pat[s+3] == '{'))
5205         )
5206             return 1;
5207     }
5208     return 0;
5209 }
5210
5211 /* Handle run-time code blocks. We will already have compiled any direct
5212  * or indirect literal code blocks. Now, take the pattern 'pat' and make a
5213  * copy of it, but with any literal code blocks blanked out and
5214  * appropriate chars escaped; then feed it into
5215  *
5216  *    eval "qr'modified_pattern'"
5217  *
5218  * For example,
5219  *
5220  *       a\bc(?{"this was literal"})def'ghi\\jkl(?{"this is runtime"})mno
5221  *
5222  * becomes
5223  *
5224  *    qr'a\\bc_______________________def\'ghi\\\\jkl(?{"this is runtime"})mno'
5225  *
5226  * After eval_sv()-ing that, grab any new code blocks from the returned qr
5227  * and merge them with any code blocks of the original regexp.
5228  *
5229  * If the pat is non-UTF8, while the evalled qr is UTF8, don't merge;
5230  * instead, just save the qr and return FALSE; this tells our caller that
5231  * the original pattern needs upgrading to utf8.
5232  */
5233
5234 static bool
5235 S_compile_runtime_code(pTHX_ RExC_state_t * const pRExC_state,
5236     char *pat, STRLEN plen)
5237 {
5238     SV *qr;
5239
5240     GET_RE_DEBUG_FLAGS_DECL;
5241
5242     if (pRExC_state->runtime_code_qr) {
5243         /* this is the second time we've been called; this should
5244          * only happen if the main pattern got upgraded to utf8
5245          * during compilation; re-use the qr we compiled first time
5246          * round (which should be utf8 too)
5247          */
5248         qr = pRExC_state->runtime_code_qr;
5249         pRExC_state->runtime_code_qr = NULL;
5250         assert(RExC_utf8 && SvUTF8(qr));
5251     }
5252     else {
5253         int n = 0;
5254         STRLEN s;
5255         char *p, *newpat;
5256         int newlen = plen + 6; /* allow for "qr''x\0" extra chars */
5257         SV *sv, *qr_ref;
5258         dSP;
5259
5260         /* determine how many extra chars we need for ' and \ escaping */
5261         for (s = 0; s < plen; s++) {
5262             if (pat[s] == '\'' || pat[s] == '\\')
5263                 newlen++;
5264         }
5265
5266         Newx(newpat, newlen, char);
5267         p = newpat;
5268         *p++ = 'q'; *p++ = 'r'; *p++ = '\'';
5269
5270         for (s = 0; s < plen; s++) {
5271             if (n < pRExC_state->num_code_blocks
5272                 && s == pRExC_state->code_blocks[n].start)
5273             {
5274                 /* blank out literal code block */
5275                 assert(pat[s] == '(');
5276                 while (s <= pRExC_state->code_blocks[n].end) {
5277                     *p++ = '_';
5278                     s++;
5279                 }
5280                 s--;
5281                 n++;
5282                 continue;
5283             }
5284             if (pat[s] == '\'' || pat[s] == '\\')
5285                 *p++ = '\\';
5286             *p++ = pat[s];
5287         }
5288         *p++ = '\'';
5289         if (pRExC_state->pm_flags & RXf_PMf_EXTENDED)
5290             *p++ = 'x';
5291         *p++ = '\0';
5292         DEBUG_COMPILE_r({
5293             PerlIO_printf(Perl_debug_log,
5294                 "%sre-parsing pattern for runtime code:%s %s\n",
5295                 PL_colors[4],PL_colors[5],newpat);
5296         });
5297
5298         sv = newSVpvn_flags(newpat, p-newpat-1, RExC_utf8 ? SVf_UTF8 : 0);
5299         Safefree(newpat);
5300
5301         ENTER;
5302         SAVETMPS;
5303         save_re_context();
5304         PUSHSTACKi(PERLSI_REQUIRE);
5305         /* G_RE_REPARSING causes the toker to collapse \\ into \ when
5306          * parsing qr''; normally only q'' does this. It also alters
5307          * hints handling */
5308         eval_sv(sv, G_SCALAR|G_RE_REPARSING);
5309         SvREFCNT_dec_NN(sv);
5310         SPAGAIN;
5311         qr_ref = POPs;
5312         PUTBACK;
5313         {
5314             SV * const errsv = ERRSV;
5315             if (SvTRUE_NN(errsv))
5316             {
5317                 Safefree(pRExC_state->code_blocks);
5318                 /* use croak_sv ? */
5319                 Perl_croak_nocontext("%s", SvPV_nolen_const(errsv));
5320             }
5321         }
5322         assert(SvROK(qr_ref));
5323         qr = SvRV(qr_ref);
5324         assert(SvTYPE(qr) == SVt_REGEXP && RX_ENGINE((REGEXP*)qr)->op_comp);
5325         /* the leaving below frees the tmp qr_ref.
5326          * Give qr a life of its own */
5327         SvREFCNT_inc(qr);
5328         POPSTACK;
5329         FREETMPS;
5330         LEAVE;
5331
5332     }
5333
5334     if (!RExC_utf8 && SvUTF8(qr)) {
5335         /* first time through; the pattern got upgraded; save the
5336          * qr for the next time through */
5337         assert(!pRExC_state->runtime_code_qr);
5338         pRExC_state->runtime_code_qr = qr;
5339         return 0;
5340     }
5341
5342
5343     /* extract any code blocks within the returned qr//  */
5344
5345
5346     /* merge the main (r1) and run-time (r2) code blocks into one */
5347     {
5348         RXi_GET_DECL(ReANY((REGEXP *)qr), r2);
5349         struct reg_code_block *new_block, *dst;
5350         RExC_state_t * const r1 = pRExC_state; /* convenient alias */
5351         int i1 = 0, i2 = 0;
5352
5353         if (!r2->num_code_blocks) /* we guessed wrong */
5354         {
5355             SvREFCNT_dec_NN(qr);
5356             return 1;
5357         }
5358
5359         Newx(new_block,
5360             r1->num_code_blocks + r2->num_code_blocks,
5361             struct reg_code_block);
5362         dst = new_block;
5363
5364         while (    i1 < r1->num_code_blocks
5365                 || i2 < r2->num_code_blocks)
5366         {
5367             struct reg_code_block *src;
5368             bool is_qr = 0;
5369
5370             if (i1 == r1->num_code_blocks) {
5371                 src = &r2->code_blocks[i2++];
5372                 is_qr = 1;
5373             }
5374             else if (i2 == r2->num_code_blocks)
5375                 src = &r1->code_blocks[i1++];
5376             else if (  r1->code_blocks[i1].start
5377                      < r2->code_blocks[i2].start)
5378             {
5379                 src = &r1->code_blocks[i1++];
5380                 assert(src->end < r2->code_blocks[i2].start);
5381             }
5382             else {
5383                 assert(  r1->code_blocks[i1].start
5384                        > r2->code_blocks[i2].start);
5385                 src = &r2->code_blocks[i2++];
5386                 is_qr = 1;
5387                 assert(src->end < r1->code_blocks[i1].start);
5388             }
5389
5390             assert(pat[src->start] == '(');
5391             assert(pat[src->end]   == ')');
5392             dst->start      = src->start;
5393             dst->end        = src->end;
5394             dst->block      = src->block;
5395             dst->src_regex  = is_qr ? (REGEXP*) SvREFCNT_inc( (SV*) qr)
5396                                     : src->src_regex;
5397             dst++;
5398         }
5399         r1->num_code_blocks += r2->num_code_blocks;
5400         Safefree(r1->code_blocks);
5401         r1->code_blocks = new_block;
5402     }
5403
5404     SvREFCNT_dec_NN(qr);
5405     return 1;
5406 }
5407
5408
5409 STATIC bool
5410 S_setup_longest(pTHX_ RExC_state_t *pRExC_state, SV* sv_longest, SV** rx_utf8, SV** rx_substr, I32* rx_end_shift, I32 lookbehind, I32 offset, I32 *minlen, STRLEN longest_length, bool eol, bool meol)
5411 {
5412     /* This is the common code for setting up the floating and fixed length
5413      * string data extracted from Perl_re_op_compile() below.  Returns a boolean
5414      * as to whether succeeded or not */
5415
5416     I32 t,ml;
5417
5418     if (! (longest_length
5419            || (eol /* Can't have SEOL and MULTI */
5420                && (! meol || (RExC_flags & RXf_PMf_MULTILINE)))
5421           )
5422             /* See comments for join_exact for why REG_SEEN_EXACTF_SHARP_S */
5423         || (RExC_seen & REG_SEEN_EXACTF_SHARP_S))
5424     {
5425         return FALSE;
5426     }
5427
5428     /* copy the information about the longest from the reg_scan_data
5429         over to the program. */
5430     if (SvUTF8(sv_longest)) {
5431         *rx_utf8 = sv_longest;
5432         *rx_substr = NULL;
5433     } else {
5434         *rx_substr = sv_longest;
5435         *rx_utf8 = NULL;
5436     }
5437     /* end_shift is how many chars that must be matched that
5438         follow this item. We calculate it ahead of time as once the
5439         lookbehind offset is added in we lose the ability to correctly
5440         calculate it.*/
5441     ml = minlen ? *(minlen) : (I32)longest_length;
5442     *rx_end_shift = ml - offset
5443         - longest_length + (SvTAIL(sv_longest) != 0)
5444         + lookbehind;
5445
5446     t = (eol/* Can't have SEOL and MULTI */
5447          && (! meol || (RExC_flags & RXf_PMf_MULTILINE)));
5448     fbm_compile(sv_longest, t ? FBMcf_TAIL : 0);
5449
5450     return TRUE;
5451 }
5452
5453 /*
5454  * Perl_re_op_compile - the perl internal RE engine's function to compile a
5455  * regular expression into internal code.
5456  * The pattern may be passed either as:
5457  *    a list of SVs (patternp plus pat_count)
5458  *    a list of OPs (expr)
5459  * If both are passed, the SV list is used, but the OP list indicates
5460  * which SVs are actually pre-compiled code blocks
5461  *
5462  * The SVs in the list have magic and qr overloading applied to them (and
5463  * the list may be modified in-place with replacement SVs in the latter
5464  * case).
5465  *
5466  * If the pattern hasn't changed from old_re, then old_re will be
5467  * returned.
5468  *
5469  * eng is the current engine. If that engine has an op_comp method, then
5470  * handle directly (i.e. we assume that op_comp was us); otherwise, just
5471  * do the initial concatenation of arguments and pass on to the external
5472  * engine.
5473  *
5474  * If is_bare_re is not null, set it to a boolean indicating whether the
5475  * arg list reduced (after overloading) to a single bare regex which has
5476  * been returned (i.e. /$qr/).
5477  *
5478  * orig_rx_flags contains RXf_* flags. See perlreapi.pod for more details.
5479  *
5480  * pm_flags contains the PMf_* flags, typically based on those from the
5481  * pm_flags field of the related PMOP. Currently we're only interested in
5482  * PMf_HAS_CV, PMf_IS_QR, PMf_USE_RE_EVAL.
5483  *
5484  * We can't allocate space until we know how big the compiled form will be,
5485  * but we can't compile it (and thus know how big it is) until we've got a
5486  * place to put the code.  So we cheat:  we compile it twice, once with code
5487  * generation turned off and size counting turned on, and once "for real".
5488  * This also means that we don't allocate space until we are sure that the
5489  * thing really will compile successfully, and we never have to move the
5490  * code and thus invalidate pointers into it.  (Note that it has to be in
5491  * one piece because free() must be able to free it all.) [NB: not true in perl]
5492  *
5493  * Beware that the optimization-preparation code in here knows about some
5494  * of the structure of the compiled regexp.  [I'll say.]
5495  */
5496
5497 REGEXP *
5498 Perl_re_op_compile(pTHX_ SV ** const patternp, int pat_count,
5499                     OP *expr, const regexp_engine* eng, REGEXP *old_re,
5500                      bool *is_bare_re, U32 orig_rx_flags, U32 pm_flags)
5501 {
5502     dVAR;
5503     REGEXP *rx;
5504     struct regexp *r;
5505     regexp_internal *ri;
5506     STRLEN plen;
5507     char *exp;
5508     regnode *scan;
5509     I32 flags;
5510     I32 minlen = 0;
5511     U32 rx_flags;
5512     SV *pat;
5513     SV *code_blocksv = NULL;
5514     SV** new_patternp = patternp;
5515
5516     /* these are all flags - maybe they should be turned
5517      * into a single int with different bit masks */
5518     I32 sawlookahead = 0;
5519     I32 sawplus = 0;
5520     I32 sawopen = 0;
5521     regex_charset initial_charset = get_regex_charset(orig_rx_flags);
5522     bool recompile = 0;
5523     bool runtime_code = 0;
5524     scan_data_t data;
5525     RExC_state_t RExC_state;
5526     RExC_state_t * const pRExC_state = &RExC_state;
5527 #ifdef TRIE_STUDY_OPT    
5528     int restudied = 0;
5529     RExC_state_t copyRExC_state;
5530 #endif    
5531     GET_RE_DEBUG_FLAGS_DECL;
5532
5533     PERL_ARGS_ASSERT_RE_OP_COMPILE;
5534
5535     DEBUG_r(if (!PL_colorset) reginitcolors());
5536
5537 #ifndef PERL_IN_XSUB_RE
5538     /* Initialize these here instead of as-needed, as is quick and avoids
5539      * having to test them each time otherwise */
5540     if (! PL_AboveLatin1) {
5541         PL_AboveLatin1 = _new_invlist_C_array(AboveLatin1_invlist);
5542         PL_ASCII = _new_invlist_C_array(ASCII_invlist);
5543         PL_Latin1 = _new_invlist_C_array(Latin1_invlist);
5544
5545         PL_L1Posix_ptrs[_CC_ALPHANUMERIC]
5546                                 = _new_invlist_C_array(L1PosixAlnum_invlist);
5547         PL_Posix_ptrs[_CC_ALPHANUMERIC]
5548                                 = _new_invlist_C_array(PosixAlnum_invlist);
5549
5550         PL_L1Posix_ptrs[_CC_ALPHA]
5551                                 = _new_invlist_C_array(L1PosixAlpha_invlist);
5552         PL_Posix_ptrs[_CC_ALPHA] = _new_invlist_C_array(PosixAlpha_invlist);
5553
5554         PL_Posix_ptrs[_CC_BLANK] = _new_invlist_C_array(PosixBlank_invlist);
5555         PL_XPosix_ptrs[_CC_BLANK] = _new_invlist_C_array(XPosixBlank_invlist);
5556
5557         /* Cased is the same as Alpha in the ASCII range */
5558         PL_L1Posix_ptrs[_CC_CASED] =  _new_invlist_C_array(L1Cased_invlist);
5559         PL_Posix_ptrs[_CC_CASED] =  _new_invlist_C_array(PosixAlpha_invlist);
5560
5561         PL_Posix_ptrs[_CC_CNTRL] = _new_invlist_C_array(PosixCntrl_invlist);
5562         PL_XPosix_ptrs[_CC_CNTRL] = _new_invlist_C_array(XPosixCntrl_invlist);
5563
5564         PL_Posix_ptrs[_CC_DIGIT] = _new_invlist_C_array(PosixDigit_invlist);
5565         PL_L1Posix_ptrs[_CC_DIGIT] = _new_invlist_C_array(PosixDigit_invlist);
5566
5567         PL_L1Posix_ptrs[_CC_GRAPH] = _new_invlist_C_array(L1PosixGraph_invlist);
5568         PL_Posix_ptrs[_CC_GRAPH] = _new_invlist_C_array(PosixGraph_invlist);
5569
5570         PL_L1Posix_ptrs[_CC_LOWER] = _new_invlist_C_array(L1PosixLower_invlist);
5571         PL_Posix_ptrs[_CC_LOWER] = _new_invlist_C_array(PosixLower_invlist);
5572
5573         PL_L1Posix_ptrs[_CC_PRINT] = _new_invlist_C_array(L1PosixPrint_invlist);
5574         PL_Posix_ptrs[_CC_PRINT] = _new_invlist_C_array(PosixPrint_invlist);
5575
5576         PL_L1Posix_ptrs[_CC_PUNCT] = _new_invlist_C_array(L1PosixPunct_invlist);
5577         PL_Posix_ptrs[_CC_PUNCT] = _new_invlist_C_array(PosixPunct_invlist);
5578
5579         PL_Posix_ptrs[_CC_SPACE] = _new_invlist_C_array(PerlSpace_invlist);
5580         PL_XPosix_ptrs[_CC_SPACE] = _new_invlist_C_array(XPerlSpace_invlist);
5581         PL_Posix_ptrs[_CC_PSXSPC] = _new_invlist_C_array(PosixSpace_invlist);
5582         PL_XPosix_ptrs[_CC_PSXSPC] = _new_invlist_C_array(XPosixSpace_invlist);
5583
5584         PL_L1Posix_ptrs[_CC_UPPER] = _new_invlist_C_array(L1PosixUpper_invlist);
5585         PL_Posix_ptrs[_CC_UPPER] = _new_invlist_C_array(PosixUpper_invlist);
5586
5587         PL_XPosix_ptrs[_CC_VERTSPACE] = _new_invlist_C_array(VertSpace_invlist);
5588
5589         PL_Posix_ptrs[_CC_WORDCHAR] = _new_invlist_C_array(PosixWord_invlist);
5590         PL_L1Posix_ptrs[_CC_WORDCHAR]
5591                                 = _new_invlist_C_array(L1PosixWord_invlist);
5592
5593         PL_Posix_ptrs[_CC_XDIGIT] = _new_invlist_C_array(PosixXDigit_invlist);
5594         PL_XPosix_ptrs[_CC_XDIGIT] = _new_invlist_C_array(XPosixXDigit_invlist);
5595
5596         PL_HasMultiCharFold = _new_invlist_C_array(_Perl_Multi_Char_Folds_invlist);
5597     }
5598 #endif
5599
5600     pRExC_state->code_blocks = NULL;
5601     pRExC_state->num_code_blocks = 0;
5602
5603     if (is_bare_re)
5604         *is_bare_re = FALSE;
5605
5606     if (expr && (expr->op_type == OP_LIST ||
5607                 (expr->op_type == OP_NULL && expr->op_targ == OP_LIST))) {
5608         /* allocate code_blocks if needed */
5609         OP *o;
5610         int ncode = 0;
5611
5612         for (o = cLISTOPx(expr)->op_first; o; o = o->op_sibling)
5613             if (o->op_type == OP_NULL && (o->op_flags & OPf_SPECIAL))
5614                 ncode++; /* count of DO blocks */
5615         if (ncode) {
5616             pRExC_state->num_code_blocks = ncode;
5617             Newx(pRExC_state->code_blocks, ncode, struct reg_code_block);
5618         }
5619     }
5620
5621     if (!pat_count) {
5622         /* compile-time pattern with just OP_CONSTs and DO blocks */
5623
5624         int n;
5625         OP *o;
5626
5627         /* find how many CONSTs there are */
5628         assert(expr);
5629         n = 0;
5630         if (expr->op_type == OP_CONST)
5631             n = 1;
5632         else
5633             for (o = cLISTOPx(expr)->op_first; o; o = o->op_sibling) {
5634                 if (o->op_type == OP_CONST)
5635                     n++;
5636             }
5637
5638         /* fake up an SV array */
5639
5640         assert(!new_patternp);
5641         Newx(new_patternp, n, SV*);
5642         SAVEFREEPV(new_patternp);
5643         pat_count = n;
5644
5645         n = 0;
5646         if (expr->op_type == OP_CONST)
5647             new_patternp[n] = cSVOPx_sv(expr);
5648         else
5649             for (o = cLISTOPx(expr)->op_first; o; o = o->op_sibling) {
5650                 if (o->op_type == OP_CONST)
5651                     new_patternp[n++] = cSVOPo_sv;
5652             }
5653
5654     }
5655
5656     DEBUG_PARSE_r(PerlIO_printf(Perl_debug_log,
5657         "Assembling pattern from %d elements%s\n", pat_count,
5658             orig_rx_flags & RXf_SPLIT ? " for split" : ""));
5659
5660     /* set expr to the first arg op */
5661
5662     if (pRExC_state->num_code_blocks
5663          && expr->op_type != OP_CONST)
5664     {
5665             expr = cLISTOPx(expr)->op_first;
5666             assert(   expr->op_type == OP_PUSHMARK
5667                    || (expr->op_type == OP_NULL && expr->op_targ == OP_PUSHMARK)
5668                    || expr->op_type == OP_PADRANGE);
5669             expr = expr->op_sibling;
5670     }
5671
5672     pat = S_concat_pat(aTHX_ pRExC_state, NULL, new_patternp, pat_count,
5673                         expr, &recompile, NULL);
5674
5675     /* handle bare (possibly after overloading) regex: foo =~ $re */
5676     {
5677         SV *re = pat;
5678         if (SvROK(re))
5679             re = SvRV(re);
5680         if (SvTYPE(re) == SVt_REGEXP) {
5681             if (is_bare_re)
5682                 *is_bare_re = TRUE;
5683             SvREFCNT_inc(re);
5684             Safefree(pRExC_state->code_blocks);
5685             DEBUG_PARSE_r(PerlIO_printf(Perl_debug_log,
5686                 "Precompiled pattern%s\n",
5687                     orig_rx_flags & RXf_SPLIT ? " for split" : ""));
5688
5689             return (REGEXP*)re;
5690         }
5691     }
5692
5693     exp = SvPV_nomg(pat, plen);
5694
5695     if (!eng->op_comp) {
5696         if ((SvUTF8(pat) && IN_BYTES)
5697                 || SvGMAGICAL(pat) || SvAMAGIC(pat))
5698         {
5699             /* make a temporary copy; either to convert to bytes,
5700              * or to avoid repeating get-magic / overloaded stringify */
5701             pat = newSVpvn_flags(exp, plen, SVs_TEMP |
5702                                         (IN_BYTES ? 0 : SvUTF8(pat)));
5703         }
5704         Safefree(pRExC_state->code_blocks);
5705         return CALLREGCOMP_ENG(eng, pat, orig_rx_flags);
5706     }
5707
5708     /* ignore the utf8ness if the pattern is 0 length */
5709     RExC_utf8 = RExC_orig_utf8 = (plen == 0 || IN_BYTES) ? 0 : SvUTF8(pat);
5710     RExC_uni_semantics = 0;
5711     RExC_contains_locale = 0;
5712     pRExC_state->runtime_code_qr = NULL;
5713
5714     DEBUG_COMPILE_r({
5715             SV *dsv= sv_newmortal();
5716             RE_PV_QUOTED_DECL(s, RExC_utf8, dsv, exp, plen, 60);
5717             PerlIO_printf(Perl_debug_log, "%sCompiling REx%s %s\n",
5718                           PL_colors[4],PL_colors[5],s);
5719         });
5720
5721   redo_first_pass:
5722     /* we jump here if we upgrade the pattern to utf8 and have to
5723      * recompile */
5724
5725     if ((pm_flags & PMf_USE_RE_EVAL)
5726                 /* this second condition covers the non-regex literal case,
5727                  * i.e.  $foo =~ '(?{})'. */
5728                 || (IN_PERL_COMPILETIME && (PL_hints & HINT_RE_EVAL))
5729     )
5730         runtime_code = S_has_runtime_code(aTHX_ pRExC_state, exp, plen);
5731
5732     /* return old regex if pattern hasn't changed */
5733     /* XXX: note in the below we have to check the flags as well as the pattern.
5734      *
5735      * Things get a touch tricky as we have to compare the utf8 flag independently
5736      * from the compile flags.
5737      */
5738
5739     if (   old_re
5740         && !recompile
5741         && !!RX_UTF8(old_re) == !!RExC_utf8
5742         && ( RX_COMPFLAGS(old_re) == ( orig_rx_flags & RXf_PMf_FLAGCOPYMASK ) )
5743         && RX_PRECOMP(old_re)
5744         && RX_PRELEN(old_re) == plen
5745         && memEQ(RX_PRECOMP(old_re), exp, plen)
5746         && !runtime_code /* with runtime code, always recompile */ )
5747     {
5748         Safefree(pRExC_state->code_blocks);
5749         return old_re;
5750     }
5751
5752     rx_flags = orig_rx_flags;
5753
5754     if (initial_charset == REGEX_LOCALE_CHARSET) {
5755         RExC_contains_locale = 1;
5756     }
5757     else if (RExC_utf8 && initial_charset == REGEX_DEPENDS_CHARSET) {
5758
5759         /* Set to use unicode semantics if the pattern is in utf8 and has the
5760          * 'depends' charset specified, as it means unicode when utf8  */
5761         set_regex_charset(&rx_flags, REGEX_UNICODE_CHARSET);
5762     }
5763
5764     RExC_precomp = exp;
5765     RExC_flags = rx_flags;
5766     RExC_pm_flags = pm_flags;
5767
5768     if (runtime_code) {
5769         if (TAINTING_get && TAINT_get)
5770             Perl_croak(aTHX_ "Eval-group in insecure regular expression");
5771
5772         if (!S_compile_runtime_code(aTHX_ pRExC_state, exp, plen)) {
5773             /* whoops, we have a non-utf8 pattern, whilst run-time code
5774              * got compiled as utf8. Try again with a utf8 pattern */
5775             S_pat_upgrade_to_utf8(aTHX_ pRExC_state, &exp, &plen,
5776                                     pRExC_state->num_code_blocks);
5777             goto redo_first_pass;
5778         }
5779     }
5780     assert(!pRExC_state->runtime_code_qr);
5781
5782     RExC_sawback = 0;
5783
5784     RExC_seen = 0;
5785     RExC_in_lookbehind = 0;
5786     RExC_seen_zerolen = *exp == '^' ? -1 : 0;
5787     RExC_extralen = 0;
5788     RExC_override_recoding = 0;
5789     RExC_in_multi_char_class = 0;
5790
5791     /* First pass: determine size, legality. */
5792     RExC_parse = exp;
5793     RExC_start = exp;
5794     RExC_end = exp + plen;
5795     RExC_naughty = 0;
5796     RExC_npar = 1;
5797     RExC_nestroot = 0;
5798     RExC_size = 0L;
5799     RExC_emit = &PL_regdummy;
5800     RExC_whilem_seen = 0;
5801     RExC_open_parens = NULL;
5802     RExC_close_parens = NULL;
5803     RExC_opend = NULL;
5804     RExC_paren_names = NULL;
5805 #ifdef DEBUGGING
5806     RExC_paren_name_list = NULL;
5807 #endif
5808     RExC_recurse = NULL;
5809     RExC_recurse_count = 0;
5810     pRExC_state->code_index = 0;
5811
5812 #if 0 /* REGC() is (currently) a NOP at the first pass.
5813        * Clever compilers notice this and complain. --jhi */
5814     REGC((U8)REG_MAGIC, (char*)RExC_emit);
5815 #endif
5816     DEBUG_PARSE_r(
5817         PerlIO_printf(Perl_debug_log, "Starting first pass (sizing)\n");
5818         RExC_lastnum=0;
5819         RExC_lastparse=NULL;
5820     );
5821     /* reg may croak on us, not giving us a chance to free
5822        pRExC_state->code_blocks.  We cannot SAVEFREEPV it now, as we may
5823        need it to survive as long as the regexp (qr/(?{})/).
5824        We must check that code_blocksv is not already set, because we may
5825        have jumped back to restart the sizing pass. */
5826     if (pRExC_state->code_blocks && !code_blocksv) {
5827         code_blocksv = newSV_type(SVt_PV);
5828         SAVEFREESV(code_blocksv);
5829         SvPV_set(code_blocksv, (char *)pRExC_state->code_blocks);
5830         SvLEN_set(code_blocksv, 1); /*sufficient to make sv_clear free it*/
5831     }
5832     if (reg(pRExC_state, 0, &flags,1) == NULL) {
5833         /* It's possible to write a regexp in ascii that represents Unicode
5834         codepoints outside of the byte range, such as via \x{100}. If we
5835         detect such a sequence we have to convert the entire pattern to utf8
5836         and then recompile, as our sizing calculation will have been based
5837         on 1 byte == 1 character, but we will need to use utf8 to encode
5838         at least some part of the pattern, and therefore must convert the whole
5839         thing.
5840         -- dmq */
5841         if (flags & RESTART_UTF8) {
5842             S_pat_upgrade_to_utf8(aTHX_ pRExC_state, &exp, &plen,
5843                                     pRExC_state->num_code_blocks);
5844             goto redo_first_pass;
5845         }
5846         Perl_croak(aTHX_ "panic: reg returned NULL to re_op_compile for sizing pass, flags=%#"UVxf"", (UV) flags);
5847     }
5848     if (code_blocksv)
5849         SvLEN_set(code_blocksv,0); /* no you can't have it, sv_clear */
5850
5851     DEBUG_PARSE_r({
5852         PerlIO_printf(Perl_debug_log, 
5853             "Required size %"IVdf" nodes\n"
5854             "Starting second pass (creation)\n", 
5855             (IV)RExC_size);
5856         RExC_lastnum=0; 
5857         RExC_lastparse=NULL; 
5858     });
5859
5860     /* The first pass could have found things that force Unicode semantics */
5861     if ((RExC_utf8 || RExC_uni_semantics)
5862          && get_regex_charset(rx_flags) == REGEX_DEPENDS_CHARSET)
5863     {
5864         set_regex_charset(&rx_flags, REGEX_UNICODE_CHARSET);
5865     }
5866
5867     /* Small enough for pointer-storage convention?
5868        If extralen==0, this means that we will not need long jumps. */
5869     if (RExC_size >= 0x10000L && RExC_extralen)
5870         RExC_size += RExC_extralen;
5871     else
5872         RExC_extralen = 0;
5873     if (RExC_whilem_seen > 15)
5874         RExC_whilem_seen = 15;
5875
5876     /* Allocate space and zero-initialize. Note, the two step process 
5877        of zeroing when in debug mode, thus anything assigned has to 
5878        happen after that */
5879     rx = (REGEXP*) newSV_type(SVt_REGEXP);
5880     r = ReANY(rx);
5881     Newxc(ri, sizeof(regexp_internal) + (unsigned)RExC_size * sizeof(regnode),
5882          char, regexp_internal);
5883     if ( r == NULL || ri == NULL )
5884         FAIL("Regexp out of space");
5885 #ifdef DEBUGGING
5886     /* avoid reading uninitialized memory in DEBUGGING code in study_chunk() */
5887     Zero(ri, sizeof(regexp_internal) + (unsigned)RExC_size * sizeof(regnode), char);
5888 #else 
5889     /* bulk initialize base fields with 0. */
5890     Zero(ri, sizeof(regexp_internal), char);        
5891 #endif
5892
5893     /* non-zero initialization begins here */
5894     RXi_SET( r, ri );
5895     r->engine= eng;
5896     r->extflags = rx_flags;
5897     RXp_COMPFLAGS(r) = orig_rx_flags & RXf_PMf_FLAGCOPYMASK;
5898
5899     if (pm_flags & PMf_IS_QR) {
5900         ri->code_blocks = pRExC_state->code_blocks;
5901         ri->num_code_blocks = pRExC_state->num_code_blocks;
5902     }
5903     else
5904     {
5905         int n;
5906         for (n = 0; n < pRExC_state->num_code_blocks; n++)
5907             if (pRExC_state->code_blocks[n].src_regex)
5908                 SAVEFREESV(pRExC_state->code_blocks[n].src_regex);
5909         SAVEFREEPV(pRExC_state->code_blocks);
5910     }
5911
5912     {
5913         bool has_p     = ((r->extflags & RXf_PMf_KEEPCOPY) == RXf_PMf_KEEPCOPY);
5914         bool has_charset = (get_regex_charset(r->extflags) != REGEX_DEPENDS_CHARSET);
5915
5916         /* The caret is output if there are any defaults: if not all the STD
5917          * flags are set, or if no character set specifier is needed */
5918         bool has_default =
5919                     (((r->extflags & RXf_PMf_STD_PMMOD) != RXf_PMf_STD_PMMOD)
5920                     || ! has_charset);
5921         bool has_runon = ((RExC_seen & REG_SEEN_RUN_ON_COMMENT)==REG_SEEN_RUN_ON_COMMENT);
5922         U16 reganch = (U16)((r->extflags & RXf_PMf_STD_PMMOD)
5923                             >> RXf_PMf_STD_PMMOD_SHIFT);
5924         const char *fptr = STD_PAT_MODS;        /*"msix"*/
5925         char *p;
5926         /* Allocate for the worst case, which is all the std flags are turned
5927          * on.  If more precision is desired, we could do a population count of
5928          * the flags set.  This could be done with a small lookup table, or by
5929          * shifting, masking and adding, or even, when available, assembly
5930          * language for a machine-language population count.
5931          * We never output a minus, as all those are defaults, so are
5932          * covered by the caret */
5933         const STRLEN wraplen = plen + has_p + has_runon
5934             + has_default       /* If needs a caret */
5935
5936                 /* If needs a character set specifier */
5937             + ((has_charset) ? MAX_CHARSET_NAME_LENGTH : 0)
5938             + (sizeof(STD_PAT_MODS) - 1)
5939             + (sizeof("(?:)") - 1);
5940
5941         Newx(p, wraplen + 1, char); /* +1 for the ending NUL */
5942         r->xpv_len_u.xpvlenu_pv = p;
5943         if (RExC_utf8)
5944             SvFLAGS(rx) |= SVf_UTF8;
5945         *p++='('; *p++='?';
5946
5947         /* If a default, cover it using the caret */
5948         if (has_default) {
5949             *p++= DEFAULT_PAT_MOD;
5950         }
5951         if (has_charset) {
5952             STRLEN len;
5953             const char* const name = get_regex_charset_name(r->extflags, &len);
5954             Copy(name, p, len, char);
5955             p += len;
5956         }
5957         if (has_p)
5958             *p++ = KEEPCOPY_PAT_MOD; /*'p'*/
5959         {
5960             char ch;
5961             while((ch = *fptr++)) {
5962                 if(reganch & 1)
5963                     *p++ = ch;
5964                 reganch >>= 1;
5965             }
5966         }
5967
5968         *p++ = ':';
5969         Copy(RExC_precomp, p, plen, char);
5970         assert ((RX_WRAPPED(rx) - p) < 16);
5971         r->pre_prefix = p - RX_WRAPPED(rx);
5972         p += plen;
5973         if (has_runon)
5974             *p++ = '\n';
5975         *p++ = ')';
5976         *p = 0;
5977         SvCUR_set(rx, p - RX_WRAPPED(rx));
5978     }
5979
5980     r->intflags = 0;
5981     r->nparens = RExC_npar - 1; /* set early to validate backrefs */
5982     
5983     if (RExC_seen & REG_SEEN_RECURSE) {
5984         Newxz(RExC_open_parens, RExC_npar,regnode *);
5985         SAVEFREEPV(RExC_open_parens);
5986         Newxz(RExC_close_parens,RExC_npar,regnode *);
5987         SAVEFREEPV(RExC_close_parens);
5988     }
5989
5990     /* Useful during FAIL. */
5991 #ifdef RE_TRACK_PATTERN_OFFSETS
5992     Newxz(ri->u.offsets, 2*RExC_size+1, U32); /* MJD 20001228 */
5993     DEBUG_OFFSETS_r(PerlIO_printf(Perl_debug_log,
5994                           "%s %"UVuf" bytes for offset annotations.\n",
5995                           ri->u.offsets ? "Got" : "Couldn't get",
5996                           (UV)((2*RExC_size+1) * sizeof(U32))));
5997 #endif
5998     SetProgLen(ri,RExC_size);
5999     RExC_rx_sv = rx;
6000     RExC_rx = r;
6001     RExC_rxi = ri;
6002
6003     /* Second pass: emit code. */
6004     RExC_flags = rx_flags;      /* don't let top level (?i) bleed */
6005     RExC_pm_flags = pm_flags;
6006     RExC_parse = exp;
6007     RExC_end = exp + plen;
6008     RExC_naughty = 0;
6009     RExC_npar = 1;
6010     RExC_emit_start = ri->program;
6011     RExC_emit = ri->program;
6012     RExC_emit_bound = ri->program + RExC_size + 1;
6013     pRExC_state->code_index = 0;
6014
6015     REGC((U8)REG_MAGIC, (char*) RExC_emit++);
6016     if (reg(pRExC_state, 0, &flags,1) == NULL) {
6017         ReREFCNT_dec(rx);   
6018         Perl_croak(aTHX_ "panic: reg returned NULL to re_op_compile for generation pass, flags=%#"UVxf"", (UV) flags);
6019     }
6020     /* XXXX To minimize changes to RE engine we always allocate
6021        3-units-long substrs field. */
6022     Newx(r->substrs, 1, struct reg_substr_data);
6023     if (RExC_recurse_count) {
6024         Newxz(RExC_recurse,RExC_recurse_count,regnode *);
6025         SAVEFREEPV(RExC_recurse);
6026     }
6027
6028 reStudy:
6029     r->minlen = minlen = sawlookahead = sawplus = sawopen = 0;
6030     Zero(r->substrs, 1, struct reg_substr_data);
6031
6032 #ifdef TRIE_STUDY_OPT
6033     if (!restudied) {
6034         StructCopy(&zero_scan_data, &data, scan_data_t);
6035         copyRExC_state = RExC_state;
6036     } else {
6037         U32 seen=RExC_seen;
6038         DEBUG_OPTIMISE_r(PerlIO_printf(Perl_debug_log,"Restudying\n"));
6039         
6040         RExC_state = copyRExC_state;
6041         if (seen & REG_TOP_LEVEL_BRANCHES) 
6042             RExC_seen |= REG_TOP_LEVEL_BRANCHES;
6043         else
6044             RExC_seen &= ~REG_TOP_LEVEL_BRANCHES;
6045         StructCopy(&zero_scan_data, &data, scan_data_t);
6046     }
6047 #else
6048     StructCopy(&zero_scan_data, &data, scan_data_t);
6049 #endif    
6050
6051     /* Dig out information for optimizations. */
6052     r->extflags = RExC_flags; /* was pm_op */
6053     /*dmq: removed as part of de-PMOP: pm->op_pmflags = RExC_flags; */
6054  
6055     if (UTF)
6056         SvUTF8_on(rx);  /* Unicode in it? */
6057     ri->regstclass = NULL;
6058     if (RExC_naughty >= 10)     /* Probably an expensive pattern. */
6059         r->intflags |= PREGf_NAUGHTY;
6060     scan = ri->program + 1;             /* First BRANCH. */
6061
6062     /* testing for BRANCH here tells us whether there is "must appear"
6063        data in the pattern. If there is then we can use it for optimisations */
6064     if (!(RExC_seen & REG_TOP_LEVEL_BRANCHES)) { /*  Only one top-level choice. */
6065         I32 fake;
6066         STRLEN longest_float_length, longest_fixed_length;
6067         struct regnode_charclass_class ch_class; /* pointed to by data */
6068         int stclass_flag;
6069         I32 last_close = 0; /* pointed to by data */
6070         regnode *first= scan;
6071         regnode *first_next= regnext(first);
6072         /*
6073          * Skip introductions and multiplicators >= 1
6074          * so that we can extract the 'meat' of the pattern that must 
6075          * match in the large if() sequence following.
6076          * NOTE that EXACT is NOT covered here, as it is normally
6077          * picked up by the optimiser separately. 
6078          *
6079          * This is unfortunate as the optimiser isnt handling lookahead
6080          * properly currently.
6081          *
6082          */
6083         while ((OP(first) == OPEN && (sawopen = 1)) ||
6084                /* An OR of *one* alternative - should not happen now. */
6085             (OP(first) == BRANCH && OP(first_next) != BRANCH) ||
6086             /* for now we can't handle lookbehind IFMATCH*/
6087             (OP(first) == IFMATCH && !first->flags && (sawlookahead = 1)) ||
6088             (OP(first) == PLUS) ||
6089             (OP(first) == MINMOD) ||
6090                /* An {n,m} with n>0 */
6091             (PL_regkind[OP(first)] == CURLY && ARG1(first) > 0) ||
6092             (OP(first) == NOTHING && PL_regkind[OP(first_next)] != END ))
6093         {
6094                 /* 
6095                  * the only op that could be a regnode is PLUS, all the rest
6096                  * will be regnode_1 or regnode_2.
6097                  *
6098                  */
6099                 if (OP(first) == PLUS)
6100                     sawplus = 1;
6101                 else
6102                     first += regarglen[OP(first)];
6103
6104                 first = NEXTOPER(first);
6105                 first_next= regnext(first);
6106         }
6107
6108         /* Starting-point info. */
6109       again:
6110         DEBUG_PEEP("first:",first,0);
6111         /* Ignore EXACT as we deal with it later. */
6112         if (PL_regkind[OP(first)] == EXACT) {
6113             if (OP(first) == EXACT)
6114                 NOOP;   /* Empty, get anchored substr later. */
6115             else
6116                 ri->regstclass = first;
6117         }
6118 #ifdef TRIE_STCLASS
6119         else if (PL_regkind[OP(first)] == TRIE &&
6120                 ((reg_trie_data *)ri->data->data[ ARG(first) ])->minlen>0) 
6121         {
6122             regnode *trie_op;
6123             /* this can happen only on restudy */
6124             if ( OP(first) == TRIE ) {
6125                 struct regnode_1 *trieop = (struct regnode_1 *)
6126                     PerlMemShared_calloc(1, sizeof(struct regnode_1));
6127                 StructCopy(first,trieop,struct regnode_1);
6128                 trie_op=(regnode *)trieop;
6129             } else {
6130                 struct regnode_charclass *trieop = (struct regnode_charclass *)
6131                     PerlMemShared_calloc(1, sizeof(struct regnode_charclass));
6132                 StructCopy(first,trieop,struct regnode_charclass);
6133                 trie_op=(regnode *)trieop;
6134             }
6135             OP(trie_op)+=2;
6136             make_trie_failtable(pRExC_state, (regnode *)first, trie_op, 0);
6137             ri->regstclass = trie_op;
6138         }
6139 #endif
6140         else if (REGNODE_SIMPLE(OP(first)))
6141             ri->regstclass = first;
6142         else if (PL_regkind[OP(first)] == BOUND ||
6143                  PL_regkind[OP(first)] == NBOUND)
6144             ri->regstclass = first;
6145         else if (PL_regkind[OP(first)] == BOL) {
6146             r->extflags |= (OP(first) == MBOL
6147                            ? RXf_ANCH_MBOL
6148                            : (OP(first) == SBOL
6149                               ? RXf_ANCH_SBOL
6150                               : RXf_ANCH_BOL));
6151             first = NEXTOPER(first);
6152             goto again;
6153         }
6154         else if (OP(first) == GPOS) {
6155             r->extflags |= RXf_ANCH_GPOS;
6156             first = NEXTOPER(first);
6157             goto again;
6158         }
6159         else if ((!sawopen || !RExC_sawback) &&
6160             (OP(first) == STAR &&
6161             PL_regkind[OP(NEXTOPER(first))] == REG_ANY) &&
6162             !(r->extflags & RXf_ANCH) && !pRExC_state->num_code_blocks)
6163         {
6164             /* turn .* into ^.* with an implied $*=1 */
6165             const int type =
6166                 (OP(NEXTOPER(first)) == REG_ANY)
6167                     ? RXf_ANCH_MBOL
6168                     : RXf_ANCH_SBOL;
6169             r->extflags |= type;
6170             r->intflags |= PREGf_IMPLICIT;
6171             first = NEXTOPER(first);
6172             goto again;
6173         }
6174         if (sawplus && !sawlookahead && (!sawopen || !RExC_sawback)
6175             && !pRExC_state->num_code_blocks) /* May examine pos and $& */
6176             /* x+ must match at the 1st pos of run of x's */
6177             r->intflags |= PREGf_SKIP;
6178
6179         /* Scan is after the zeroth branch, first is atomic matcher. */
6180 #ifdef TRIE_STUDY_OPT
6181         DEBUG_PARSE_r(
6182             if (!restudied)
6183                 PerlIO_printf(Perl_debug_log, "first at %"IVdf"\n",
6184                               (IV)(first - scan + 1))
6185         );
6186 #else
6187         DEBUG_PARSE_r(
6188             PerlIO_printf(Perl_debug_log, "first at %"IVdf"\n",
6189                 (IV)(first - scan + 1))
6190         );
6191 #endif
6192
6193
6194         /*
6195         * If there's something expensive in the r.e., find the
6196         * longest literal string that must appear and make it the
6197         * regmust.  Resolve ties in favor of later strings, since
6198         * the regstart check works with the beginning of the r.e.
6199         * and avoiding duplication strengthens checking.  Not a
6200         * strong reason, but sufficient in the absence of others.
6201         * [Now we resolve ties in favor of the earlier string if
6202         * it happens that c_offset_min has been invalidated, since the
6203         * earlier string may buy us something the later one won't.]
6204         */
6205
6206         data.longest_fixed = newSVpvs("");
6207         data.longest_float = newSVpvs("");
6208         data.last_found = newSVpvs("");
6209         data.longest = &(data.longest_fixed);
6210         ENTER_with_name("study_chunk");
6211         SAVEFREESV(data.longest_fixed);
6212         SAVEFREESV(data.longest_float);
6213         SAVEFREESV(data.last_found);
6214         first = scan;
6215         if (!ri->regstclass) {
6216             cl_init(pRExC_state, &ch_class);
6217             data.start_class = &ch_class;
6218             stclass_flag = SCF_DO_STCLASS_AND;
6219         } else                          /* XXXX Check for BOUND? */
6220             stclass_flag = 0;
6221         data.last_closep = &last_close;
6222         
6223         minlen = study_chunk(pRExC_state, &first, &minlen, &fake, scan + RExC_size, /* Up to end */
6224             &data, -1, NULL, NULL,
6225             SCF_DO_SUBSTR | SCF_WHILEM_VISITED_POS | stclass_flag,0);
6226
6227
6228         CHECK_RESTUDY_GOTO_butfirst(LEAVE_with_name("study_chunk"));
6229
6230
6231         if ( RExC_npar == 1 && data.longest == &(data.longest_fixed)
6232              && data.last_start_min == 0 && data.last_end > 0
6233              && !RExC_seen_zerolen
6234              && !(RExC_seen & REG_SEEN_VERBARG)
6235              && (!(RExC_seen & REG_SEEN_GPOS) || (r->extflags & RXf_ANCH_GPOS)))
6236             r->extflags |= RXf_CHECK_ALL;
6237         scan_commit(pRExC_state, &data,&minlen,0);
6238
6239         longest_float_length = CHR_SVLEN(data.longest_float);
6240
6241         if (! ((SvCUR(data.longest_fixed)  /* ok to leave SvCUR */
6242                    && data.offset_fixed == data.offset_float_min
6243                    && SvCUR(data.longest_fixed) == SvCUR(data.longest_float)))
6244             && S_setup_longest (aTHX_ pRExC_state,
6245                                     data.longest_float,
6246                                     &(r->float_utf8),
6247                                     &(r->float_substr),
6248                                     &(r->float_end_shift),
6249                                     data.lookbehind_float,
6250                                     data.offset_float_min,
6251                                     data.minlen_float,
6252                                     longest_float_length,
6253                                     cBOOL(data.flags & SF_FL_BEFORE_EOL),
6254                                     cBOOL(data.flags & SF_FL_BEFORE_MEOL)))
6255         {
6256             r->float_min_offset = data.offset_float_min - data.lookbehind_float;
6257             r->float_max_offset = data.offset_float_max;
6258             if (data.offset_float_max < I32_MAX) /* Don't offset infinity */
6259                 r->float_max_offset -= data.lookbehind_float;
6260             SvREFCNT_inc_simple_void_NN(data.longest_float);
6261         }
6262         else {
6263             r->float_substr = r->float_utf8 = NULL;
6264             longest_float_length = 0;
6265         }
6266
6267         longest_fixed_length = CHR_SVLEN(data.longest_fixed);
6268
6269         if (S_setup_longest (aTHX_ pRExC_state,
6270                                 data.longest_fixed,
6271                                 &(r->anchored_utf8),
6272                                 &(r->anchored_substr),
6273                                 &(r->anchored_end_shift),
6274                                 data.lookbehind_fixed,
6275                                 data.offset_fixed,
6276                                 data.minlen_fixed,
6277                                 longest_fixed_length,
6278                                 cBOOL(data.flags & SF_FIX_BEFORE_EOL),
6279                                 cBOOL(data.flags & SF_FIX_BEFORE_MEOL)))
6280         {
6281             r->anchored_offset = data.offset_fixed - data.lookbehind_fixed;
6282             SvREFCNT_inc_simple_void_NN(data.longest_fixed);
6283         }
6284         else {
6285             r->anchored_substr = r->anchored_utf8 = NULL;
6286             longest_fixed_length = 0;
6287         }
6288         LEAVE_with_name("study_chunk");
6289
6290         if (ri->regstclass
6291             && (OP(ri->regstclass) == REG_ANY || OP(ri->regstclass) == SANY))
6292             ri->regstclass = NULL;
6293
6294         if ((!(r->anchored_substr || r->anchored_utf8) || r->anchored_offset)
6295             && stclass_flag
6296             && ! TEST_SSC_EOS(data.start_class)
6297             && !cl_is_anything(data.start_class))
6298         {
6299             const U32 n = add_data(pRExC_state, 1, "f");
6300             OP(data.start_class) = ANYOF_SYNTHETIC;
6301
6302             Newx(RExC_rxi->data->data[n], 1,
6303                 struct regnode_charclass_class);
6304             StructCopy(data.start_class,
6305                        (struct regnode_charclass_class*)RExC_rxi->data->data[n],
6306                        struct regnode_charclass_class);
6307             ri->regstclass = (regnode*)RExC_rxi->data->data[n];
6308             r->intflags &= ~PREGf_SKIP; /* Used in find_byclass(). */
6309             DEBUG_COMPILE_r({ SV *sv = sv_newmortal();
6310                       regprop(r, sv, (regnode*)data.start_class);
6311                       PerlIO_printf(Perl_debug_log,
6312                                     "synthetic stclass \"%s\".\n",
6313                                     SvPVX_const(sv));});
6314         }
6315
6316         /* A temporary algorithm prefers floated substr to fixed one to dig more info. */
6317         if (longest_fixed_length > longest_float_length) {
6318             r->check_end_shift = r->anchored_end_shift;
6319             r->check_substr = r->anchored_substr;
6320             r->check_utf8 = r->anchored_utf8;
6321             r->check_offset_min = r->check_offset_max = r->anchored_offset;
6322             if (r->extflags & RXf_ANCH_SINGLE)
6323                 r->extflags |= RXf_NOSCAN;
6324         }
6325         else {
6326             r->check_end_shift = r->float_end_shift;
6327             r->check_substr = r->float_substr;
6328             r->check_utf8 = r->float_utf8;
6329             r->check_offset_min = r->float_min_offset;
6330             r->check_offset_max = r->float_max_offset;
6331         }
6332         /* XXXX Currently intuiting is not compatible with ANCH_GPOS.
6333            This should be changed ASAP!  */
6334         if ((r->check_substr || r->check_utf8) && !(r->extflags & RXf_ANCH_GPOS)) {
6335             r->extflags |= RXf_USE_INTUIT;
6336             if (SvTAIL(r->check_substr ? r->check_substr : r->check_utf8))
6337                 r->extflags |= RXf_INTUIT_TAIL;
6338         }
6339         /* XXX Unneeded? dmq (shouldn't as this is handled elsewhere)
6340         if ( (STRLEN)minlen < longest_float_length )
6341             minlen= longest_float_length;
6342         if ( (STRLEN)minlen < longest_fixed_length )
6343             minlen= longest_fixed_length;     
6344         */
6345     }
6346     else {
6347         /* Several toplevels. Best we can is to set minlen. */
6348         I32 fake;
6349         struct regnode_charclass_class ch_class;
6350         I32 last_close = 0;
6351
6352         DEBUG_PARSE_r(PerlIO_printf(Perl_debug_log, "\nMulti Top Level\n"));
6353
6354         scan = ri->program + 1;
6355         cl_init(pRExC_state, &ch_class);
6356         data.start_class = &ch_class;
6357         data.last_closep = &last_close;
6358
6359         
6360         minlen = study_chunk(pRExC_state, &scan, &minlen, &fake, scan + RExC_size,
6361             &data, -1, NULL, NULL, SCF_DO_STCLASS_AND|SCF_WHILEM_VISITED_POS,0);
6362         
6363         CHECK_RESTUDY_GOTO_butfirst(NOOP);
6364
6365         r->check_substr = r->check_utf8 = r->anchored_substr = r->anchored_utf8
6366                 = r->float_substr = r->float_utf8 = NULL;
6367
6368         if (! TEST_SSC_EOS(data.start_class)
6369             && !cl_is_anything(data.start_class))
6370         {
6371             const U32 n = add_data(pRExC_state, 1, "f");
6372             OP(data.start_class) = ANYOF_SYNTHETIC;
6373
6374             Newx(RExC_rxi->data->data[n], 1,
6375                 struct regnode_charclass_class);
6376             StructCopy(data.start_class,
6377                        (struct regnode_charclass_class*)RExC_rxi->data->data[n],
6378                        struct regnode_charclass_class);
6379             ri->regstclass = (regnode*)RExC_rxi->data->data[n];
6380             r->intflags &= ~PREGf_SKIP; /* Used in find_byclass(). */
6381             DEBUG_COMPILE_r({ SV* sv = sv_newmortal();
6382                       regprop(r, sv, (regnode*)data.start_class);
6383                       PerlIO_printf(Perl_debug_log,
6384                                     "synthetic stclass \"%s\".\n",
6385                                     SvPVX_const(sv));});
6386         }
6387     }
6388
6389     /* Guard against an embedded (?=) or (?<=) with a longer minlen than
6390        the "real" pattern. */
6391     DEBUG_OPTIMISE_r({
6392         PerlIO_printf(Perl_debug_log,"minlen: %"IVdf" r->minlen:%"IVdf"\n",
6393                       (IV)minlen, (IV)r->minlen);
6394     });
6395     r->minlenret = minlen;
6396     if (r->minlen < minlen) 
6397         r->minlen = minlen;
6398     
6399     if (RExC_seen & REG_SEEN_GPOS)
6400         r->extflags |= RXf_GPOS_SEEN;
6401     if (RExC_seen & REG_SEEN_LOOKBEHIND)
6402         r->extflags |= RXf_NO_INPLACE_SUBST; /* inplace might break the lookbehind */
6403     if (pRExC_state->num_code_blocks)
6404         r->extflags |= RXf_EVAL_SEEN;
6405     if (RExC_seen & REG_SEEN_CANY)
6406         r->extflags |= RXf_CANY_SEEN;
6407     if (RExC_seen & REG_SEEN_VERBARG)
6408     {
6409         r->intflags |= PREGf_VERBARG_SEEN;
6410         r->extflags |= RXf_NO_INPLACE_SUBST; /* don't understand this! Yves */
6411     }
6412     if (RExC_seen & REG_SEEN_CUTGROUP)
6413         r->intflags |= PREGf_CUTGROUP_SEEN;
6414     if (pm_flags & PMf_USE_RE_EVAL)
6415         r->intflags |= PREGf_USE_RE_EVAL;
6416     if (RExC_paren_names)
6417         RXp_PAREN_NAMES(r) = MUTABLE_HV(SvREFCNT_inc(RExC_paren_names));
6418     else
6419         RXp_PAREN_NAMES(r) = NULL;
6420
6421     {
6422         regnode *first = ri->program + 1;
6423         U8 fop = OP(first);
6424         regnode *next = NEXTOPER(first);
6425         U8 nop = OP(next);
6426
6427         if (PL_regkind[fop] == NOTHING && nop == END)
6428             r->extflags |= RXf_NULL;
6429         else if (PL_regkind[fop] == BOL && nop == END)
6430             r->extflags |= RXf_START_ONLY;
6431         else if (fop == PLUS && PL_regkind[nop] == POSIXD && FLAGS(next) == _CC_SPACE && OP(regnext(first)) == END)
6432             r->extflags |= RXf_WHITE;
6433         else if ( r->extflags & RXf_SPLIT && fop == EXACT && STR_LEN(first) == 1 && *(STRING(first)) == ' ' && OP(regnext(first)) == END )
6434             r->extflags |= (RXf_SKIPWHITE|RXf_WHITE);
6435
6436     }
6437 #ifdef DEBUGGING
6438     if (RExC_paren_names) {
6439         ri->name_list_idx = add_data( pRExC_state, 1, "a" );
6440         ri->data->data[ri->name_list_idx] = (void*)SvREFCNT_inc(RExC_paren_name_list);
6441     } else
6442 #endif
6443         ri->name_list_idx = 0;
6444
6445     if (RExC_recurse_count) {
6446         for ( ; RExC_recurse_count ; RExC_recurse_count-- ) {
6447             const regnode *scan = RExC_recurse[RExC_recurse_count-1];
6448             ARG2L_SET( scan, RExC_open_parens[ARG(scan)-1] - scan );
6449         }
6450     }
6451     Newxz(r->offs, RExC_npar, regexp_paren_pair);
6452     /* assume we don't need to swap parens around before we match */
6453
6454     DEBUG_DUMP_r({
6455         PerlIO_printf(Perl_debug_log,"Final program:\n");
6456         regdump(r);
6457     });
6458 #ifdef RE_TRACK_PATTERN_OFFSETS
6459     DEBUG_OFFSETS_r(if (ri->u.offsets) {
6460         const U32 len = ri->u.offsets[0];
6461         U32 i;
6462         GET_RE_DEBUG_FLAGS_DECL;
6463         PerlIO_printf(Perl_debug_log, "Offsets: [%"UVuf"]\n\t", (UV)ri->u.offsets[0]);
6464         for (i = 1; i <= len; i++) {
6465             if (ri->u.offsets[i*2-1] || ri->u.offsets[i*2])
6466                 PerlIO_printf(Perl_debug_log, "%"UVuf":%"UVuf"[%"UVuf"] ",
6467                 (UV)i, (UV)ri->u.offsets[i*2-1], (UV)ri->u.offsets[i*2]);
6468             }
6469         PerlIO_printf(Perl_debug_log, "\n");
6470     });
6471 #endif
6472
6473 #ifdef USE_ITHREADS
6474     /* under ithreads the ?pat? PMf_USED flag on the pmop is simulated
6475      * by setting the regexp SV to readonly-only instead. If the
6476      * pattern's been recompiled, the USEDness should remain. */
6477     if (old_re && SvREADONLY(old_re))
6478         SvREADONLY_on(rx);
6479 #endif
6480     return rx;
6481 }
6482
6483
6484 SV*
6485 Perl_reg_named_buff(pTHX_ REGEXP * const rx, SV * const key, SV * const value,
6486                     const U32 flags)
6487 {
6488     PERL_ARGS_ASSERT_REG_NAMED_BUFF;
6489
6490     PERL_UNUSED_ARG(value);
6491
6492     if (flags & RXapif_FETCH) {
6493         return reg_named_buff_fetch(rx, key, flags);
6494     } else if (flags & (RXapif_STORE | RXapif_DELETE | RXapif_CLEAR)) {
6495         Perl_croak_no_modify();
6496         return NULL;
6497     } else if (flags & RXapif_EXISTS) {
6498         return reg_named_buff_exists(rx, key, flags)
6499             ? &PL_sv_yes
6500             : &PL_sv_no;
6501     } else if (flags & RXapif_REGNAMES) {
6502         return reg_named_buff_all(rx, flags);
6503     } else if (flags & (RXapif_SCALAR | RXapif_REGNAMES_COUNT)) {
6504         return reg_named_buff_scalar(rx, flags);
6505     } else {
6506         Perl_croak(aTHX_ "panic: Unknown flags %d in named_buff", (int)flags);
6507         return NULL;
6508     }
6509 }
6510
6511 SV*
6512 Perl_reg_named_buff_iter(pTHX_ REGEXP * const rx, const SV * const lastkey,
6513                          const U32 flags)
6514 {
6515     PERL_ARGS_ASSERT_REG_NAMED_BUFF_ITER;
6516     PERL_UNUSED_ARG(lastkey);
6517
6518     if (flags & RXapif_FIRSTKEY)
6519         return reg_named_buff_firstkey(rx, flags);
6520     else if (flags & RXapif_NEXTKEY)
6521         return reg_named_buff_nextkey(rx, flags);
6522     else {
6523         Perl_croak(aTHX_ "panic: Unknown flags %d in named_buff_iter", (int)flags);
6524         return NULL;
6525     }
6526 }
6527
6528 SV*
6529 Perl_reg_named_buff_fetch(pTHX_ REGEXP * const r, SV * const namesv,
6530                           const U32 flags)
6531 {
6532     AV *retarray = NULL;
6533     SV *ret;
6534     struct regexp *const rx = ReANY(r);
6535
6536     PERL_ARGS_ASSERT_REG_NAMED_BUFF_FETCH;
6537
6538     if (flags & RXapif_ALL)
6539         retarray=newAV();
6540
6541     if (rx && RXp_PAREN_NAMES(rx)) {
6542         HE *he_str = hv_fetch_ent( RXp_PAREN_NAMES(rx), namesv, 0, 0 );
6543         if (he_str) {
6544             IV i;
6545             SV* sv_dat=HeVAL(he_str);
6546             I32 *nums=(I32*)SvPVX(sv_dat);
6547             for ( i=0; i<SvIVX(sv_dat); i++ ) {
6548                 if ((I32)(rx->nparens) >= nums[i]
6549                     && rx->offs[nums[i]].start != -1
6550                     && rx->offs[nums[i]].end != -1)
6551                 {
6552                     ret = newSVpvs("");
6553                     CALLREG_NUMBUF_FETCH(r,nums[i],ret);
6554                     if (!retarray)
6555                         return ret;
6556                 } else {
6557                     if (retarray)
6558                         ret = newSVsv(&PL_sv_undef);
6559                 }
6560                 if (retarray)
6561                     av_push(retarray, ret);
6562             }
6563             if (retarray)
6564                 return newRV_noinc(MUTABLE_SV(retarray));
6565         }
6566     }
6567     return NULL;
6568 }
6569
6570 bool
6571 Perl_reg_named_buff_exists(pTHX_ REGEXP * const r, SV * const key,
6572                            const U32 flags)
6573 {
6574     struct regexp *const rx = ReANY(r);
6575
6576     PERL_ARGS_ASSERT_REG_NAMED_BUFF_EXISTS;
6577
6578     if (rx && RXp_PAREN_NAMES(rx)) {
6579         if (flags & RXapif_ALL) {
6580             return hv_exists_ent(RXp_PAREN_NAMES(rx), key, 0);
6581         } else {
6582             SV *sv = CALLREG_NAMED_BUFF_FETCH(r, key, flags);
6583             if (sv) {
6584                 SvREFCNT_dec_NN(sv);
6585                 return TRUE;
6586             } else {
6587                 return FALSE;
6588             }
6589         }
6590     } else {
6591         return FALSE;
6592     }
6593 }
6594
6595 SV*
6596 Perl_reg_named_buff_firstkey(pTHX_ REGEXP * const r, const U32 flags)
6597 {
6598     struct regexp *const rx = ReANY(r);
6599
6600     PERL_ARGS_ASSERT_REG_NAMED_BUFF_FIRSTKEY;
6601
6602     if ( rx && RXp_PAREN_NAMES(rx) ) {
6603         (void)hv_iterinit(RXp_PAREN_NAMES(rx));
6604
6605         return CALLREG_NAMED_BUFF_NEXTKEY(r, NULL, flags & ~RXapif_FIRSTKEY);
6606     } else {
6607         return FALSE;
6608     }
6609 }
6610
6611 SV*
6612 Perl_reg_named_buff_nextkey(pTHX_ REGEXP * const r, const U32 flags)
6613 {
6614     struct regexp *const rx = ReANY(r);
6615     GET_RE_DEBUG_FLAGS_DECL;
6616
6617     PERL_ARGS_ASSERT_REG_NAMED_BUFF_NEXTKEY;
6618
6619     if (rx && RXp_PAREN_NAMES(rx)) {
6620         HV *hv = RXp_PAREN_NAMES(rx);
6621         HE *temphe;
6622         while ( (temphe = hv_iternext_flags(hv,0)) ) {
6623             IV i;
6624             IV parno = 0;
6625             SV* sv_dat = HeVAL(temphe);
6626             I32 *nums = (I32*)SvPVX(sv_dat);
6627             for ( i = 0; i < SvIVX(sv_dat); i++ ) {
6628                 if ((I32)(rx->lastparen) >= nums[i] &&
6629                     rx->offs[nums[i]].start != -1 &&
6630                     rx->offs[nums[i]].end != -1)
6631                 {
6632                     parno = nums[i];
6633                     break;
6634                 }
6635             }
6636             if (parno || flags & RXapif_ALL) {
6637                 return newSVhek(HeKEY_hek(temphe));
6638             }
6639         }
6640     }
6641     return NULL;
6642 }
6643
6644 SV*
6645 Perl_reg_named_buff_scalar(pTHX_ REGEXP * const r, const U32 flags)
6646 {
6647     SV *ret;
6648     AV *av;
6649     I32 length;
6650     struct regexp *const rx = ReANY(r);
6651
6652     PERL_ARGS_ASSERT_REG_NAMED_BUFF_SCALAR;
6653
6654     if (rx && RXp_PAREN_NAMES(rx)) {
6655         if (flags & (RXapif_ALL | RXapif_REGNAMES_COUNT)) {
6656             return newSViv(HvTOTALKEYS(RXp_PAREN_NAMES(rx)));
6657         } else if (flags & RXapif_ONE) {
6658             ret = CALLREG_NAMED_BUFF_ALL(r, (flags | RXapif_REGNAMES));
6659             av = MUTABLE_AV(SvRV(ret));
6660             length = av_len(av);
6661             SvREFCNT_dec_NN(ret);
6662             return newSViv(length + 1);
6663         } else {
6664             Perl_croak(aTHX_ "panic: Unknown flags %d in named_buff_scalar", (int)flags);
6665             return NULL;
6666         }
6667     }
6668     return &PL_sv_undef;
6669 }
6670
6671 SV*
6672 Perl_reg_named_buff_all(pTHX_ REGEXP * const r, const U32 flags)
6673 {
6674     struct regexp *const rx = ReANY(r);
6675     AV *av = newAV();
6676
6677     PERL_ARGS_ASSERT_REG_NAMED_BUFF_ALL;
6678
6679     if (rx && RXp_PAREN_NAMES(rx)) {
6680         HV *hv= RXp_PAREN_NAMES(rx);
6681         HE *temphe;
6682         (void)hv_iterinit(hv);
6683         while ( (temphe = hv_iternext_flags(hv,0)) ) {
6684             IV i;
6685             IV parno = 0;
6686             SV* sv_dat = HeVAL(temphe);
6687             I32 *nums = (I32*)SvPVX(sv_dat);
6688             for ( i = 0; i < SvIVX(sv_dat); i++ ) {
6689                 if ((I32)(rx->lastparen) >= nums[i] &&
6690                     rx->offs[nums[i]].start != -1 &&
6691                     rx->offs[nums[i]].end != -1)
6692                 {
6693                     parno = nums[i];
6694                     break;
6695                 }
6696             }
6697             if (parno || flags & RXapif_ALL) {
6698                 av_push(av, newSVhek(HeKEY_hek(temphe)));
6699             }
6700         }
6701     }
6702
6703     return newRV_noinc(MUTABLE_SV(av));
6704 }
6705
6706 void
6707 Perl_reg_numbered_buff_fetch(pTHX_ REGEXP * const r, const I32 paren,
6708                              SV * const sv)
6709 {
6710     struct regexp *const rx = ReANY(r);
6711     char *s = NULL;
6712     I32 i = 0;
6713     I32 s1, t1;
6714     I32 n = paren;
6715
6716     PERL_ARGS_ASSERT_REG_NUMBERED_BUFF_FETCH;
6717         
6718     if ( (    n == RX_BUFF_IDX_CARET_PREMATCH
6719            || n == RX_BUFF_IDX_CARET_FULLMATCH
6720            || n == RX_BUFF_IDX_CARET_POSTMATCH
6721          )
6722          && !(rx->extflags & RXf_PMf_KEEPCOPY)
6723     )
6724         goto ret_undef;
6725
6726     if (!rx->subbeg)
6727         goto ret_undef;
6728
6729     if (n == RX_BUFF_IDX_CARET_FULLMATCH)
6730         /* no need to distinguish between them any more */
6731         n = RX_BUFF_IDX_FULLMATCH;
6732
6733     if ((n == RX_BUFF_IDX_PREMATCH || n == RX_BUFF_IDX_CARET_PREMATCH)
6734         && rx->offs[0].start != -1)
6735     {
6736         /* $`, ${^PREMATCH} */
6737         i = rx->offs[0].start;
6738         s = rx->subbeg;
6739     }
6740     else 
6741     if ((n == RX_BUFF_IDX_POSTMATCH || n == RX_BUFF_IDX_CARET_POSTMATCH)
6742         && rx->offs[0].end != -1)
6743     {
6744         /* $', ${^POSTMATCH} */
6745         s = rx->subbeg - rx->suboffset + rx->offs[0].end;
6746         i = rx->sublen + rx->suboffset - rx->offs[0].end;
6747     } 
6748     else
6749     if ( 0 <= n && n <= (I32)rx->nparens &&
6750         (s1 = rx->offs[n].start) != -1 &&
6751         (t1 = rx->offs[n].end) != -1)
6752     {
6753         /* $&, ${^MATCH},  $1 ... */
6754         i = t1 - s1;
6755         s = rx->subbeg + s1 - rx->suboffset;
6756     } else {
6757         goto ret_undef;
6758     }          
6759
6760     assert(s >= rx->subbeg);
6761     assert(rx->sublen >= (s - rx->subbeg) + i );
6762     if (i >= 0) {
6763 #if NO_TAINT_SUPPORT
6764         sv_setpvn(sv, s, i);
6765 #else
6766         const int oldtainted = TAINT_get;
6767         TAINT_NOT;
6768         sv_setpvn(sv, s, i);
6769         TAINT_set(oldtainted);
6770 #endif
6771         if ( (rx->extflags & RXf_CANY_SEEN)
6772             ? (RXp_MATCH_UTF8(rx)
6773                         && (!i || is_utf8_string((U8*)s, i)))
6774             : (RXp_MATCH_UTF8(rx)) )
6775         {
6776             SvUTF8_on(sv);
6777         }
6778         else
6779             SvUTF8_off(sv);
6780         if (TAINTING_get) {
6781             if (RXp_MATCH_TAINTED(rx)) {
6782                 if (SvTYPE(sv) >= SVt_PVMG) {
6783                     MAGIC* const mg = SvMAGIC(sv);
6784                     MAGIC* mgt;
6785                     TAINT;
6786                     SvMAGIC_set(sv, mg->mg_moremagic);
6787                     SvTAINT(sv);
6788                     if ((mgt = SvMAGIC(sv))) {
6789                         mg->mg_moremagic = mgt;
6790                         SvMAGIC_set(sv, mg);
6791                     }
6792                 } else {
6793                     TAINT;
6794                     SvTAINT(sv);
6795                 }
6796             } else 
6797                 SvTAINTED_off(sv);
6798         }
6799     } else {
6800       ret_undef:
6801         sv_setsv(sv,&PL_sv_undef);
6802         return;
6803     }
6804 }
6805
6806 void
6807 Perl_reg_numbered_buff_store(pTHX_ REGEXP * const rx, const I32 paren,
6808                                                          SV const * const value)
6809 {
6810     PERL_ARGS_ASSERT_REG_NUMBERED_BUFF_STORE;
6811
6812     PERL_UNUSED_ARG(rx);
6813     PERL_UNUSED_ARG(paren);
6814     PERL_UNUSED_ARG(value);
6815
6816     if (!PL_localizing)
6817         Perl_croak_no_modify();
6818 }
6819
6820 I32
6821 Perl_reg_numbered_buff_length(pTHX_ REGEXP * const r, const SV * const sv,
6822                               const I32 paren)
6823 {
6824     struct regexp *const rx = ReANY(r);
6825     I32 i;
6826     I32 s1, t1;
6827
6828     PERL_ARGS_ASSERT_REG_NUMBERED_BUFF_LENGTH;
6829
6830     /* Some of this code was originally in C<Perl_magic_len> in F<mg.c> */
6831     switch (paren) {
6832       case RX_BUFF_IDX_CARET_PREMATCH: /* ${^PREMATCH} */
6833          if (!(rx->extflags & RXf_PMf_KEEPCOPY))
6834             goto warn_undef;
6835         /*FALLTHROUGH*/
6836
6837       case RX_BUFF_IDX_PREMATCH:       /* $` */
6838         if (rx->offs[0].start != -1) {
6839                         i = rx->offs[0].start;
6840                         if (i > 0) {
6841                                 s1 = 0;
6842                                 t1 = i;
6843                                 goto getlen;
6844                         }
6845             }
6846         return 0;
6847
6848       case RX_BUFF_IDX_CARET_POSTMATCH: /* ${^POSTMATCH} */
6849          if (!(rx->extflags & RXf_PMf_KEEPCOPY))
6850             goto warn_undef;
6851       case RX_BUFF_IDX_POSTMATCH:       /* $' */
6852             if (rx->offs[0].end != -1) {
6853                         i = rx->sublen - rx->offs[0].end;
6854                         if (i > 0) {
6855                                 s1 = rx->offs[0].end;
6856                                 t1 = rx->sublen;
6857                                 goto getlen;
6858                         }
6859             }
6860         return 0;
6861
6862       case RX_BUFF_IDX_CARET_FULLMATCH: /* ${^MATCH} */
6863          if (!(rx->extflags & RXf_PMf_KEEPCOPY))
6864             goto warn_undef;
6865         /*FALLTHROUGH*/
6866
6867       /* $& / ${^MATCH}, $1, $2, ... */
6868       default:
6869             if (paren <= (I32)rx->nparens &&
6870             (s1 = rx->offs[paren].start) != -1 &&
6871             (t1 = rx->offs[paren].end) != -1)
6872             {
6873             i = t1 - s1;
6874             goto getlen;
6875         } else {
6876           warn_undef:
6877             if (ckWARN(WARN_UNINITIALIZED))
6878                 report_uninit((const SV *)sv);
6879             return 0;
6880         }
6881     }
6882   getlen:
6883     if (i > 0 && RXp_MATCH_UTF8(rx)) {
6884         const char * const s = rx->subbeg - rx->suboffset + s1;
6885         const U8 *ep;
6886         STRLEN el;
6887
6888         i = t1 - s1;
6889         if (is_utf8_string_loclen((U8*)s, i, &ep, &el))
6890                         i = el;
6891     }
6892     return i;
6893 }
6894
6895 SV*
6896 Perl_reg_qr_package(pTHX_ REGEXP * const rx)
6897 {
6898     PERL_ARGS_ASSERT_REG_QR_PACKAGE;
6899         PERL_UNUSED_ARG(rx);
6900         if (0)
6901             return NULL;
6902         else
6903             return newSVpvs("Regexp");
6904 }
6905
6906 /* Scans the name of a named buffer from the pattern.
6907  * If flags is REG_RSN_RETURN_NULL returns null.
6908  * If flags is REG_RSN_RETURN_NAME returns an SV* containing the name
6909  * If flags is REG_RSN_RETURN_DATA returns the data SV* corresponding
6910  * to the parsed name as looked up in the RExC_paren_names hash.
6911  * If there is an error throws a vFAIL().. type exception.
6912  */
6913
6914 #define REG_RSN_RETURN_NULL    0
6915 #define REG_RSN_RETURN_NAME    1
6916 #define REG_RSN_RETURN_DATA    2
6917
6918 STATIC SV*
6919 S_reg_scan_name(pTHX_ RExC_state_t *pRExC_state, U32 flags)
6920 {
6921     char *name_start = RExC_parse;
6922
6923     PERL_ARGS_ASSERT_REG_SCAN_NAME;
6924
6925     if (isIDFIRST_lazy_if(RExC_parse, UTF)) {
6926          /* skip IDFIRST by using do...while */
6927         if (UTF)
6928             do {
6929                 RExC_parse += UTF8SKIP(RExC_parse);
6930             } while (isWORDCHAR_utf8((U8*)RExC_parse));
6931         else
6932             do {
6933                 RExC_parse++;
6934             } while (isWORDCHAR(*RExC_parse));
6935     } else {
6936         RExC_parse++; /* so the <- from the vFAIL is after the offending character */
6937         vFAIL("Group name must start with a non-digit word character");
6938     }
6939     if ( flags ) {
6940         SV* sv_name
6941             = newSVpvn_flags(name_start, (int)(RExC_parse - name_start),
6942                              SVs_TEMP | (UTF ? SVf_UTF8 : 0));
6943         if ( flags == REG_RSN_RETURN_NAME)
6944             return sv_name;
6945         else if (flags==REG_RSN_RETURN_DATA) {
6946             HE *he_str = NULL;
6947             SV *sv_dat = NULL;
6948             if ( ! sv_name )      /* should not happen*/
6949                 Perl_croak(aTHX_ "panic: no svname in reg_scan_name");
6950             if (RExC_paren_names)
6951                 he_str = hv_fetch_ent( RExC_paren_names, sv_name, 0, 0 );
6952             if ( he_str )
6953                 sv_dat = HeVAL(he_str);
6954             if ( ! sv_dat )
6955                 vFAIL("Reference to nonexistent named group");
6956             return sv_dat;
6957         }
6958         else {
6959             Perl_croak(aTHX_ "panic: bad flag %lx in reg_scan_name",
6960                        (unsigned long) flags);
6961         }
6962         assert(0); /* NOT REACHED */
6963     }
6964     return NULL;
6965 }
6966
6967 #define DEBUG_PARSE_MSG(funcname)     DEBUG_PARSE_r({           \
6968     int rem=(int)(RExC_end - RExC_parse);                       \
6969     int cut;                                                    \
6970     int num;                                                    \
6971     int iscut=0;                                                \
6972     if (rem>10) {                                               \
6973         rem=10;                                                 \
6974         iscut=1;                                                \
6975     }                                                           \
6976     cut=10-rem;                                                 \
6977     if (RExC_lastparse!=RExC_parse)                             \
6978         PerlIO_printf(Perl_debug_log," >%.*s%-*s",              \
6979             rem, RExC_parse,                                    \
6980             cut + 4,                                            \
6981             iscut ? "..." : "<"                                 \
6982         );                                                      \
6983     else                                                        \
6984         PerlIO_printf(Perl_debug_log,"%16s","");                \
6985                                                                 \
6986     if (SIZE_ONLY)                                              \
6987        num = RExC_size + 1;                                     \
6988     else                                                        \
6989        num=REG_NODE_NUM(RExC_emit);                             \
6990     if (RExC_lastnum!=num)                                      \
6991        PerlIO_printf(Perl_debug_log,"|%4d",num);                \
6992     else                                                        \
6993        PerlIO_printf(Perl_debug_log,"|%4s","");                 \
6994     PerlIO_printf(Perl_debug_log,"|%*s%-4s",                    \
6995         (int)((depth*2)), "",                                   \
6996         (funcname)                                              \
6997     );                                                          \
6998     RExC_lastnum=num;                                           \
6999     RExC_lastparse=RExC_parse;                                  \
7000 })
7001
7002
7003
7004 #define DEBUG_PARSE(funcname)     DEBUG_PARSE_r({           \
7005     DEBUG_PARSE_MSG((funcname));                            \
7006     PerlIO_printf(Perl_debug_log,"%4s","\n");               \
7007 })
7008 #define DEBUG_PARSE_FMT(funcname,fmt,args)     DEBUG_PARSE_r({           \
7009     DEBUG_PARSE_MSG((funcname));                            \
7010     PerlIO_printf(Perl_debug_log,fmt "\n",args);               \
7011 })
7012
7013 /* This section of code defines the inversion list object and its methods.  The
7014  * interfaces are highly subject to change, so as much as possible is static to
7015  * this file.  An inversion list is here implemented as a malloc'd C UV array
7016  * with some added info that is placed as UVs at the beginning in a header
7017  * portion.  An inversion list for Unicode is an array of code points, sorted
7018  * by ordinal number.  The zeroth element is the first code point in the list.
7019  * The 1th element is the first element beyond that not in the list.  In other
7020  * words, the first range is
7021  *  invlist[0]..(invlist[1]-1)
7022  * The other ranges follow.  Thus every element whose index is divisible by two
7023  * marks the beginning of a range that is in the list, and every element not
7024  * divisible by two marks the beginning of a range not in the list.  A single
7025  * element inversion list that contains the single code point N generally
7026  * consists of two elements
7027  *  invlist[0] == N
7028  *  invlist[1] == N+1
7029  * (The exception is when N is the highest representable value on the
7030  * machine, in which case the list containing just it would be a single
7031  * element, itself.  By extension, if the last range in the list extends to
7032  * infinity, then the first element of that range will be in the inversion list
7033  * at a position that is divisible by two, and is the final element in the
7034  * list.)
7035  * Taking the complement (inverting) an inversion list is quite simple, if the
7036  * first element is 0, remove it; otherwise add a 0 element at the beginning.
7037  * This implementation reserves an element at the beginning of each inversion
7038  * list to contain 0 when the list contains 0, and contains 1 otherwise.  The
7039  * actual beginning of the list is either that element if 0, or the next one if
7040  * 1.
7041  *
7042  * More about inversion lists can be found in "Unicode Demystified"
7043  * Chapter 13 by Richard Gillam, published by Addison-Wesley.
7044  * More will be coming when functionality is added later.
7045  *
7046  * The inversion list data structure is currently implemented as an SV pointing
7047  * to an array of UVs that the SV thinks are bytes.  This allows us to have an
7048  * array of UV whose memory management is automatically handled by the existing
7049  * facilities for SV's.
7050  *
7051  * Some of the methods should always be private to the implementation, and some
7052  * should eventually be made public */
7053
7054 /* The header definitions are in F<inline_invlist.c> */
7055 #define TO_INTERNAL_SIZE(x) (((x) + HEADER_LENGTH) * sizeof(UV))
7056 #define FROM_INTERNAL_SIZE(x) (((x)/ sizeof(UV)) - HEADER_LENGTH)
7057
7058 #define INVLIST_INITIAL_LEN 10
7059
7060 PERL_STATIC_INLINE UV*
7061 S__invlist_array_init(pTHX_ SV* const invlist, const bool will_have_0)
7062 {
7063     /* Returns a pointer to the first element in the inversion list's array.
7064      * This is called upon initialization of an inversion list.  Where the
7065      * array begins depends on whether the list has the code point U+0000
7066      * in it or not.  The other parameter tells it whether the code that
7067      * follows this call is about to put a 0 in the inversion list or not.
7068      * The first element is either the element with 0, if 0, or the next one,
7069      * if 1 */
7070
7071     UV* zero = get_invlist_zero_addr(invlist);
7072
7073     PERL_ARGS_ASSERT__INVLIST_ARRAY_INIT;
7074
7075     /* Must be empty */
7076     assert(! *_get_invlist_len_addr(invlist));
7077
7078     /* 1^1 = 0; 1^0 = 1 */
7079     *zero = 1 ^ will_have_0;
7080     return zero + *zero;
7081 }
7082
7083 PERL_STATIC_INLINE UV*
7084 S_invlist_array(pTHX_ SV* const invlist)
7085 {
7086     /* Returns the pointer to the inversion list's array.  Every time the
7087      * length changes, this needs to be called in case malloc or realloc moved
7088      * it */
7089
7090     PERL_ARGS_ASSERT_INVLIST_ARRAY;
7091
7092     /* Must not be empty.  If these fail, you probably didn't check for <len>
7093      * being non-zero before trying to get the array */
7094     assert(*_get_invlist_len_addr(invlist));
7095     assert(*get_invlist_zero_addr(invlist) == 0
7096            || *get_invlist_zero_addr(invlist) == 1);
7097
7098     /* The array begins either at the element reserved for zero if the
7099      * list contains 0 (that element will be set to 0), or otherwise the next
7100      * element (in which case the reserved element will be set to 1). */
7101     return (UV *) (get_invlist_zero_addr(invlist)
7102                    + *get_invlist_zero_addr(invlist));
7103 }
7104
7105 PERL_STATIC_INLINE void
7106 S_invlist_set_len(pTHX_ SV* const invlist, const UV len)
7107 {
7108     /* Sets the current number of elements stored in the inversion list */
7109
7110     PERL_ARGS_ASSERT_INVLIST_SET_LEN;
7111
7112     *_get_invlist_len_addr(invlist) = len;
7113
7114     assert(len <= SvLEN(invlist));
7115
7116     SvCUR_set(invlist, TO_INTERNAL_SIZE(len));
7117     /* If the list contains U+0000, that element is part of the header,
7118      * and should not be counted as part of the array.  It will contain
7119      * 0 in that case, and 1 otherwise.  So we could flop 0=>1, 1=>0 and
7120      * subtract:
7121      *  SvCUR_set(invlist,
7122      *            TO_INTERNAL_SIZE(len
7123      *                             - (*get_invlist_zero_addr(inv_list) ^ 1)));
7124      * But, this is only valid if len is not 0.  The consequences of not doing
7125      * this is that the memory allocation code may think that 1 more UV is
7126      * being used than actually is, and so might do an unnecessary grow.  That
7127      * seems worth not bothering to make this the precise amount.
7128      *
7129      * Note that when inverting, SvCUR shouldn't change */
7130 }
7131
7132 PERL_STATIC_INLINE IV*
7133 S_get_invlist_previous_index_addr(pTHX_ SV* invlist)
7134 {
7135     /* Return the address of the UV that is reserved to hold the cached index
7136      * */
7137
7138     PERL_ARGS_ASSERT_GET_INVLIST_PREVIOUS_INDEX_ADDR;
7139
7140     return (IV *) (SvPVX(invlist) + (INVLIST_PREVIOUS_INDEX_OFFSET * sizeof (UV)));
7141 }
7142
7143 PERL_STATIC_INLINE IV
7144 S_invlist_previous_index(pTHX_ SV* const invlist)
7145 {
7146     /* Returns cached index of previous search */
7147
7148     PERL_ARGS_ASSERT_INVLIST_PREVIOUS_INDEX;
7149
7150     return *get_invlist_previous_index_addr(invlist);
7151 }
7152
7153 PERL_STATIC_INLINE void
7154 S_invlist_set_previous_index(pTHX_ SV* const invlist, const IV index)
7155 {
7156     /* Caches <index> for later retrieval */
7157
7158     PERL_ARGS_ASSERT_INVLIST_SET_PREVIOUS_INDEX;
7159
7160     assert(index == 0 || index < (int) _invlist_len(invlist));
7161
7162     *get_invlist_previous_index_addr(invlist) = index;
7163 }
7164
7165 PERL_STATIC_INLINE UV
7166 S_invlist_max(pTHX_ SV* const invlist)
7167 {
7168     /* Returns the maximum number of elements storable in the inversion list's
7169      * array, without having to realloc() */
7170
7171     PERL_ARGS_ASSERT_INVLIST_MAX;
7172
7173     return SvLEN(invlist) == 0  /* This happens under _new_invlist_C_array */
7174            ? _invlist_len(invlist)
7175            : FROM_INTERNAL_SIZE(SvLEN(invlist));
7176 }
7177
7178 PERL_STATIC_INLINE UV*
7179 S_get_invlist_zero_addr(pTHX_ SV* invlist)
7180 {
7181     /* Return the address of the UV that is reserved to hold 0 if the inversion
7182      * list contains 0.  This has to be the last element of the heading, as the
7183      * list proper starts with either it if 0, or the next element if not.
7184      * (But we force it to contain either 0 or 1) */
7185
7186     PERL_ARGS_ASSERT_GET_INVLIST_ZERO_ADDR;
7187
7188     return (UV *) (SvPVX(invlist) + (INVLIST_ZERO_OFFSET * sizeof (UV)));
7189 }
7190
7191 #ifndef PERL_IN_XSUB_RE
7192 SV*
7193 Perl__new_invlist(pTHX_ IV initial_size)
7194 {
7195
7196     /* Return a pointer to a newly constructed inversion list, with enough
7197      * space to store 'initial_size' elements.  If that number is negative, a
7198      * system default is used instead */
7199
7200     SV* new_list;
7201
7202     if (initial_size < 0) {
7203         initial_size = INVLIST_INITIAL_LEN;
7204     }
7205
7206     /* Allocate the initial space */
7207     new_list = newSV(TO_INTERNAL_SIZE(initial_size));
7208     invlist_set_len(new_list, 0);
7209
7210     /* Force iterinit() to be used to get iteration to work */
7211     *get_invlist_iter_addr(new_list) = UV_MAX;
7212
7213     /* This should force a segfault if a method doesn't initialize this
7214      * properly */
7215     *get_invlist_zero_addr(new_list) = UV_MAX;
7216
7217     *get_invlist_previous_index_addr(new_list) = 0;
7218     *get_invlist_version_id_addr(new_list) = INVLIST_VERSION_ID;
7219 #if HEADER_LENGTH != 5
7220 #   error Need to regenerate INVLIST_VERSION_ID by running perl -E 'say int(rand 2**31-1)', and then changing the #if to the new length
7221 #endif
7222
7223     return new_list;
7224 }
7225 #endif
7226
7227 STATIC SV*
7228 S__new_invlist_C_array(pTHX_ UV* list)
7229 {
7230     /* Return a pointer to a newly constructed inversion list, initialized to
7231      * point to <list>, which has to be in the exact correct inversion list
7232      * form, including internal fields.  Thus this is a dangerous routine that
7233      * should not be used in the wrong hands */
7234
7235     SV* invlist = newSV_type(SVt_PV);
7236
7237     PERL_ARGS_ASSERT__NEW_INVLIST_C_ARRAY;
7238
7239     SvPV_set(invlist, (char *) list);
7240     SvLEN_set(invlist, 0);  /* Means we own the contents, and the system
7241                                shouldn't touch it */
7242     SvCUR_set(invlist, TO_INTERNAL_SIZE(_invlist_len(invlist)));
7243
7244     if (*get_invlist_version_id_addr(invlist) != INVLIST_VERSION_ID) {
7245         Perl_croak(aTHX_ "panic: Incorrect version for previously generated inversion list");
7246     }
7247
7248     /* Initialize the iteration pointer.
7249      * XXX This could be done at compile time in charclass_invlists.h, but I
7250      * (khw) am not confident that the suffixes for specifying the C constant
7251      * UV_MAX are portable, e.g.  'ull' on a 32 bit machine that is configured
7252      * to use 64 bits; might need a Configure probe */
7253     invlist_iterfinish(invlist);
7254
7255     return invlist;
7256 }
7257
7258 STATIC void
7259 S_invlist_extend(pTHX_ SV* const invlist, const UV new_max)
7260 {
7261     /* Grow the maximum size of an inversion list */
7262
7263     PERL_ARGS_ASSERT_INVLIST_EXTEND;
7264
7265     SvGROW((SV *)invlist, TO_INTERNAL_SIZE(new_max));
7266 }
7267
7268 PERL_STATIC_INLINE void
7269 S_invlist_trim(pTHX_ SV* const invlist)
7270 {
7271     PERL_ARGS_ASSERT_INVLIST_TRIM;
7272
7273     /* Change the length of the inversion list to how many entries it currently
7274      * has */
7275
7276     SvPV_shrink_to_cur((SV *) invlist);
7277 }
7278
7279 #define _invlist_union_complement_2nd(a, b, output) _invlist_union_maybe_complement_2nd(a, b, TRUE, output)
7280
7281 STATIC void
7282 S__append_range_to_invlist(pTHX_ SV* const invlist, const UV start, const UV end)
7283 {
7284    /* Subject to change or removal.  Append the range from 'start' to 'end' at
7285     * the end of the inversion list.  The range must be above any existing
7286     * ones. */
7287
7288     UV* array;
7289     UV max = invlist_max(invlist);
7290     UV len = _invlist_len(invlist);
7291
7292     PERL_ARGS_ASSERT__APPEND_RANGE_TO_INVLIST;
7293
7294     if (len == 0) { /* Empty lists must be initialized */
7295         array = _invlist_array_init(invlist, start == 0);
7296     }
7297     else {
7298         /* Here, the existing list is non-empty. The current max entry in the
7299          * list is generally the first value not in the set, except when the
7300          * set extends to the end of permissible values, in which case it is
7301          * the first entry in that final set, and so this call is an attempt to
7302          * append out-of-order */
7303
7304         UV final_element = len - 1;
7305         array = invlist_array(invlist);
7306         if (array[final_element] > start
7307             || ELEMENT_RANGE_MATCHES_INVLIST(final_element))
7308         {
7309             Perl_croak(aTHX_ "panic: attempting to append to an inversion list, but wasn't at the end of the list, final=%"UVuf", start=%"UVuf", match=%c",
7310                        array[final_element], start,
7311                        ELEMENT_RANGE_MATCHES_INVLIST(final_element) ? 't' : 'f');
7312         }
7313
7314         /* Here, it is a legal append.  If the new range begins with the first
7315          * value not in the set, it is extending the set, so the new first
7316          * value not in the set is one greater than the newly extended range.
7317          * */
7318         if (array[final_element] == start) {
7319             if (end != UV_MAX) {
7320                 array[final_element] = end + 1;
7321             }
7322             else {
7323                 /* But if the end is the maximum representable on the machine,
7324                  * just let the range that this would extend to have no end */
7325                 invlist_set_len(invlist, len - 1);
7326             }
7327             return;
7328         }
7329     }
7330
7331     /* Here the new range doesn't extend any existing set.  Add it */
7332
7333     len += 2;   /* Includes an element each for the start and end of range */
7334
7335     /* If overflows the existing space, extend, which may cause the array to be
7336      * moved */
7337     if (max < len) {
7338         invlist_extend(invlist, len);
7339         invlist_set_len(invlist, len);  /* Have to set len here to avoid assert
7340                                            failure in invlist_array() */
7341         array = invlist_array(invlist);
7342     }
7343     else {
7344         invlist_set_len(invlist, len);
7345     }
7346
7347     /* The next item on the list starts the range, the one after that is
7348      * one past the new range.  */
7349     array[len - 2] = start;
7350     if (end != UV_MAX) {
7351         array[len - 1] = end + 1;
7352     }
7353     else {
7354         /* But if the end is the maximum representable on the machine, just let
7355          * the range have no end */
7356         invlist_set_len(invlist, len - 1);
7357     }
7358 }
7359
7360 #ifndef PERL_IN_XSUB_RE
7361
7362 IV
7363 Perl__invlist_search(pTHX_ SV* const invlist, const UV cp)
7364 {
7365     /* Searches the inversion list for the entry that contains the input code
7366      * point <cp>.  If <cp> is not in the list, -1 is returned.  Otherwise, the
7367      * return value is the index into the list's array of the range that
7368      * contains <cp> */
7369
7370     IV low = 0;
7371     IV mid;
7372     IV high = _invlist_len(invlist);
7373     const IV highest_element = high - 1;
7374     const UV* array;
7375
7376     PERL_ARGS_ASSERT__INVLIST_SEARCH;
7377
7378     /* If list is empty, return failure. */
7379     if (high == 0) {
7380         return -1;
7381     }
7382
7383     /* (We can't get the array unless we know the list is non-empty) */
7384     array = invlist_array(invlist);
7385
7386     mid = invlist_previous_index(invlist);
7387     assert(mid >=0 && mid <= highest_element);
7388
7389     /* <mid> contains the cache of the result of the previous call to this
7390      * function (0 the first time).  See if this call is for the same result,
7391      * or if it is for mid-1.  This is under the theory that calls to this
7392      * function will often be for related code points that are near each other.
7393      * And benchmarks show that caching gives better results.  We also test
7394      * here if the code point is within the bounds of the list.  These tests
7395      * replace others that would have had to be made anyway to make sure that
7396      * the array bounds were not exceeded, and these give us extra information
7397      * at the same time */
7398     if (cp >= array[mid]) {
7399         if (cp >= array[highest_element]) {
7400             return highest_element;
7401         }
7402
7403         /* Here, array[mid] <= cp < array[highest_element].  This means that
7404          * the final element is not the answer, so can exclude it; it also
7405          * means that <mid> is not the final element, so can refer to 'mid + 1'
7406          * safely */
7407         if (cp < array[mid + 1]) {
7408             return mid;
7409         }
7410         high--;
7411         low = mid + 1;
7412     }
7413     else { /* cp < aray[mid] */
7414         if (cp < array[0]) { /* Fail if outside the array */
7415             return -1;
7416         }
7417         high = mid;
7418         if (cp >= array[mid - 1]) {
7419             goto found_entry;
7420         }
7421     }
7422
7423     /* Binary search.  What we are looking for is <i> such that
7424      *  array[i] <= cp < array[i+1]
7425      * The loop below converges on the i+1.  Note that there may not be an
7426      * (i+1)th element in the array, and things work nonetheless */
7427     while (low < high) {
7428         mid = (low + high) / 2;
7429         assert(mid <= highest_element);
7430         if (array[mid] <= cp) { /* cp >= array[mid] */
7431             low = mid + 1;
7432
7433             /* We could do this extra test to exit the loop early.
7434             if (cp < array[low]) {
7435                 return mid;
7436             }
7437             */
7438         }
7439         else { /* cp < array[mid] */
7440             high = mid;
7441         }
7442     }
7443
7444   found_entry:
7445     high--;
7446     invlist_set_previous_index(invlist, high);
7447     return high;
7448 }
7449
7450 void
7451 Perl__invlist_populate_swatch(pTHX_ SV* const invlist, const UV start, const UV end, U8* swatch)
7452 {
7453     /* populates a swatch of a swash the same way swatch_get() does in utf8.c,
7454      * but is used when the swash has an inversion list.  This makes this much
7455      * faster, as it uses a binary search instead of a linear one.  This is
7456      * intimately tied to that function, and perhaps should be in utf8.c,
7457      * except it is intimately tied to inversion lists as well.  It assumes
7458      * that <swatch> is all 0's on input */
7459
7460     UV current = start;
7461     const IV len = _invlist_len(invlist);
7462     IV i;
7463     const UV * array;
7464
7465     PERL_ARGS_ASSERT__INVLIST_POPULATE_SWATCH;
7466
7467     if (len == 0) { /* Empty inversion list */
7468         return;
7469     }
7470
7471     array = invlist_array(invlist);
7472
7473     /* Find which element it is */
7474     i = _invlist_search(invlist, start);
7475
7476     /* We populate from <start> to <end> */
7477     while (current < end) {
7478         UV upper;
7479
7480         /* The inversion list gives the results for every possible code point
7481          * after the first one in the list.  Only those ranges whose index is
7482          * even are ones that the inversion list matches.  For the odd ones,
7483          * and if the initial code point is not in the list, we have to skip
7484          * forward to the next element */
7485         if (i == -1 || ! ELEMENT_RANGE_MATCHES_INVLIST(i)) {
7486             i++;
7487             if (i >= len) { /* Finished if beyond the end of the array */
7488                 return;
7489             }
7490             current = array[i];
7491             if (current >= end) {   /* Finished if beyond the end of what we
7492                                        are populating */
7493                 if (LIKELY(end < UV_MAX)) {
7494                     return;
7495                 }
7496
7497                 /* We get here when the upper bound is the maximum
7498                  * representable on the machine, and we are looking for just
7499                  * that code point.  Have to special case it */
7500                 i = len;
7501                 goto join_end_of_list;
7502             }
7503         }
7504         assert(current >= start);
7505
7506         /* The current range ends one below the next one, except don't go past
7507          * <end> */
7508         i++;
7509         upper = (i < len && array[i] < end) ? array[i] : end;
7510
7511         /* Here we are in a range that matches.  Populate a bit in the 3-bit U8
7512          * for each code point in it */
7513         for (; current < upper; current++) {
7514             const STRLEN offset = (STRLEN)(current - start);
7515             swatch[offset >> 3] |= 1 << (offset & 7);
7516         }
7517
7518     join_end_of_list:
7519
7520         /* Quit if at the end of the list */
7521         if (i >= len) {
7522
7523             /* But first, have to deal with the highest possible code point on
7524              * the platform.  The previous code assumes that <end> is one
7525              * beyond where we want to populate, but that is impossible at the
7526              * platform's infinity, so have to handle it specially */
7527             if (UNLIKELY(end == UV_MAX && ELEMENT_RANGE_MATCHES_INVLIST(len-1)))
7528             {
7529                 const STRLEN offset = (STRLEN)(end - start);
7530                 swatch[offset >> 3] |= 1 << (offset & 7);
7531             }
7532             return;
7533         }
7534
7535         /* Advance to the next range, which will be for code points not in the
7536          * inversion list */
7537         current = array[i];
7538     }
7539
7540     return;
7541 }
7542
7543 void
7544 Perl__invlist_union_maybe_complement_2nd(pTHX_ SV* const a, SV* const b, bool complement_b, SV** output)
7545 {
7546     /* Take the union of two inversion lists and point <output> to it.  *output
7547      * SHOULD BE DEFINED upon input, and if it points to one of the two lists,
7548      * the reference count to that list will be decremented.  The first list,
7549      * <a>, may be NULL, in which case a copy of the second list is returned.
7550      * If <complement_b> is TRUE, the union is taken of the complement
7551      * (inversion) of <b> instead of b itself.
7552      *
7553      * The basis for this comes from "Unicode Demystified" Chapter 13 by
7554      * Richard Gillam, published by Addison-Wesley, and explained at some
7555      * length there.  The preface says to incorporate its examples into your
7556      * code at your own risk.
7557      *
7558      * The algorithm is like a merge sort.
7559      *
7560      * XXX A potential performance improvement is to keep track as we go along
7561      * if only one of the inputs contributes to the result, meaning the other
7562      * is a subset of that one.  In that case, we can skip the final copy and
7563      * return the larger of the input lists, but then outside code might need
7564      * to keep track of whether to free the input list or not */
7565
7566     UV* array_a;    /* a's array */
7567     UV* array_b;
7568     UV len_a;       /* length of a's array */
7569     UV len_b;
7570
7571     SV* u;                      /* the resulting union */
7572     UV* array_u;
7573     UV len_u;
7574
7575     UV i_a = 0;             /* current index into a's array */
7576     UV i_b = 0;
7577     UV i_u = 0;
7578
7579     /* running count, as explained in the algorithm source book; items are
7580      * stopped accumulating and are output when the count changes to/from 0.
7581      * The count is incremented when we start a range that's in the set, and
7582      * decremented when we start a range that's not in the set.  So its range
7583      * is 0 to 2.  Only when the count is zero is something not in the set.
7584      */
7585     UV count = 0;
7586
7587     PERL_ARGS_ASSERT__INVLIST_UNION_MAYBE_COMPLEMENT_2ND;
7588     assert(a != b);
7589
7590     /* If either one is empty, the union is the other one */
7591     if (a == NULL || ((len_a = _invlist_len(a)) == 0)) {
7592         if (*output == a) {
7593             if (a != NULL) {
7594                 SvREFCNT_dec_NN(a);
7595             }
7596         }
7597         if (*output != b) {
7598             *output = invlist_clone(b);
7599             if (complement_b) {
7600                 _invlist_invert(*output);
7601             }
7602         } /* else *output already = b; */
7603         return;
7604     }
7605     else if ((len_b = _invlist_len(b)) == 0) {
7606         if (*output == b) {
7607             SvREFCNT_dec_NN(b);
7608         }
7609
7610         /* The complement of an empty list is a list that has everything in it,
7611          * so the union with <a> includes everything too */
7612         if (complement_b) {
7613             if (a == *output) {
7614                 SvREFCNT_dec_NN(a);
7615             }
7616             *output = _new_invlist(1);
7617             _append_range_to_invlist(*output, 0, UV_MAX);
7618         }
7619         else if (*output != a) {
7620             *output = invlist_clone(a);
7621         }
7622         /* else *output already = a; */
7623         return;
7624     }
7625
7626     /* Here both lists exist and are non-empty */
7627     array_a = invlist_array(a);
7628     array_b = invlist_array(b);
7629
7630     /* If are to take the union of 'a' with the complement of b, set it
7631      * up so are looking at b's complement. */
7632     if (complement_b) {
7633
7634         /* To complement, we invert: if the first element is 0, remove it.  To
7635          * do this, we just pretend the array starts one later, and clear the
7636          * flag as we don't have to do anything else later */
7637         if (array_b[0] == 0) {
7638             array_b++;
7639             len_b--;
7640             complement_b = FALSE;
7641         }
7642         else {
7643
7644             /* But if the first element is not zero, we unshift a 0 before the
7645              * array.  The data structure reserves a space for that 0 (which
7646              * should be a '1' right now), so physical shifting is unneeded,
7647              * but temporarily change that element to 0.  Before exiting the
7648              * routine, we must restore the element to '1' */
7649             array_b--;
7650             len_b++;
7651             array_b[0] = 0;
7652         }
7653     }
7654
7655     /* Size the union for the worst case: that the sets are completely
7656      * disjoint */
7657     u = _new_invlist(len_a + len_b);
7658
7659     /* Will contain U+0000 if either component does */
7660     array_u = _invlist_array_init(u, (len_a > 0 && array_a[0] == 0)
7661                                       || (len_b > 0 && array_b[0] == 0));
7662
7663     /* Go through each list item by item, stopping when exhausted one of
7664      * them */
7665     while (i_a < len_a && i_b < len_b) {
7666         UV cp;      /* The element to potentially add to the union's array */
7667         bool cp_in_set;   /* is it in the the input list's set or not */
7668
7669         /* We need to take one or the other of the two inputs for the union.
7670          * Since we are merging two sorted lists, we take the smaller of the
7671          * next items.  In case of a tie, we take the one that is in its set
7672          * first.  If we took one not in the set first, it would decrement the
7673          * count, possibly to 0 which would cause it to be output as ending the
7674          * range, and the next time through we would take the same number, and
7675          * output it again as beginning the next range.  By doing it the
7676          * opposite way, there is no possibility that the count will be
7677          * momentarily decremented to 0, and thus the two adjoining ranges will
7678          * be seamlessly merged.  (In a tie and both are in the set or both not
7679          * in the set, it doesn't matter which we take first.) */
7680         if (array_a[i_a] < array_b[i_b]
7681             || (array_a[i_a] == array_b[i_b]
7682                 && ELEMENT_RANGE_MATCHES_INVLIST(i_a)))
7683         {
7684             cp_in_set = ELEMENT_RANGE_MATCHES_INVLIST(i_a);
7685             cp= array_a[i_a++];
7686         }
7687         else {
7688             cp_in_set = ELEMENT_RANGE_MATCHES_INVLIST(i_b);
7689             cp = array_b[i_b++];
7690         }
7691
7692         /* Here, have chosen which of the two inputs to look at.  Only output
7693          * if the running count changes to/from 0, which marks the
7694          * beginning/end of a range in that's in the set */
7695         if (cp_in_set) {
7696             if (count == 0) {
7697                 array_u[i_u++] = cp;
7698             }
7699             count++;
7700         }
7701         else {
7702             count--;
7703             if (count == 0) {
7704                 array_u[i_u++] = cp;
7705             }
7706         }
7707     }
7708
7709     /* Here, we are finished going through at least one of the lists, which
7710      * means there is something remaining in at most one.  We check if the list
7711      * that hasn't been exhausted is positioned such that we are in the middle
7712      * of a range in its set or not.  (i_a and i_b point to the element beyond
7713      * the one we care about.) If in the set, we decrement 'count'; if 0, there
7714      * is potentially more to output.
7715      * There are four cases:
7716      *  1) Both weren't in their sets, count is 0, and remains 0.  What's left
7717      *     in the union is entirely from the non-exhausted set.
7718      *  2) Both were in their sets, count is 2.  Nothing further should
7719      *     be output, as everything that remains will be in the exhausted
7720      *     list's set, hence in the union; decrementing to 1 but not 0 insures
7721      *     that
7722      *  3) the exhausted was in its set, non-exhausted isn't, count is 1.
7723      *     Nothing further should be output because the union includes
7724      *     everything from the exhausted set.  Not decrementing ensures that.
7725      *  4) the exhausted wasn't in its set, non-exhausted is, count is 1;
7726      *     decrementing to 0 insures that we look at the remainder of the
7727      *     non-exhausted set */
7728     if ((i_a != len_a && PREV_RANGE_MATCHES_INVLIST(i_a))
7729         || (i_b != len_b && PREV_RANGE_MATCHES_INVLIST(i_b)))
7730     {
7731         count--;
7732     }
7733
7734     /* The final length is what we've output so far, plus what else is about to
7735      * be output.  (If 'count' is non-zero, then the input list we exhausted
7736      * has everything remaining up to the machine's limit in its set, and hence
7737      * in the union, so there will be no further output. */
7738     len_u = i_u;
7739     if (count == 0) {
7740         /* At most one of the subexpressions will be non-zero */
7741         len_u += (len_a - i_a) + (len_b - i_b);
7742     }
7743
7744     /* Set result to final length, which can change the pointer to array_u, so
7745      * re-find it */
7746     if (len_u != _invlist_len(u)) {
7747         invlist_set_len(u, len_u);
7748         invlist_trim(u);
7749         array_u = invlist_array(u);
7750     }
7751
7752     /* When 'count' is 0, the list that was exhausted (if one was shorter than
7753      * the other) ended with everything above it not in its set.  That means
7754      * that the remaining part of the union is precisely the same as the
7755      * non-exhausted list, so can just copy it unchanged.  (If both list were
7756      * exhausted at the same time, then the operations below will be both 0.)
7757      */
7758     if (count == 0) {
7759         IV copy_count; /* At most one will have a non-zero copy count */
7760         if ((copy_count = len_a - i_a) > 0) {
7761             Copy(array_a + i_a, array_u + i_u, copy_count, UV);
7762         }
7763         else if ((copy_count = len_b - i_b) > 0) {
7764             Copy(array_b + i_b, array_u + i_u, copy_count, UV);
7765         }
7766     }
7767
7768     /* If we've changed b, restore it */
7769     if (complement_b) {
7770         array_b[0] = 1;
7771     }
7772
7773     /*  We may be removing a reference to one of the inputs */
7774     if (a == *output || b == *output) {
7775         assert(! invlist_is_iterating(*output));
7776         SvREFCNT_dec_NN(*output);
7777     }
7778
7779     *output = u;
7780     return;
7781 }
7782
7783 void
7784 Perl__invlist_intersection_maybe_complement_2nd(pTHX_ SV* const a, SV* const b, bool complement_b, SV** i)
7785 {
7786     /* Take the intersection of two inversion lists and point <i> to it.  *i
7787      * SHOULD BE DEFINED upon input, and if it points to one of the two lists,
7788      * the reference count to that list will be decremented.
7789      * If <complement_b> is TRUE, the result will be the intersection of <a>
7790      * and the complement (or inversion) of <b> instead of <b> directly.
7791      *
7792      * The basis for this comes from "Unicode Demystified" Chapter 13 by
7793      * Richard Gillam, published by Addison-Wesley, and explained at some
7794      * length there.  The preface says to incorporate its examples into your
7795      * code at your own risk.  In fact, it had bugs
7796      *
7797      * The algorithm is like a merge sort, and is essentially the same as the
7798      * union above
7799      */
7800
7801     UV* array_a;                /* a's array */
7802     UV* array_b;
7803     UV len_a;   /* length of a's array */
7804     UV len_b;
7805
7806     SV* r;                   /* the resulting intersection */
7807     UV* array_r;
7808     UV len_r;
7809
7810     UV i_a = 0;             /* current index into a's array */
7811     UV i_b = 0;
7812     UV i_r = 0;
7813
7814     /* running count, as explained in the algorithm source book; items are
7815      * stopped accumulating and are output when the count changes to/from 2.
7816      * The count is incremented when we start a range that's in the set, and
7817      * decremented when we start a range that's not in the set.  So its range
7818      * is 0 to 2.  Only when the count is 2 is something in the intersection.
7819      */
7820     UV count = 0;
7821
7822     PERL_ARGS_ASSERT__INVLIST_INTERSECTION_MAYBE_COMPLEMENT_2ND;
7823     assert(a != b);
7824
7825     /* Special case if either one is empty */
7826     len_a = _invlist_len(a);
7827     if ((len_a == 0) || ((len_b = _invlist_len(b)) == 0)) {
7828
7829         if (len_a != 0 && complement_b) {
7830
7831             /* Here, 'a' is not empty, therefore from the above 'if', 'b' must
7832              * be empty.  Here, also we are using 'b's complement, which hence
7833              * must be every possible code point.  Thus the intersection is
7834              * simply 'a'. */
7835             if (*i != a) {
7836                 *i = invlist_clone(a);
7837
7838                 if (*i == b) {
7839                     SvREFCNT_dec_NN(b);
7840                 }
7841             }
7842             /* else *i is already 'a' */
7843             return;
7844         }
7845
7846         /* Here, 'a' or 'b' is empty and not using the complement of 'b'.  The
7847          * intersection must be empty */
7848         if (*i == a) {
7849             SvREFCNT_dec_NN(a);
7850         }
7851         else if (*i == b) {
7852             SvREFCNT_dec_NN(b);
7853         }
7854         *i = _new_invlist(0);
7855         return;
7856     }
7857
7858     /* Here both lists exist and are non-empty */
7859     array_a = invlist_array(a);
7860     array_b = invlist_array(b);
7861
7862     /* If are to take the intersection of 'a' with the complement of b, set it
7863      * up so are looking at b's complement. */
7864     if (complement_b) {
7865
7866         /* To complement, we invert: if the first element is 0, remove it.  To
7867          * do this, we just pretend the array starts one later, and clear the
7868          * flag as we don't have to do anything else later */
7869         if (array_b[0] == 0) {
7870             array_b++;
7871             len_b--;
7872             complement_b = FALSE;
7873         }
7874         else {
7875
7876             /* But if the first element is not zero, we unshift a 0 before the
7877              * array.  The data structure reserves a space for that 0 (which
7878              * should be a '1' right now), so physical shifting is unneeded,
7879              * but temporarily change that element to 0.  Before exiting the
7880              * routine, we must restore the element to '1' */
7881             array_b--;
7882             len_b++;
7883             array_b[0] = 0;
7884         }
7885     }
7886
7887     /* Size the intersection for the worst case: that the intersection ends up
7888      * fragmenting everything to be completely disjoint */
7889     r= _new_invlist(len_a + len_b);
7890
7891     /* Will contain U+0000 iff both components do */
7892     array_r = _invlist_array_init(r, len_a > 0 && array_a[0] == 0
7893                                      && len_b > 0 && array_b[0] == 0);
7894
7895     /* Go through each list item by item, stopping when exhausted one of
7896      * them */
7897     while (i_a < len_a && i_b < len_b) {
7898         UV cp;      /* The element to potentially add to the intersection's
7899                        array */
7900         bool cp_in_set; /* Is it in the input list's set or not */
7901
7902         /* We need to take one or the other of the two inputs for the
7903          * intersection.  Since we are merging two sorted lists, we take the
7904          * smaller of the next items.  In case of a tie, we take the one that
7905          * is not in its set first (a difference from the union algorithm).  If
7906          * we took one in the set first, it would increment the count, possibly
7907          * to 2 which would cause it to be output as starting a range in the
7908          * intersection, and the next time through we would take that same
7909          * number, and output it again as ending the set.  By doing it the
7910          * opposite of this, there is no possibility that the count will be
7911          * momentarily incremented to 2.  (In a tie and both are in the set or
7912          * both not in the set, it doesn't matter which we take first.) */
7913         if (array_a[i_a] < array_b[i_b]
7914             || (array_a[i_a] == array_b[i_b]
7915                 && ! ELEMENT_RANGE_MATCHES_INVLIST(i_a)))
7916         {
7917             cp_in_set = ELEMENT_RANGE_MATCHES_INVLIST(i_a);
7918             cp= array_a[i_a++];
7919         }
7920         else {
7921             cp_in_set = ELEMENT_RANGE_MATCHES_INVLIST(i_b);
7922             cp= array_b[i_b++];
7923         }
7924
7925         /* Here, have chosen which of the two inputs to look at.  Only output
7926          * if the running count changes to/from 2, which marks the
7927          * beginning/end of a range that's in the intersection */
7928         if (cp_in_set) {
7929             count++;
7930             if (count == 2) {
7931                 array_r[i_r++] = cp;
7932             }
7933         }
7934         else {
7935             if (count == 2) {
7936                 array_r[i_r++] = cp;
7937             }
7938             count--;
7939         }
7940     }
7941
7942     /* Here, we are finished going through at least one of the lists, which
7943      * means there is something remaining in at most one.  We check if the list
7944      * that has been exhausted is positioned such that we are in the middle
7945      * of a range in its set or not.  (i_a and i_b point to elements 1 beyond
7946      * the ones we care about.)  There are four cases:
7947      *  1) Both weren't in their sets, count is 0, and remains 0.  There's
7948      *     nothing left in the intersection.
7949      *  2) Both were in their sets, count is 2 and perhaps is incremented to
7950      *     above 2.  What should be output is exactly that which is in the
7951      *     non-exhausted set, as everything it has is also in the intersection
7952      *     set, and everything it doesn't have can't be in the intersection
7953      *  3) The exhausted was in its set, non-exhausted isn't, count is 1, and
7954      *     gets incremented to 2.  Like the previous case, the intersection is
7955      *     everything that remains in the non-exhausted set.
7956      *  4) the exhausted wasn't in its set, non-exhausted is, count is 1, and
7957      *     remains 1.  And the intersection has nothing more. */
7958     if ((i_a == len_a && PREV_RANGE_MATCHES_INVLIST(i_a))
7959         || (i_b == len_b && PREV_RANGE_MATCHES_INVLIST(i_b)))
7960     {
7961         count++;
7962     }
7963
7964     /* The final length is what we've output so far plus what else is in the
7965      * intersection.  At most one of the subexpressions below will be non-zero */
7966     len_r = i_r;
7967     if (count >= 2) {
7968         len_r += (len_a - i_a) + (len_b - i_b);
7969     }
7970
7971     /* Set result to final length, which can change the pointer to array_r, so
7972      * re-find it */
7973     if (len_r != _invlist_len(r)) {
7974         invlist_set_len(r, len_r);
7975         invlist_trim(r);
7976         array_r = invlist_array(r);
7977     }
7978
7979     /* Finish outputting any remaining */
7980     if (count >= 2) { /* At most one will have a non-zero copy count */
7981         IV copy_count;
7982         if ((copy_count = len_a - i_a) > 0) {
7983             Copy(array_a + i_a, array_r + i_r, copy_count, UV);
7984         }
7985         else if ((copy_count = len_b - i_b) > 0) {
7986             Copy(array_b + i_b, array_r + i_r, copy_count, UV);
7987         }
7988     }
7989
7990     /* If we've changed b, restore it */
7991     if (complement_b) {
7992         array_b[0] = 1;
7993     }
7994
7995     /*  We may be removing a reference to one of the inputs */
7996     if (a == *i || b == *i) {
7997         assert(! invlist_is_iterating(*i));
7998         SvREFCNT_dec_NN(*i);
7999     }
8000
8001     *i = r;
8002     return;
8003 }
8004
8005 SV*
8006 Perl__add_range_to_invlist(pTHX_ SV* invlist, const UV start, const UV end)
8007 {
8008     /* Add the range from 'start' to 'end' inclusive to the inversion list's
8009      * set.  A pointer to the inversion list is returned.  This may actually be
8010      * a new list, in which case the passed in one has been destroyed.  The
8011      * passed in inversion list can be NULL, in which case a new one is created
8012      * with just the one range in it */
8013
8014     SV* range_invlist;
8015     UV len;
8016
8017     if (invlist == NULL) {
8018         invlist = _new_invlist(2);
8019         len = 0;
8020     }
8021     else {
8022         len = _invlist_len(invlist);
8023     }
8024
8025     /* If comes after the final entry actually in the list, can just append it
8026      * to the end, */
8027     if (len == 0
8028         || (! ELEMENT_RANGE_MATCHES_INVLIST(len - 1)
8029             && start >= invlist_array(invlist)[len - 1]))
8030     {
8031         _append_range_to_invlist(invlist, start, end);
8032         return invlist;
8033     }
8034
8035     /* Here, can't just append things, create and return a new inversion list
8036      * which is the union of this range and the existing inversion list */
8037     range_invlist = _new_invlist(2);
8038     _append_range_to_invlist(range_invlist, start, end);
8039
8040     _invlist_union(invlist, range_invlist, &invlist);
8041
8042     /* The temporary can be freed */
8043     SvREFCNT_dec_NN(range_invlist);
8044
8045     return invlist;
8046 }
8047
8048 #endif
8049
8050 PERL_STATIC_INLINE SV*
8051 S_add_cp_to_invlist(pTHX_ SV* invlist, const UV cp) {
8052     return _add_range_to_invlist(invlist, cp, cp);
8053 }
8054
8055 #ifndef PERL_IN_XSUB_RE
8056 void
8057 Perl__invlist_invert(pTHX_ SV* const invlist)
8058 {
8059     /* Complement the input inversion list.  This adds a 0 if the list didn't
8060      * have a zero; removes it otherwise.  As described above, the data
8061      * structure is set up so that this is very efficient */
8062
8063     UV* len_pos = _get_invlist_len_addr(invlist);
8064
8065     PERL_ARGS_ASSERT__INVLIST_INVERT;
8066
8067     assert(! invlist_is_iterating(invlist));
8068
8069     /* The inverse of matching nothing is matching everything */
8070     if (*len_pos == 0) {
8071         _append_range_to_invlist(invlist, 0, UV_MAX);
8072         return;
8073     }
8074
8075     /* The exclusive or complents 0 to 1; and 1 to 0.  If the result is 1, the
8076      * zero element was a 0, so it is being removed, so the length decrements
8077      * by 1; and vice-versa.  SvCUR is unaffected */
8078     if (*get_invlist_zero_addr(invlist) ^= 1) {
8079         (*len_pos)--;
8080     }
8081     else {
8082         (*len_pos)++;
8083     }
8084 }
8085
8086 void
8087 Perl__invlist_invert_prop(pTHX_ SV* const invlist)
8088 {
8089     /* Complement the input inversion list (which must be a Unicode property,
8090      * all of which don't match above the Unicode maximum code point.)  And
8091      * Perl has chosen to not have the inversion match above that either.  This
8092      * adds a 0x110000 if the list didn't end with it, and removes it if it did
8093      */
8094
8095     UV len;
8096     UV* array;
8097
8098     PERL_ARGS_ASSERT__INVLIST_INVERT_PROP;
8099
8100     _invlist_invert(invlist);
8101
8102     len = _invlist_len(invlist);
8103
8104     if (len != 0) { /* If empty do nothing */
8105         array = invlist_array(invlist);
8106         if (array[len - 1] != PERL_UNICODE_MAX + 1) {
8107             /* Add 0x110000.  First, grow if necessary */
8108             len++;
8109             if (invlist_max(invlist) < len) {
8110                 invlist_extend(invlist, len);
8111                 array = invlist_array(invlist);
8112             }
8113             invlist_set_len(invlist, len);
8114             array[len - 1] = PERL_UNICODE_MAX + 1;
8115         }
8116         else {  /* Remove the 0x110000 */
8117             invlist_set_len(invlist, len - 1);
8118         }
8119     }
8120
8121     return;
8122 }
8123 #endif
8124
8125 PERL_STATIC_INLINE SV*
8126 S_invlist_clone(pTHX_ SV* const invlist)
8127 {
8128
8129     /* Return a new inversion list that is a copy of the input one, which is
8130      * unchanged */
8131
8132     /* Need to allocate extra space to accommodate Perl's addition of a
8133      * trailing NUL to SvPV's, since it thinks they are always strings */
8134     SV* new_invlist = _new_invlist(_invlist_len(invlist) + 1);
8135     STRLEN length = SvCUR(invlist);
8136
8137     PERL_ARGS_ASSERT_INVLIST_CLONE;
8138
8139     SvCUR_set(new_invlist, length); /* This isn't done automatically */
8140     Copy(SvPVX(invlist), SvPVX(new_invlist), length, char);
8141
8142     return new_invlist;
8143 }
8144
8145 PERL_STATIC_INLINE UV*
8146 S_get_invlist_iter_addr(pTHX_ SV* invlist)
8147 {
8148     /* Return the address of the UV that contains the current iteration
8149      * position */
8150
8151     PERL_ARGS_ASSERT_GET_INVLIST_ITER_ADDR;
8152
8153     return (UV *) (SvPVX(invlist) + (INVLIST_ITER_OFFSET * sizeof (UV)));
8154 }
8155
8156 PERL_STATIC_INLINE UV*
8157 S_get_invlist_version_id_addr(pTHX_ SV* invlist)
8158 {
8159     /* Return the address of the UV that contains the version id. */
8160
8161     PERL_ARGS_ASSERT_GET_INVLIST_VERSION_ID_ADDR;
8162
8163     return (UV *) (SvPVX(invlist) + (INVLIST_VERSION_ID_OFFSET * sizeof (UV)));
8164 }
8165
8166 PERL_STATIC_INLINE void
8167 S_invlist_iterinit(pTHX_ SV* invlist)   /* Initialize iterator for invlist */
8168 {
8169     PERL_ARGS_ASSERT_INVLIST_ITERINIT;
8170
8171     *get_invlist_iter_addr(invlist) = 0;
8172 }
8173
8174 PERL_STATIC_INLINE void
8175 S_invlist_iterfinish(pTHX_ SV* invlist)
8176 {
8177     /* Terminate iterator for invlist.  This is to catch development errors.
8178      * Any iteration that is interrupted before completed should call this
8179      * function.  Functions that add code points anywhere else but to the end
8180      * of an inversion list assert that they are not in the middle of an
8181      * iteration.  If they were, the addition would make the iteration
8182      * problematical: if the iteration hadn't reached the place where things
8183      * were being added, it would be ok */
8184
8185     PERL_ARGS_ASSERT_INVLIST_ITERFINISH;
8186
8187     *get_invlist_iter_addr(invlist) = UV_MAX;
8188 }
8189
8190 STATIC bool
8191 S_invlist_iternext(pTHX_ SV* invlist, UV* start, UV* end)
8192 {
8193     /* An C<invlist_iterinit> call on <invlist> must be used to set this up.
8194      * This call sets in <*start> and <*end>, the next range in <invlist>.
8195      * Returns <TRUE> if successful and the next call will return the next
8196      * range; <FALSE> if was already at the end of the list.  If the latter,
8197      * <*start> and <*end> are unchanged, and the next call to this function
8198      * will start over at the beginning of the list */
8199
8200     UV* pos = get_invlist_iter_addr(invlist);
8201     UV len = _invlist_len(invlist);
8202     UV *array;
8203
8204     PERL_ARGS_ASSERT_INVLIST_ITERNEXT;
8205
8206     if (*pos >= len) {
8207         *pos = UV_MAX;  /* Force iterinit() to be required next time */
8208         return FALSE;
8209     }
8210
8211     array = invlist_array(invlist);
8212
8213     *start = array[(*pos)++];
8214
8215     if (*pos >= len) {
8216         *end = UV_MAX;
8217     }
8218     else {
8219         *end = array[(*pos)++] - 1;
8220     }
8221
8222     return TRUE;
8223 }
8224
8225 PERL_STATIC_INLINE bool
8226 S_invlist_is_iterating(pTHX_ SV* const invlist)
8227 {
8228     PERL_ARGS_ASSERT_INVLIST_IS_ITERATING;
8229
8230     return *(get_invlist_iter_addr(invlist)) < UV_MAX;
8231 }
8232
8233 PERL_STATIC_INLINE UV
8234 S_invlist_highest(pTHX_ SV* const invlist)
8235 {
8236     /* Returns the highest code point that matches an inversion list.  This API
8237      * has an ambiguity, as it returns 0 under either the highest is actually
8238      * 0, or if the list is empty.  If this distinction matters to you, check
8239      * for emptiness before calling this function */
8240
8241     UV len = _invlist_len(invlist);
8242     UV *array;
8243
8244     PERL_ARGS_ASSERT_INVLIST_HIGHEST;
8245
8246     if (len == 0) {
8247         return 0;
8248     }
8249
8250     array = invlist_array(invlist);
8251
8252     /* The last element in the array in the inversion list always starts a
8253      * range that goes to infinity.  That range may be for code points that are
8254      * matched in the inversion list, or it may be for ones that aren't
8255      * matched.  In the latter case, the highest code point in the set is one
8256      * less than the beginning of this range; otherwise it is the final element
8257      * of this range: infinity */
8258     return (ELEMENT_RANGE_MATCHES_INVLIST(len - 1))
8259            ? UV_MAX
8260            : array[len - 1] - 1;
8261 }
8262
8263 #ifndef PERL_IN_XSUB_RE
8264 SV *
8265 Perl__invlist_contents(pTHX_ SV* const invlist)
8266 {
8267     /* Get the contents of an inversion list into a string SV so that they can
8268      * be printed out.  It uses the format traditionally done for debug tracing
8269      */
8270
8271     UV start, end;
8272     SV* output = newSVpvs("\n");
8273
8274     PERL_ARGS_ASSERT__INVLIST_CONTENTS;
8275
8276     assert(! invlist_is_iterating(invlist));
8277
8278     invlist_iterinit(invlist);
8279     while (invlist_iternext(invlist, &start, &end)) {
8280         if (end == UV_MAX) {
8281             Perl_sv_catpvf(aTHX_ output, "%04"UVXf"\tINFINITY\n", start);
8282         }
8283         else if (end != start) {
8284             Perl_sv_catpvf(aTHX_ output, "%04"UVXf"\t%04"UVXf"\n",
8285                     start,       end);
8286         }
8287         else {
8288             Perl_sv_catpvf(aTHX_ output, "%04"UVXf"\n", start);
8289         }
8290     }
8291
8292     return output;
8293 }
8294 #endif
8295
8296 #ifdef PERL_ARGS_ASSERT__INVLIST_DUMP
8297 void
8298 Perl__invlist_dump(pTHX_ SV* const invlist, const char * const header)
8299 {
8300     /* Dumps out the ranges in an inversion list.  The string 'header'
8301      * if present is output on a line before the first range */
8302
8303     UV start, end;
8304
8305     PERL_ARGS_ASSERT__INVLIST_DUMP;
8306
8307     if (header && strlen(header)) {
8308         PerlIO_printf(Perl_debug_log, "%s\n", header);
8309     }
8310     if (invlist_is_iterating(invlist)) {
8311         PerlIO_printf(Perl_debug_log, "Can't dump because is in middle of iterating\n");
8312         return;
8313     }
8314
8315     invlist_iterinit(invlist);
8316     while (invlist_iternext(invlist, &start, &end)) {
8317         if (end == UV_MAX) {
8318             PerlIO_printf(Perl_debug_log, "0x%04"UVXf" .. INFINITY\n", start);
8319         }
8320         else if (end != start) {
8321             PerlIO_printf(Perl_debug_log, "0x%04"UVXf" .. 0x%04"UVXf"\n",
8322                                                  start,         end);
8323         }
8324         else {
8325             PerlIO_printf(Perl_debug_log, "0x%04"UVXf"\n", start);
8326         }
8327     }
8328 }
8329 #endif
8330
8331 #if 0
8332 bool
8333 S__invlistEQ(pTHX_ SV* const a, SV* const b, bool complement_b)
8334 {
8335     /* Return a boolean as to if the two passed in inversion lists are
8336      * identical.  The final argument, if TRUE, says to take the complement of
8337      * the second inversion list before doing the comparison */
8338
8339     UV* array_a = invlist_array(a);
8340     UV* array_b = invlist_array(b);
8341     UV len_a = _invlist_len(a);
8342     UV len_b = _invlist_len(b);
8343
8344     UV i = 0;               /* current index into the arrays */
8345     bool retval = TRUE;     /* Assume are identical until proven otherwise */
8346
8347     PERL_ARGS_ASSERT__INVLISTEQ;
8348
8349     /* If are to compare 'a' with the complement of b, set it
8350      * up so are looking at b's complement. */
8351     if (complement_b) {
8352
8353         /* The complement of nothing is everything, so <a> would have to have
8354          * just one element, starting at zero (ending at infinity) */
8355         if (len_b == 0) {
8356             return (len_a == 1 && array_a[0] == 0);
8357         }
8358         else if (array_b[0] == 0) {
8359
8360             /* Otherwise, to complement, we invert.  Here, the first element is
8361              * 0, just remove it.  To do this, we just pretend the array starts
8362              * one later, and clear the flag as we don't have to do anything
8363              * else later */
8364
8365             array_b++;
8366             len_b--;
8367             complement_b = FALSE;
8368         }
8369         else {
8370
8371             /* But if the first element is not zero, we unshift a 0 before the
8372              * array.  The data structure reserves a space for that 0 (which
8373              * should be a '1' right now), so physical shifting is unneeded,
8374              * but temporarily change that element to 0.  Before exiting the
8375              * routine, we must restore the element to '1' */
8376             array_b--;
8377             len_b++;
8378             array_b[0] = 0;
8379         }
8380     }
8381
8382     /* Make sure that the lengths are the same, as well as the final element
8383      * before looping through the remainder.  (Thus we test the length, final,
8384      * and first elements right off the bat) */
8385     if (len_a != len_b || array_a[len_a-1] != array_b[len_a-1]) {
8386         retval = FALSE;
8387     }
8388     else for (i = 0; i < len_a - 1; i++) {
8389         if (array_a[i] != array_b[i]) {
8390             retval = FALSE;
8391             break;
8392         }
8393     }
8394
8395     if (complement_b) {
8396         array_b[0] = 1;
8397     }
8398     return retval;
8399 }
8400 #endif
8401
8402 #undef HEADER_LENGTH
8403 #undef INVLIST_INITIAL_LENGTH
8404 #undef TO_INTERNAL_SIZE
8405 #undef FROM_INTERNAL_SIZE
8406 #undef INVLIST_LEN_OFFSET
8407 #undef INVLIST_ZERO_OFFSET
8408 #undef INVLIST_ITER_OFFSET
8409 #undef INVLIST_VERSION_ID
8410 #undef INVLIST_PREVIOUS_INDEX_OFFSET
8411
8412 /* End of inversion list object */
8413
8414 STATIC void
8415 S_parse_lparen_question_flags(pTHX_ struct RExC_state_t *pRExC_state)
8416 {
8417     /* This parses the flags that are in either the '(?foo)' or '(?foo:bar)'
8418      * constructs, and updates RExC_flags with them.  On input, RExC_parse
8419      * should point to the first flag; it is updated on output to point to the
8420      * final ')' or ':'.  There needs to be at least one flag, or this will
8421      * abort */
8422
8423     /* for (?g), (?gc), and (?o) warnings; warning
8424        about (?c) will warn about (?g) -- japhy    */
8425
8426 #define WASTED_O  0x01
8427 #define WASTED_G  0x02
8428 #define WASTED_C  0x04
8429 #define WASTED_GC (WASTED_G|WASTED_C)
8430     I32 wastedflags = 0x00;
8431     U32 posflags = 0, negflags = 0;
8432     U32 *flagsp = &posflags;
8433     char has_charset_modifier = '\0';
8434     regex_charset cs;
8435     bool has_use_defaults = FALSE;
8436     const char* const seqstart = RExC_parse - 1; /* Point to the '?' */
8437
8438     PERL_ARGS_ASSERT_PARSE_LPAREN_QUESTION_FLAGS;
8439
8440     /* '^' as an initial flag sets certain defaults */
8441     if (UCHARAT(RExC_parse) == '^') {
8442         RExC_parse++;
8443         has_use_defaults = TRUE;
8444         STD_PMMOD_FLAGS_CLEAR(&RExC_flags);
8445         set_regex_charset(&RExC_flags, (RExC_utf8 || RExC_uni_semantics)
8446                                         ? REGEX_UNICODE_CHARSET
8447                                         : REGEX_DEPENDS_CHARSET);
8448     }
8449
8450     cs = get_regex_charset(RExC_flags);
8451     if (cs == REGEX_DEPENDS_CHARSET
8452         && (RExC_utf8 || RExC_uni_semantics))
8453     {
8454         cs = REGEX_UNICODE_CHARSET;
8455     }
8456
8457     while (*RExC_parse) {
8458         /* && strchr("iogcmsx", *RExC_parse) */
8459         /* (?g), (?gc) and (?o) are useless here
8460            and must be globally applied -- japhy */
8461         switch (*RExC_parse) {
8462
8463             /* Code for the imsx flags */
8464             CASE_STD_PMMOD_FLAGS_PARSE_SET(flagsp);
8465
8466             case LOCALE_PAT_MOD:
8467                 if (has_charset_modifier) {
8468                     goto excess_modifier;
8469                 }
8470                 else if (flagsp == &negflags) {
8471                     goto neg_modifier;
8472                 }
8473                 cs = REGEX_LOCALE_CHARSET;
8474                 has_charset_modifier = LOCALE_PAT_MOD;
8475                 RExC_contains_locale = 1;
8476                 break;
8477             case UNICODE_PAT_MOD:
8478                 if (has_charset_modifier) {
8479                     goto excess_modifier;
8480                 }
8481                 else if (flagsp == &negflags) {
8482                     goto neg_modifier;
8483                 }
8484                 cs = REGEX_UNICODE_CHARSET;
8485                 has_charset_modifier = UNICODE_PAT_MOD;
8486                 break;
8487             case ASCII_RESTRICT_PAT_MOD:
8488                 if (flagsp == &negflags) {
8489                     goto neg_modifier;
8490                 }
8491                 if (has_charset_modifier) {
8492                     if (cs != REGEX_ASCII_RESTRICTED_CHARSET) {
8493                         goto excess_modifier;
8494                     }
8495                     /* Doubled modifier implies more restricted */
8496                     cs = REGEX_ASCII_MORE_RESTRICTED_CHARSET;
8497                 }
8498                 else {
8499                     cs = REGEX_ASCII_RESTRICTED_CHARSET;
8500                 }
8501                 has_charset_modifier = ASCII_RESTRICT_PAT_MOD;
8502                 break;
8503             case DEPENDS_PAT_MOD:
8504                 if (has_use_defaults) {
8505                     goto fail_modifiers;
8506                 }
8507                 else if (flagsp == &negflags) {
8508                     goto neg_modifier;
8509                 }
8510                 else if (has_charset_modifier) {
8511                     goto excess_modifier;
8512                 }
8513
8514                 /* The dual charset means unicode semantics if the
8515                  * pattern (or target, not known until runtime) are
8516                  * utf8, or something in the pattern indicates unicode
8517                  * semantics */
8518                 cs = (RExC_utf8 || RExC_uni_semantics)
8519                      ? REGEX_UNICODE_CHARSET
8520                      : REGEX_DEPENDS_CHARSET;
8521                 has_charset_modifier = DEPENDS_PAT_MOD;
8522                 break;
8523             excess_modifier:
8524                 RExC_parse++;
8525                 if (has_charset_modifier == ASCII_RESTRICT_PAT_MOD) {
8526                     vFAIL2("Regexp modifier \"%c\" may appear a maximum of twice", ASCII_RESTRICT_PAT_MOD);
8527                 }
8528                 else if (has_charset_modifier == *(RExC_parse - 1)) {
8529                     vFAIL2("Regexp modifier \"%c\" may not appear twice", *(RExC_parse - 1));
8530                 }
8531                 else {
8532                     vFAIL3("Regexp modifiers \"%c\" and \"%c\" are mutually exclusive", has_charset_modifier, *(RExC_parse - 1));
8533                 }
8534                 /*NOTREACHED*/
8535             neg_modifier:
8536                 RExC_parse++;
8537                 vFAIL2("Regexp modifier \"%c\" may not appear after the \"-\"", *(RExC_parse - 1));
8538                 /*NOTREACHED*/
8539             case ONCE_PAT_MOD: /* 'o' */
8540             case GLOBAL_PAT_MOD: /* 'g' */
8541                 if (SIZE_ONLY && ckWARN(WARN_REGEXP)) {
8542                     const I32 wflagbit = *RExC_parse == 'o' ? WASTED_O : WASTED_G;
8543                     if (! (wastedflags & wflagbit) ) {
8544                         wastedflags |= wflagbit;
8545                         vWARN5(
8546                             RExC_parse + 1,
8547                             "Useless (%s%c) - %suse /%c modifier",
8548                             flagsp == &negflags ? "?-" : "?",
8549                             *RExC_parse,
8550                             flagsp == &negflags ? "don't " : "",
8551                             *RExC_parse
8552                         );
8553                     }
8554                 }
8555                 break;
8556
8557             case CONTINUE_PAT_MOD: /* 'c' */
8558                 if (SIZE_ONLY && ckWARN(WARN_REGEXP)) {
8559                     if (! (wastedflags & WASTED_C) ) {
8560                         wastedflags |= WASTED_GC;
8561                         vWARN3(
8562                             RExC_parse + 1,
8563                             "Useless (%sc) - %suse /gc modifier",
8564                             flagsp == &negflags ? "?-" : "?",
8565                             flagsp == &negflags ? "don't " : ""
8566                         );
8567                     }
8568                 }
8569                 break;
8570             case KEEPCOPY_PAT_MOD: /* 'p' */
8571                 if (flagsp == &negflags) {
8572                     if (SIZE_ONLY)
8573                         ckWARNreg(RExC_parse + 1,"Useless use of (?-p)");
8574                 } else {
8575                     *flagsp |= RXf_PMf_KEEPCOPY;
8576                 }
8577                 break;
8578             case '-':
8579                 /* A flag is a default iff it is following a minus, so
8580                  * if there is a minus, it means will be trying to
8581                  * re-specify a default which is an error */
8582                 if (has_use_defaults || flagsp == &negflags) {
8583                     goto fail_modifiers;
8584                 }
8585                 flagsp = &negflags;
8586                 wastedflags = 0;  /* reset so (?g-c) warns twice */
8587                 break;
8588             case ':':
8589             case ')':
8590                 RExC_flags |= posflags;
8591                 RExC_flags &= ~negflags;
8592                 set_regex_charset(&RExC_flags, cs);
8593                 return;
8594                 /*NOTREACHED*/
8595             default:
8596             fail_modifiers:
8597                 RExC_parse++;
8598                 vFAIL3("Sequence (%.*s...) not recognized",
8599                        RExC_parse-seqstart, seqstart);
8600                 /*NOTREACHED*/
8601         }
8602
8603         ++RExC_parse;
8604     }
8605 }
8606
8607 /*
8608  - reg - regular expression, i.e. main body or parenthesized thing
8609  *
8610  * Caller must absorb opening parenthesis.
8611  *
8612  * Combining parenthesis handling with the base level of regular expression
8613  * is a trifle forced, but the need to tie the tails of the branches to what
8614  * follows makes it hard to avoid.
8615  */
8616 #define REGTAIL(x,y,z) regtail((x),(y),(z),depth+1)
8617 #ifdef DEBUGGING
8618 #define REGTAIL_STUDY(x,y,z) regtail_study((x),(y),(z),depth+1)
8619 #else
8620 #define REGTAIL_STUDY(x,y,z) regtail((x),(y),(z),depth+1)
8621 #endif
8622
8623 /* Returns NULL, setting *flagp to TRYAGAIN at the end of (?) that only sets
8624    flags. Returns NULL, setting *flagp to RESTART_UTF8 if the sizing scan
8625    needs to be restarted.
8626    Otherwise would only return NULL if regbranch() returns NULL, which
8627    cannot happen.  */
8628 STATIC regnode *
8629 S_reg(pTHX_ RExC_state_t *pRExC_state, I32 paren, I32 *flagp,U32 depth)
8630     /* paren: Parenthesized? 0=top; 1,2=inside '(': changed to letter.
8631      * 2 is like 1, but indicates that nextchar() has been called to advance
8632      * RExC_parse beyond the '('.  Things like '(?' are indivisible tokens, and
8633      * this flag alerts us to the need to check for that */
8634 {
8635     dVAR;
8636     regnode *ret;               /* Will be the head of the group. */
8637     regnode *br;
8638     regnode *lastbr;
8639     regnode *ender = NULL;
8640     I32 parno = 0;
8641     I32 flags;
8642     U32 oregflags = RExC_flags;
8643     bool have_branch = 0;
8644     bool is_open = 0;
8645     I32 freeze_paren = 0;
8646     I32 after_freeze = 0;
8647
8648     char * parse_start = RExC_parse; /* MJD */
8649     char * const oregcomp_parse = RExC_parse;
8650
8651     GET_RE_DEBUG_FLAGS_DECL;
8652
8653     PERL_ARGS_ASSERT_REG;
8654     DEBUG_PARSE("reg ");
8655
8656     *flagp = 0;                         /* Tentatively. */
8657
8658
8659     /* Make an OPEN node, if parenthesized. */
8660     if (paren) {
8661
8662         /* Under /x, space and comments can be gobbled up between the '(' and
8663          * here (if paren ==2).  The forms '(*VERB' and '(?...' disallow such
8664          * intervening space, as the sequence is a token, and a token should be
8665          * indivisible */
8666         bool has_intervening_patws = paren == 2 && *(RExC_parse - 1) != '(';
8667
8668         if ( *RExC_parse == '*') { /* (*VERB:ARG) */
8669             char *start_verb = RExC_parse;
8670             STRLEN verb_len = 0;
8671             char *start_arg = NULL;
8672             unsigned char op = 0;
8673             int argok = 1;
8674             int internal_argval = 0; /* internal_argval is only useful if !argok */
8675
8676             if (has_intervening_patws && SIZE_ONLY) {
8677                 ckWARNregdep(RExC_parse + 1, "In '(*VERB...)', splitting the initial '(*' is deprecated");
8678             }
8679             while ( *RExC_parse && *RExC_parse != ')' ) {
8680                 if ( *RExC_parse == ':' ) {
8681                     start_arg = RExC_parse + 1;
8682                     break;
8683                 }
8684                 RExC_parse++;
8685             }
8686             ++start_verb;
8687             verb_len = RExC_parse - start_verb;
8688             if ( start_arg ) {
8689                 RExC_parse++;
8690                 while ( *RExC_parse && *RExC_parse != ')' ) 
8691                     RExC_parse++;
8692                 if ( *RExC_parse != ')' ) 
8693                     vFAIL("Unterminated verb pattern argument");
8694                 if ( RExC_parse == start_arg )
8695                     start_arg = NULL;
8696             } else {
8697                 if ( *RExC_parse != ')' )
8698                     vFAIL("Unterminated verb pattern");
8699             }
8700             
8701             switch ( *start_verb ) {
8702             case 'A':  /* (*ACCEPT) */
8703                 if ( memEQs(start_verb,verb_len,"ACCEPT") ) {
8704                     op = ACCEPT;
8705                     internal_argval = RExC_nestroot;
8706                 }
8707                 break;
8708             case 'C':  /* (*COMMIT) */
8709                 if ( memEQs(start_verb,verb_len,"COMMIT") )
8710                     op = COMMIT;
8711                 break;
8712             case 'F':  /* (*FAIL) */
8713                 if ( verb_len==1 || memEQs(start_verb,verb_len,"FAIL") ) {
8714                     op = OPFAIL;
8715                     argok = 0;
8716                 }
8717                 break;
8718             case ':':  /* (*:NAME) */
8719             case 'M':  /* (*MARK:NAME) */
8720                 if ( verb_len==0 || memEQs(start_verb,verb_len,"MARK") ) {
8721                     op = MARKPOINT;
8722                     argok = -1;
8723                 }
8724                 break;
8725             case 'P':  /* (*PRUNE) */
8726                 if ( memEQs(start_verb,verb_len,"PRUNE") )
8727                     op = PRUNE;
8728                 break;
8729             case 'S':   /* (*SKIP) */  
8730                 if ( memEQs(start_verb,verb_len,"SKIP") ) 
8731                     op = SKIP;
8732                 break;
8733             case 'T':  /* (*THEN) */
8734                 /* [19:06] <TimToady> :: is then */
8735                 if ( memEQs(start_verb,verb_len,"THEN") ) {
8736                     op = CUTGROUP;
8737                     RExC_seen |= REG_SEEN_CUTGROUP;
8738                 }
8739                 break;
8740             }
8741             if ( ! op ) {
8742                 RExC_parse++;
8743                 vFAIL3("Unknown verb pattern '%.*s'",
8744                     verb_len, start_verb);
8745             }
8746             if ( argok ) {
8747                 if ( start_arg && internal_argval ) {
8748                     vFAIL3("Verb pattern '%.*s' may not have an argument",
8749                         verb_len, start_verb); 
8750                 } else if ( argok < 0 && !start_arg ) {
8751                     vFAIL3("Verb pattern '%.*s' has a mandatory argument",
8752                         verb_len, start_verb);    
8753                 } else {
8754                     ret = reganode(pRExC_state, op, internal_argval);
8755                     if ( ! internal_argval && ! SIZE_ONLY ) {
8756                         if (start_arg) {
8757                             SV *sv = newSVpvn( start_arg, RExC_parse - start_arg);
8758                             ARG(ret) = add_data( pRExC_state, 1, "S" );
8759                             RExC_rxi->data->data[ARG(ret)]=(void*)sv;
8760                             ret->flags = 0;
8761                         } else {
8762                             ret->flags = 1; 
8763                         }
8764                     }               
8765                 }
8766                 if (!internal_argval)
8767                     RExC_seen |= REG_SEEN_VERBARG;
8768             } else if ( start_arg ) {
8769                 vFAIL3("Verb pattern '%.*s' may not have an argument",
8770                         verb_len, start_verb);    
8771             } else {
8772                 ret = reg_node(pRExC_state, op);
8773             }
8774             nextchar(pRExC_state);
8775             return ret;
8776         }
8777         else if (*RExC_parse == '?') { /* (?...) */
8778             bool is_logical = 0;
8779             const char * const seqstart = RExC_parse;
8780             if (has_intervening_patws && SIZE_ONLY) {
8781                 ckWARNregdep(RExC_parse + 1, "In '(?...)', splitting the initial '(?' is deprecated");
8782             }
8783
8784             RExC_parse++;
8785             paren = *RExC_parse++;
8786             ret = NULL;                 /* For look-ahead/behind. */
8787             switch (paren) {
8788
8789             case 'P':   /* (?P...) variants for those used to PCRE/Python */
8790                 paren = *RExC_parse++;
8791                 if ( paren == '<')         /* (?P<...>) named capture */
8792                     goto named_capture;
8793                 else if (paren == '>') {   /* (?P>name) named recursion */
8794                     goto named_recursion;
8795                 }
8796                 else if (paren == '=') {   /* (?P=...)  named backref */
8797                     /* this pretty much dupes the code for \k<NAME> in regatom(), if
8798                        you change this make sure you change that */
8799                     char* name_start = RExC_parse;
8800                     U32 num = 0;
8801                     SV *sv_dat = reg_scan_name(pRExC_state,
8802                         SIZE_ONLY ? REG_RSN_RETURN_NULL : REG_RSN_RETURN_DATA);
8803                     if (RExC_parse == name_start || *RExC_parse != ')')
8804                         vFAIL2("Sequence %.3s... not terminated",parse_start);
8805
8806                     if (!SIZE_ONLY) {
8807                         num = add_data( pRExC_state, 1, "S" );
8808                         RExC_rxi->data->data[num]=(void*)sv_dat;
8809                         SvREFCNT_inc_simple_void(sv_dat);
8810                     }
8811                     RExC_sawback = 1;
8812                     ret = reganode(pRExC_state,
8813                                    ((! FOLD)
8814                                      ? NREF
8815                                      : (ASCII_FOLD_RESTRICTED)
8816                                        ? NREFFA
8817                                        : (AT_LEAST_UNI_SEMANTICS)
8818                                          ? NREFFU
8819                                          : (LOC)
8820                                            ? NREFFL
8821                                            : NREFF),
8822                                     num);
8823                     *flagp |= HASWIDTH;
8824
8825                     Set_Node_Offset(ret, parse_start+1);
8826                     Set_Node_Cur_Length(ret); /* MJD */
8827
8828                     nextchar(pRExC_state);
8829                     return ret;
8830                 }
8831                 RExC_parse++;
8832                 vFAIL3("Sequence (%.*s...) not recognized", RExC_parse-seqstart, seqstart);
8833                 /*NOTREACHED*/
8834             case '<':           /* (?<...) */
8835                 if (*RExC_parse == '!')
8836                     paren = ',';
8837                 else if (*RExC_parse != '=') 
8838               named_capture:
8839                 {               /* (?<...>) */
8840                     char *name_start;
8841                     SV *svname;
8842                     paren= '>';
8843             case '\'':          /* (?'...') */
8844                     name_start= RExC_parse;
8845                     svname = reg_scan_name(pRExC_state,
8846                         SIZE_ONLY ?  /* reverse test from the others */
8847                         REG_RSN_RETURN_NAME : 
8848                         REG_RSN_RETURN_NULL);
8849                     if (RExC_parse == name_start) {
8850                         RExC_parse++;
8851                         vFAIL3("Sequence (%.*s...) not recognized", RExC_parse-seqstart, seqstart);
8852                         /*NOTREACHED*/
8853                     }
8854                     if (*RExC_parse != paren)
8855                         vFAIL2("Sequence (?%c... not terminated",
8856                             paren=='>' ? '<' : paren);
8857                     if (SIZE_ONLY) {
8858                         HE *he_str;
8859                         SV *sv_dat = NULL;
8860                         if (!svname) /* shouldn't happen */
8861                             Perl_croak(aTHX_
8862                                 "panic: reg_scan_name returned NULL");
8863                         if (!RExC_paren_names) {
8864                             RExC_paren_names= newHV();
8865                             sv_2mortal(MUTABLE_SV(RExC_paren_names));
8866 #ifdef DEBUGGING
8867                             RExC_paren_name_list= newAV();
8868                             sv_2mortal(MUTABLE_SV(RExC_paren_name_list));
8869 #endif
8870                         }
8871                         he_str = hv_fetch_ent( RExC_paren_names, svname, 1, 0 );
8872                         if ( he_str )
8873                             sv_dat = HeVAL(he_str);
8874                         if ( ! sv_dat ) {
8875                             /* croak baby croak */
8876                             Perl_croak(aTHX_
8877                                 "panic: paren_name hash element allocation failed");
8878                         } else if ( SvPOK(sv_dat) ) {
8879                             /* (?|...) can mean we have dupes so scan to check
8880                                its already been stored. Maybe a flag indicating
8881                                we are inside such a construct would be useful,
8882                                but the arrays are likely to be quite small, so
8883                                for now we punt -- dmq */
8884                             IV count = SvIV(sv_dat);
8885                             I32 *pv = (I32*)SvPVX(sv_dat);
8886                             IV i;
8887                             for ( i = 0 ; i < count ; i++ ) {
8888                                 if ( pv[i] == RExC_npar ) {
8889                                     count = 0;
8890                                     break;
8891                                 }
8892                             }
8893                             if ( count ) {
8894                                 pv = (I32*)SvGROW(sv_dat, SvCUR(sv_dat) + sizeof(I32)+1);
8895                                 SvCUR_set(sv_dat, SvCUR(sv_dat) + sizeof(I32));
8896                                 pv[count] = RExC_npar;
8897                                 SvIV_set(sv_dat, SvIVX(sv_dat) + 1);
8898                             }
8899                         } else {
8900                             (void)SvUPGRADE(sv_dat,SVt_PVNV);
8901                             sv_setpvn(sv_dat, (char *)&(RExC_npar), sizeof(I32));
8902                             SvIOK_on(sv_dat);
8903                             SvIV_set(sv_dat, 1);
8904                         }
8905 #ifdef DEBUGGING
8906                         /* Yes this does cause a memory leak in debugging Perls */
8907                         if (!av_store(RExC_paren_name_list, RExC_npar, SvREFCNT_inc(svname)))
8908                             SvREFCNT_dec_NN(svname);
8909 #endif
8910
8911                         /*sv_dump(sv_dat);*/
8912                     }
8913                     nextchar(pRExC_state);
8914                     paren = 1;
8915                     goto capturing_parens;
8916                 }
8917                 RExC_seen |= REG_SEEN_LOOKBEHIND;
8918                 RExC_in_lookbehind++;
8919                 RExC_parse++;
8920             case '=':           /* (?=...) */
8921                 RExC_seen_zerolen++;
8922                 break;
8923             case '!':           /* (?!...) */
8924                 RExC_seen_zerolen++;
8925                 if (*RExC_parse == ')') {
8926                     ret=reg_node(pRExC_state, OPFAIL);
8927                     nextchar(pRExC_state);
8928                     return ret;
8929                 }
8930                 break;
8931             case '|':           /* (?|...) */
8932                 /* branch reset, behave like a (?:...) except that
8933                    buffers in alternations share the same numbers */
8934                 paren = ':'; 
8935                 after_freeze = freeze_paren = RExC_npar;
8936                 break;
8937             case ':':           /* (?:...) */
8938             case '>':           /* (?>...) */
8939                 break;
8940             case '$':           /* (?$...) */
8941             case '@':           /* (?@...) */
8942                 vFAIL2("Sequence (?%c...) not implemented", (int)paren);
8943                 break;
8944             case '#':           /* (?#...) */
8945                 /* XXX As soon as we disallow separating the '?' and '*' (by
8946                  * spaces or (?#...) comment), it is believed that this case
8947                  * will be unreachable and can be removed.  See
8948                  * [perl #117327] */
8949                 while (*RExC_parse && *RExC_parse != ')')
8950                     RExC_parse++;
8951                 if (*RExC_parse != ')')
8952                     FAIL("Sequence (?#... not terminated");
8953                 nextchar(pRExC_state);
8954                 *flagp = TRYAGAIN;
8955                 return NULL;
8956             case '0' :           /* (?0) */
8957             case 'R' :           /* (?R) */
8958                 if (*RExC_parse != ')')
8959                     FAIL("Sequence (?R) not terminated");
8960                 ret = reg_node(pRExC_state, GOSTART);
8961                 *flagp |= POSTPONED;
8962                 nextchar(pRExC_state);
8963                 return ret;
8964                 /*notreached*/
8965             { /* named and numeric backreferences */
8966                 I32 num;
8967             case '&':            /* (?&NAME) */
8968                 parse_start = RExC_parse - 1;
8969               named_recursion:
8970                 {
8971                     SV *sv_dat = reg_scan_name(pRExC_state,
8972                         SIZE_ONLY ? REG_RSN_RETURN_NULL : REG_RSN_RETURN_DATA);
8973                      num = sv_dat ? *((I32 *)SvPVX(sv_dat)) : 0;
8974                 }
8975                 goto gen_recurse_regop;
8976                 assert(0); /* NOT REACHED */
8977             case '+':
8978                 if (!(RExC_parse[0] >= '1' && RExC_parse[0] <= '9')) {
8979                     RExC_parse++;
8980                     vFAIL("Illegal pattern");
8981                 }
8982                 goto parse_recursion;
8983                 /* NOT REACHED*/
8984             case '-': /* (?-1) */
8985                 if (!(RExC_parse[0] >= '1' && RExC_parse[0] <= '9')) {
8986                     RExC_parse--; /* rewind to let it be handled later */
8987                     goto parse_flags;
8988                 } 
8989                 /*FALLTHROUGH */
8990             case '1': case '2': case '3': case '4': /* (?1) */
8991             case '5': case '6': case '7': case '8': case '9':
8992                 RExC_parse--;
8993               parse_recursion:
8994                 num = atoi(RExC_parse);
8995                 parse_start = RExC_parse - 1; /* MJD */
8996                 if (*RExC_parse == '-')
8997                     RExC_parse++;
8998                 while (isDIGIT(*RExC_parse))
8999                         RExC_parse++;
9000                 if (*RExC_parse!=')') 
9001                     vFAIL("Expecting close bracket");
9002
9003               gen_recurse_regop:
9004                 if ( paren == '-' ) {
9005                     /*
9006                     Diagram of capture buffer numbering.
9007                     Top line is the normal capture buffer numbers
9008                     Bottom line is the negative indexing as from
9009                     the X (the (?-2))
9010
9011                     +   1 2    3 4 5 X          6 7
9012                        /(a(x)y)(a(b(c(?-2)d)e)f)(g(h))/
9013                     -   5 4    3 2 1 X          x x
9014
9015                     */
9016                     num = RExC_npar + num;
9017                     if (num < 1)  {
9018                         RExC_parse++;
9019                         vFAIL("Reference to nonexistent group");
9020                     }
9021                 } else if ( paren == '+' ) {
9022                     num = RExC_npar + num - 1;
9023                 }
9024
9025                 ret = reganode(pRExC_state, GOSUB, num);
9026                 if (!SIZE_ONLY) {
9027                     if (num > (I32)RExC_rx->nparens) {
9028                         RExC_parse++;
9029                         vFAIL("Reference to nonexistent group");
9030                     }
9031                     ARG2L_SET( ret, RExC_recurse_count++);
9032                     RExC_emit++;
9033                     DEBUG_OPTIMISE_MORE_r(PerlIO_printf(Perl_debug_log,
9034                         "Recurse #%"UVuf" to %"IVdf"\n", (UV)ARG(ret), (IV)ARG2L(ret)));
9035                 } else {
9036                     RExC_size++;
9037                 }
9038                 RExC_seen |= REG_SEEN_RECURSE;
9039                 Set_Node_Length(ret, 1 + regarglen[OP(ret)]); /* MJD */
9040                 Set_Node_Offset(ret, parse_start); /* MJD */
9041
9042                 *flagp |= POSTPONED;
9043                 nextchar(pRExC_state);
9044                 return ret;
9045             } /* named and numeric backreferences */
9046             assert(0); /* NOT REACHED */
9047
9048             case '?':           /* (??...) */
9049                 is_logical = 1;
9050                 if (*RExC_parse != '{') {
9051                     RExC_parse++;
9052                     vFAIL3("Sequence (%.*s...) not recognized", RExC_parse-seqstart, seqstart);
9053                     /*NOTREACHED*/
9054                 }
9055                 *flagp |= POSTPONED;
9056                 paren = *RExC_parse++;
9057                 /* FALL THROUGH */
9058             case '{':           /* (?{...}) */
9059             {
9060                 U32 n = 0;
9061                 struct reg_code_block *cb;
9062
9063                 RExC_seen_zerolen++;
9064
9065                 if (   !pRExC_state->num_code_blocks
9066                     || pRExC_state->code_index >= pRExC_state->num_code_blocks
9067                     || pRExC_state->code_blocks[pRExC_state->code_index].start
9068                         != (STRLEN)((RExC_parse -3 - (is_logical ? 1 : 0))
9069                             - RExC_start)
9070                 ) {
9071                     if (RExC_pm_flags & PMf_USE_RE_EVAL)
9072                         FAIL("panic: Sequence (?{...}): no code block found\n");
9073                     FAIL("Eval-group not allowed at runtime, use re 'eval'");
9074                 }
9075                 /* this is a pre-compiled code block (?{...}) */
9076                 cb = &pRExC_state->code_blocks[pRExC_state->code_index];
9077                 RExC_parse = RExC_start + cb->end;
9078                 if (!SIZE_ONLY) {
9079                     OP *o = cb->block;
9080                     if (cb->src_regex) {
9081                         n = add_data(pRExC_state, 2, "rl");
9082                         RExC_rxi->data->data[n] =
9083                             (void*)SvREFCNT_inc((SV*)cb->src_regex);
9084                         RExC_rxi->data->data[n+1] = (void*)o;
9085                     }
9086                     else {
9087                         n = add_data(pRExC_state, 1,
9088                                (RExC_pm_flags & PMf_HAS_CV) ? "L" : "l");
9089                         RExC_rxi->data->data[n] = (void*)o;
9090                     }
9091                 }
9092                 pRExC_state->code_index++;
9093                 nextchar(pRExC_state);
9094
9095                 if (is_logical) {
9096                     regnode *eval;
9097                     ret = reg_node(pRExC_state, LOGICAL);
9098                     eval = reganode(pRExC_state, EVAL, n);
9099                     if (!SIZE_ONLY) {
9100                         ret->flags = 2;
9101                         /* for later propagation into (??{}) return value */
9102                         eval->flags = (U8) (RExC_flags & RXf_PMf_COMPILETIME);
9103                     }
9104                     REGTAIL(pRExC_state, ret, eval);
9105                     /* deal with the length of this later - MJD */
9106                     return ret;
9107                 }
9108                 ret = reganode(pRExC_state, EVAL, n);
9109                 Set_Node_Length(ret, RExC_parse - parse_start + 1);
9110                 Set_Node_Offset(ret, parse_start);
9111                 return ret;
9112             }
9113             case '(':           /* (?(?{...})...) and (?(?=...)...) */
9114             {
9115                 int is_define= 0;
9116                 if (RExC_parse[0] == '?') {        /* (?(?...)) */
9117                     if (RExC_parse[1] == '=' || RExC_parse[1] == '!'
9118                         || RExC_parse[1] == '<'
9119                         || RExC_parse[1] == '{') { /* Lookahead or eval. */
9120                         I32 flag;
9121                         regnode *tail;
9122
9123                         ret = reg_node(pRExC_state, LOGICAL);
9124                         if (!SIZE_ONLY)
9125                             ret->flags = 1;
9126                         
9127                         tail = reg(pRExC_state, 1, &flag, depth+1);
9128                         if (flag & RESTART_UTF8) {
9129                             *flagp = RESTART_UTF8;
9130                             return NULL;
9131                         }
9132                         REGTAIL(pRExC_state, ret, tail);
9133                         goto insert_if;
9134                     }
9135                 }
9136                 else if ( RExC_parse[0] == '<'     /* (?(<NAME>)...) */
9137                          || RExC_parse[0] == '\'' ) /* (?('NAME')...) */
9138                 {
9139                     char ch = RExC_parse[0] == '<' ? '>' : '\'';
9140                     char *name_start= RExC_parse++;
9141                     U32 num = 0;
9142                     SV *sv_dat=reg_scan_name(pRExC_state,
9143                         SIZE_ONLY ? REG_RSN_RETURN_NULL : REG_RSN_RETURN_DATA);
9144                     if (RExC_parse == name_start || *RExC_parse != ch)
9145                         vFAIL2("Sequence (?(%c... not terminated",
9146                             (ch == '>' ? '<' : ch));
9147                     RExC_parse++;
9148                     if (!SIZE_ONLY) {
9149                         num = add_data( pRExC_state, 1, "S" );
9150                         RExC_rxi->data->data[num]=(void*)sv_dat;
9151                         SvREFCNT_inc_simple_void(sv_dat);
9152                     }
9153                     ret = reganode(pRExC_state,NGROUPP,num);
9154                     goto insert_if_check_paren;
9155                 }
9156                 else if (RExC_parse[0] == 'D' &&
9157                          RExC_parse[1] == 'E' &&
9158                          RExC_parse[2] == 'F' &&
9159                          RExC_parse[3] == 'I' &&
9160                          RExC_parse[4] == 'N' &&
9161                          RExC_parse[5] == 'E')
9162                 {
9163                     ret = reganode(pRExC_state,DEFINEP,0);
9164                     RExC_parse +=6 ;
9165                     is_define = 1;
9166                     goto insert_if_check_paren;
9167                 }
9168                 else if (RExC_parse[0] == 'R') {
9169                     RExC_parse++;
9170                     parno = 0;
9171                     if (RExC_parse[0] >= '1' && RExC_parse[0] <= '9' ) {
9172                         parno = atoi(RExC_parse++);
9173                         while (isDIGIT(*RExC_parse))
9174                             RExC_parse++;
9175                     } else if (RExC_parse[0] == '&') {
9176                         SV *sv_dat;
9177                         RExC_parse++;
9178                         sv_dat = reg_scan_name(pRExC_state,
9179                             SIZE_ONLY ? REG_RSN_RETURN_NULL : REG_RSN_RETURN_DATA);
9180                         parno = sv_dat ? *((I32 *)SvPVX(sv_dat)) : 0;
9181                     }
9182                     ret = reganode(pRExC_state,INSUBP,parno); 
9183                     goto insert_if_check_paren;
9184                 }
9185                 else if (RExC_parse[0] >= '1' && RExC_parse[0] <= '9' ) {
9186                     /* (?(1)...) */
9187                     char c;
9188                     parno = atoi(RExC_parse++);
9189
9190                     while (isDIGIT(*RExC_parse))
9191                         RExC_parse++;
9192                     ret = reganode(pRExC_state, GROUPP, parno);
9193
9194                  insert_if_check_paren:
9195                     if ((c = *nextchar(pRExC_state)) != ')')
9196                         vFAIL("Switch condition not recognized");
9197                   insert_if:
9198                     REGTAIL(pRExC_state, ret, reganode(pRExC_state, IFTHEN, 0));
9199                     br = regbranch(pRExC_state, &flags, 1,depth+1);
9200                     if (br == NULL) {
9201                         if (flags & RESTART_UTF8) {
9202                             *flagp = RESTART_UTF8;
9203                             return NULL;
9204                         }
9205                         FAIL2("panic: regbranch returned NULL, flags=%#"UVxf"",
9206                               (UV) flags);
9207                     } else
9208                         REGTAIL(pRExC_state, br, reganode(pRExC_state, LONGJMP, 0));
9209                     c = *nextchar(pRExC_state);
9210                     if (flags&HASWIDTH)
9211                         *flagp |= HASWIDTH;
9212                     if (c == '|') {
9213                         if (is_define) 
9214                             vFAIL("(?(DEFINE)....) does not allow branches");
9215                         lastbr = reganode(pRExC_state, IFTHEN, 0); /* Fake one for optimizer. */
9216                         if (!regbranch(pRExC_state, &flags, 1,depth+1)) {
9217                             if (flags & RESTART_UTF8) {
9218                                 *flagp = RESTART_UTF8;
9219                                 return NULL;
9220                             }
9221                             FAIL2("panic: regbranch returned NULL, flags=%#"UVxf"",
9222                                   (UV) flags);
9223                         }
9224                         REGTAIL(pRExC_state, ret, lastbr);
9225                         if (flags&HASWIDTH)
9226                             *flagp |= HASWIDTH;
9227                         c = *nextchar(pRExC_state);
9228                     }
9229                     else
9230                         lastbr = NULL;
9231                     if (c != ')')
9232                         vFAIL("Switch (?(condition)... contains too many branches");
9233                     ender = reg_node(pRExC_state, TAIL);
9234                     REGTAIL(pRExC_state, br, ender);
9235                     if (lastbr) {
9236                         REGTAIL(pRExC_state, lastbr, ender);
9237                         REGTAIL(pRExC_state, NEXTOPER(NEXTOPER(lastbr)), ender);
9238                     }
9239                     else
9240                         REGTAIL(pRExC_state, ret, ender);
9241                     RExC_size++; /* XXX WHY do we need this?!!
9242                                     For large programs it seems to be required
9243                                     but I can't figure out why. -- dmq*/
9244                     return ret;
9245                 }
9246                 else {
9247                     vFAIL2("Unknown switch condition (?(%.2s", RExC_parse);
9248                 }
9249             }
9250             case '[':           /* (?[ ... ]) */
9251                 return handle_regex_sets(pRExC_state, NULL, flagp, depth,
9252                                          oregcomp_parse);
9253             case 0:
9254                 RExC_parse--; /* for vFAIL to print correctly */
9255                 vFAIL("Sequence (? incomplete");
9256                 break;
9257             default: /* e.g., (?i) */
9258                 --RExC_parse;
9259               parse_flags:
9260                 parse_lparen_question_flags(pRExC_state);
9261                 if (UCHARAT(RExC_parse) != ':') {
9262                     nextchar(pRExC_state);
9263                     *flagp = TRYAGAIN;
9264                     return NULL;
9265                 }
9266                 paren = ':';
9267                 nextchar(pRExC_state);
9268                 ret = NULL;
9269                 goto parse_rest;
9270             } /* end switch */
9271         }
9272         else {                  /* (...) */
9273           capturing_parens:
9274             parno = RExC_npar;
9275             RExC_npar++;
9276             
9277             ret = reganode(pRExC_state, OPEN, parno);
9278             if (!SIZE_ONLY ){
9279                 if (!RExC_nestroot) 
9280                     RExC_nestroot = parno;
9281                 if (RExC_seen & REG_SEEN_RECURSE
9282                     && !RExC_open_parens[parno-1])
9283                 {
9284                     DEBUG_OPTIMISE_MORE_r(PerlIO_printf(Perl_debug_log,
9285                         "Setting open paren #%"IVdf" to %d\n", 
9286                         (IV)parno, REG_NODE_NUM(ret)));
9287                     RExC_open_parens[parno-1]= ret;
9288                 }
9289             }
9290             Set_Node_Length(ret, 1); /* MJD */
9291             Set_Node_Offset(ret, RExC_parse); /* MJD */
9292             is_open = 1;
9293         }
9294     }
9295     else                        /* ! paren */
9296         ret = NULL;
9297    
9298    parse_rest:
9299     /* Pick up the branches, linking them together. */
9300     parse_start = RExC_parse;   /* MJD */
9301     br = regbranch(pRExC_state, &flags, 1,depth+1);
9302
9303     /*     branch_len = (paren != 0); */
9304
9305     if (br == NULL) {
9306         if (flags & RESTART_UTF8) {
9307             *flagp = RESTART_UTF8;
9308             return NULL;
9309         }
9310         FAIL2("panic: regbranch returned NULL, flags=%#"UVxf"", (UV) flags);
9311     }
9312     if (*RExC_parse == '|') {
9313         if (!SIZE_ONLY && RExC_extralen) {
9314             reginsert(pRExC_state, BRANCHJ, br, depth+1);
9315         }
9316         else {                  /* MJD */
9317             reginsert(pRExC_state, BRANCH, br, depth+1);
9318             Set_Node_Length(br, paren != 0);
9319             Set_Node_Offset_To_R(br-RExC_emit_start, parse_start-RExC_start);
9320         }
9321         have_branch = 1;
9322         if (SIZE_ONLY)
9323             RExC_extralen += 1;         /* For BRANCHJ-BRANCH. */
9324     }
9325     else if (paren == ':') {
9326         *flagp |= flags&SIMPLE;
9327     }
9328     if (is_open) {                              /* Starts with OPEN. */
9329         REGTAIL(pRExC_state, ret, br);          /* OPEN -> first. */
9330     }
9331     else if (paren != '?')              /* Not Conditional */
9332         ret = br;
9333     *flagp |= flags & (SPSTART | HASWIDTH | POSTPONED);
9334     lastbr = br;
9335     while (*RExC_parse == '|') {
9336         if (!SIZE_ONLY && RExC_extralen) {
9337             ender = reganode(pRExC_state, LONGJMP,0);
9338             REGTAIL(pRExC_state, NEXTOPER(NEXTOPER(lastbr)), ender); /* Append to the previous. */
9339         }
9340         if (SIZE_ONLY)
9341             RExC_extralen += 2;         /* Account for LONGJMP. */
9342         nextchar(pRExC_state);
9343         if (freeze_paren) {
9344             if (RExC_npar > after_freeze)
9345                 after_freeze = RExC_npar;
9346             RExC_npar = freeze_paren;       
9347         }
9348         br = regbranch(pRExC_state, &flags, 0, depth+1);
9349
9350         if (br == NULL) {
9351             if (flags & RESTART_UTF8) {
9352                 *flagp = RESTART_UTF8;
9353                 return NULL;
9354             }
9355             FAIL2("panic: regbranch returned NULL, flags=%#"UVxf"", (UV) flags);
9356         }
9357         REGTAIL(pRExC_state, lastbr, br);               /* BRANCH -> BRANCH. */
9358         lastbr = br;
9359         *flagp |= flags & (SPSTART | HASWIDTH | POSTPONED);
9360     }
9361
9362     if (have_branch || paren != ':') {
9363         /* Make a closing node, and hook it on the end. */
9364         switch (paren) {
9365         case ':':
9366             ender = reg_node(pRExC_state, TAIL);
9367             break;
9368         case 1: case 2:
9369             ender = reganode(pRExC_state, CLOSE, parno);
9370             if (!SIZE_ONLY && RExC_seen & REG_SEEN_RECURSE) {
9371                 DEBUG_OPTIMISE_MORE_r(PerlIO_printf(Perl_debug_log,
9372                         "Setting close paren #%"IVdf" to %d\n", 
9373                         (IV)parno, REG_NODE_NUM(ender)));
9374                 RExC_close_parens[parno-1]= ender;
9375                 if (RExC_nestroot == parno) 
9376                     RExC_nestroot = 0;
9377             }       
9378             Set_Node_Offset(ender,RExC_parse+1); /* MJD */
9379             Set_Node_Length(ender,1); /* MJD */
9380             break;
9381         case '<':
9382         case ',':
9383         case '=':
9384         case '!':
9385             *flagp &= ~HASWIDTH;
9386             /* FALL THROUGH */
9387         case '>':
9388             ender = reg_node(pRExC_state, SUCCEED);
9389             break;
9390         case 0:
9391             ender = reg_node(pRExC_state, END);
9392             if (!SIZE_ONLY) {
9393                 assert(!RExC_opend); /* there can only be one! */
9394                 RExC_opend = ender;
9395             }
9396             break;
9397         }
9398         DEBUG_PARSE_r(if (!SIZE_ONLY) {
9399             SV * const mysv_val1=sv_newmortal();
9400             SV * const mysv_val2=sv_newmortal();
9401             DEBUG_PARSE_MSG("lsbr");
9402             regprop(RExC_rx, mysv_val1, lastbr);
9403             regprop(RExC_rx, mysv_val2, ender);
9404             PerlIO_printf(Perl_debug_log, "~ tying lastbr %s (%"IVdf") to ender %s (%"IVdf") offset %"IVdf"\n",
9405                           SvPV_nolen_const(mysv_val1),
9406                           (IV)REG_NODE_NUM(lastbr),
9407                           SvPV_nolen_const(mysv_val2),
9408                           (IV)REG_NODE_NUM(ender),
9409                           (IV)(ender - lastbr)
9410             );
9411         });
9412         REGTAIL(pRExC_state, lastbr, ender);
9413
9414         if (have_branch && !SIZE_ONLY) {
9415             char is_nothing= 1;
9416             if (depth==1)
9417                 RExC_seen |= REG_TOP_LEVEL_BRANCHES;
9418
9419             /* Hook the tails of the branches to the closing node. */
9420             for (br = ret; br; br = regnext(br)) {
9421                 const U8 op = PL_regkind[OP(br)];
9422                 if (op == BRANCH) {
9423                     REGTAIL_STUDY(pRExC_state, NEXTOPER(br), ender);
9424                     if (OP(NEXTOPER(br)) != NOTHING || regnext(NEXTOPER(br)) != ender)
9425                         is_nothing= 0;
9426                 }
9427                 else if (op == BRANCHJ) {
9428                     REGTAIL_STUDY(pRExC_state, NEXTOPER(NEXTOPER(br)), ender);
9429                     /* for now we always disable this optimisation * /
9430                     if (OP(NEXTOPER(NEXTOPER(br))) != NOTHING || regnext(NEXTOPER(NEXTOPER(br))) != ender)
9431                     */
9432                         is_nothing= 0;
9433                 }
9434             }
9435             if (is_nothing) {
9436                 br= PL_regkind[OP(ret)] != BRANCH ? regnext(ret) : ret;
9437                 DEBUG_PARSE_r(if (!SIZE_ONLY) {
9438                     SV * const mysv_val1=sv_newmortal();
9439                     SV * const mysv_val2=sv_newmortal();
9440                     DEBUG_PARSE_MSG("NADA");
9441                     regprop(RExC_rx, mysv_val1, ret);
9442                     regprop(RExC_rx, mysv_val2, ender);
9443                     PerlIO_printf(Perl_debug_log, "~ converting ret %s (%"IVdf") to ender %s (%"IVdf") offset %"IVdf"\n",
9444                                   SvPV_nolen_const(mysv_val1),
9445                                   (IV)REG_NODE_NUM(ret),
9446                                   SvPV_nolen_const(mysv_val2),
9447                                   (IV)REG_NODE_NUM(ender),
9448                                   (IV)(ender - ret)
9449                     );
9450                 });
9451                 OP(br)= NOTHING;
9452                 if (OP(ender) == TAIL) {
9453                     NEXT_OFF(br)= 0;
9454                     RExC_emit= br + 1;
9455                 } else {
9456                     regnode *opt;
9457                     for ( opt= br + 1; opt < ender ; opt++ )
9458                         OP(opt)= OPTIMIZED;
9459                     NEXT_OFF(br)= ender - br;
9460                 }
9461             }
9462         }
9463     }
9464
9465     {
9466         const char *p;
9467         static const char parens[] = "=!<,>";
9468
9469         if (paren && (p = strchr(parens, paren))) {
9470             U8 node = ((p - parens) % 2) ? UNLESSM : IFMATCH;
9471             int flag = (p - parens) > 1;
9472
9473             if (paren == '>')
9474                 node = SUSPEND, flag = 0;
9475             reginsert(pRExC_state, node,ret, depth+1);
9476             Set_Node_Cur_Length(ret);
9477             Set_Node_Offset(ret, parse_start + 1);
9478             ret->flags = flag;
9479             REGTAIL_STUDY(pRExC_state, ret, reg_node(pRExC_state, TAIL));
9480         }
9481     }
9482
9483     /* Check for proper termination. */
9484     if (paren) {
9485         /* restore original flags, but keep (?p) */
9486         RExC_flags = oregflags | (RExC_flags & RXf_PMf_KEEPCOPY);
9487         if (RExC_parse >= RExC_end || *nextchar(pRExC_state) != ')') {
9488             RExC_parse = oregcomp_parse;
9489             vFAIL("Unmatched (");
9490         }
9491     }
9492     else if (!paren && RExC_parse < RExC_end) {
9493         if (*RExC_parse == ')') {
9494             RExC_parse++;
9495             vFAIL("Unmatched )");
9496         }
9497         else
9498             FAIL("Junk on end of regexp");      /* "Can't happen". */
9499         assert(0); /* NOTREACHED */
9500     }
9501
9502     if (RExC_in_lookbehind) {
9503         RExC_in_lookbehind--;
9504     }
9505     if (after_freeze > RExC_npar)
9506         RExC_npar = after_freeze;
9507     return(ret);
9508 }
9509
9510 /*
9511  - regbranch - one alternative of an | operator
9512  *
9513  * Implements the concatenation operator.
9514  *
9515  * Returns NULL, setting *flagp to RESTART_UTF8 if the sizing scan needs to be
9516  * restarted.
9517  */
9518 STATIC regnode *
9519 S_regbranch(pTHX_ RExC_state_t *pRExC_state, I32 *flagp, I32 first, U32 depth)
9520 {
9521     dVAR;
9522     regnode *ret;
9523     regnode *chain = NULL;
9524     regnode *latest;
9525     I32 flags = 0, c = 0;
9526     GET_RE_DEBUG_FLAGS_DECL;
9527
9528     PERL_ARGS_ASSERT_REGBRANCH;
9529
9530     DEBUG_PARSE("brnc");
9531
9532     if (first)
9533         ret = NULL;
9534     else {
9535         if (!SIZE_ONLY && RExC_extralen)
9536             ret = reganode(pRExC_state, BRANCHJ,0);
9537         else {
9538             ret = reg_node(pRExC_state, BRANCH);
9539             Set_Node_Length(ret, 1);
9540         }
9541     }
9542
9543     if (!first && SIZE_ONLY)
9544         RExC_extralen += 1;                     /* BRANCHJ */
9545
9546     *flagp = WORST;                     /* Tentatively. */
9547
9548     RExC_parse--;
9549     nextchar(pRExC_state);
9550     while (RExC_parse < RExC_end && *RExC_parse != '|' && *RExC_parse != ')') {
9551         flags &= ~TRYAGAIN;
9552         latest = regpiece(pRExC_state, &flags,depth+1);
9553         if (latest == NULL) {
9554             if (flags & TRYAGAIN)
9555                 continue;
9556             if (flags & RESTART_UTF8) {
9557                 *flagp = RESTART_UTF8;
9558                 return NULL;
9559             }
9560             FAIL2("panic: regpiece returned NULL, flags=%#"UVxf"", (UV) flags);
9561         }
9562         else if (ret == NULL)
9563             ret = latest;
9564         *flagp |= flags&(HASWIDTH|POSTPONED);
9565         if (chain == NULL)      /* First piece. */
9566             *flagp |= flags&SPSTART;
9567         else {
9568             RExC_naughty++;
9569             REGTAIL(pRExC_state, chain, latest);
9570         }
9571         chain = latest;
9572         c++;
9573     }
9574     if (chain == NULL) {        /* Loop ran zero times. */
9575         chain = reg_node(pRExC_state, NOTHING);
9576         if (ret == NULL)
9577             ret = chain;
9578     }
9579     if (c == 1) {
9580         *flagp |= flags&SIMPLE;
9581     }
9582
9583     return ret;
9584 }
9585
9586 /*
9587  - regpiece - something followed by possible [*+?]
9588  *
9589  * Note that the branching code sequences used for ? and the general cases
9590  * of * and + are somewhat optimized:  they use the same NOTHING node as
9591  * both the endmarker for their branch list and the body of the last branch.
9592  * It might seem that this node could be dispensed with entirely, but the
9593  * endmarker role is not redundant.
9594  *
9595  * Returns NULL, setting *flagp to TRYAGAIN if regatom() returns NULL with
9596  * TRYAGAIN.
9597  * Returns NULL, setting *flagp to RESTART_UTF8 if the sizing scan needs to be
9598  * restarted.
9599  */
9600 STATIC regnode *
9601 S_regpiece(pTHX_ RExC_state_t *pRExC_state, I32 *flagp, U32 depth)
9602 {
9603     dVAR;
9604     regnode *ret;
9605     char op;
9606     char *next;
9607     I32 flags;
9608     const char * const origparse = RExC_parse;
9609     I32 min;
9610     I32 max = REG_INFTY;
9611 #ifdef RE_TRACK_PATTERN_OFFSETS
9612     char *parse_start;
9613 #endif
9614     const char *maxpos = NULL;
9615
9616     /* Save the original in case we change the emitted regop to a FAIL. */
9617     regnode * const orig_emit = RExC_emit;
9618
9619     GET_RE_DEBUG_FLAGS_DECL;
9620
9621     PERL_ARGS_ASSERT_REGPIECE;
9622
9623     DEBUG_PARSE("piec");
9624
9625     ret = regatom(pRExC_state, &flags,depth+1);
9626     if (ret == NULL) {
9627         if (flags & (TRYAGAIN|RESTART_UTF8))
9628             *flagp |= flags & (TRYAGAIN|RESTART_UTF8);
9629         else
9630             FAIL2("panic: regatom returned NULL, flags=%#"UVxf"", (UV) flags);
9631         return(NULL);
9632     }
9633
9634     op = *RExC_parse;
9635
9636     if (op == '{' && regcurly(RExC_parse, FALSE)) {
9637         maxpos = NULL;
9638 #ifdef RE_TRACK_PATTERN_OFFSETS
9639         parse_start = RExC_parse; /* MJD */
9640 #endif
9641         next = RExC_parse + 1;
9642         while (isDIGIT(*next) || *next == ',') {
9643             if (*next == ',') {
9644                 if (maxpos)
9645                     break;
9646                 else
9647                     maxpos = next;
9648             }
9649             next++;
9650         }
9651         if (*next == '}') {             /* got one */
9652             if (!maxpos)
9653                 maxpos = next;
9654             RExC_parse++;
9655             min = atoi(RExC_parse);
9656             if (*maxpos == ',')
9657                 maxpos++;
9658             else
9659                 maxpos = RExC_parse;
9660             max = atoi(maxpos);
9661             if (!max && *maxpos != '0')
9662                 max = REG_INFTY;                /* meaning "infinity" */
9663             else if (max >= REG_INFTY)
9664                 vFAIL2("Quantifier in {,} bigger than %d", REG_INFTY - 1);
9665             RExC_parse = next;
9666             nextchar(pRExC_state);
9667             if (max < min) {    /* If can't match, warn and optimize to fail
9668                                    unconditionally */
9669                 if (SIZE_ONLY) {
9670                     ckWARNreg(RExC_parse, "Quantifier {n,m} with n > m can't match");
9671
9672                     /* We can't back off the size because we have to reserve
9673                      * enough space for all the things we are about to throw
9674                      * away, but we can shrink it by the ammount we are about
9675                      * to re-use here */
9676                     RExC_size = PREVOPER(RExC_size) - regarglen[(U8)OPFAIL];
9677                 }
9678                 else {
9679                     RExC_emit = orig_emit;
9680                 }
9681                 ret = reg_node(pRExC_state, OPFAIL);
9682                 return ret;
9683             }
9684             else if (max == 0) {    /* replace {0} with a nothing node */
9685                 if (SIZE_ONLY) {
9686                     RExC_size = PREVOPER(RExC_size) - regarglen[(U8)NOTHING];
9687                 }
9688                 else {
9689                     RExC_emit = orig_emit;
9690                 }
9691                 ret = reg_node(pRExC_state, NOTHING);
9692                 return ret;
9693             }
9694
9695         do_curly:
9696             if ((flags&SIMPLE)) {
9697                 RExC_naughty += 2 + RExC_naughty / 2;
9698                 reginsert(pRExC_state, CURLY, ret, depth+1);
9699                 Set_Node_Offset(ret, parse_start+1); /* MJD */
9700                 Set_Node_Cur_Length(ret);
9701             }
9702             else {
9703                 regnode * const w = reg_node(pRExC_state, WHILEM);
9704
9705                 w->flags = 0;
9706                 REGTAIL(pRExC_state, ret, w);
9707                 if (!SIZE_ONLY && RExC_extralen) {
9708                     reginsert(pRExC_state, LONGJMP,ret, depth+1);
9709                     reginsert(pRExC_state, NOTHING,ret, depth+1);
9710                     NEXT_OFF(ret) = 3;  /* Go over LONGJMP. */
9711                 }
9712                 reginsert(pRExC_state, CURLYX,ret, depth+1);
9713                                 /* MJD hk */
9714                 Set_Node_Offset(ret, parse_start+1);
9715                 Set_Node_Length(ret,
9716                                 op == '{' ? (RExC_parse - parse_start) : 1);
9717
9718                 if (!SIZE_ONLY && RExC_extralen)
9719                     NEXT_OFF(ret) = 3;  /* Go over NOTHING to LONGJMP. */
9720                 REGTAIL(pRExC_state, ret, reg_node(pRExC_state, NOTHING));
9721                 if (SIZE_ONLY)
9722                     RExC_whilem_seen++, RExC_extralen += 3;
9723                 RExC_naughty += 4 + RExC_naughty;       /* compound interest */
9724             }
9725             ret->flags = 0;
9726
9727             if (min > 0)
9728                 *flagp = WORST;
9729             if (max > 0)
9730                 *flagp |= HASWIDTH;
9731             if (!SIZE_ONLY) {
9732                 ARG1_SET(ret, (U16)min);
9733                 ARG2_SET(ret, (U16)max);
9734             }
9735
9736             goto nest_check;
9737         }
9738     }
9739
9740     if (!ISMULT1(op)) {
9741         *flagp = flags;
9742         return(ret);
9743     }
9744
9745 #if 0                           /* Now runtime fix should be reliable. */
9746
9747     /* if this is reinstated, don't forget to put this back into perldiag:
9748
9749             =item Regexp *+ operand could be empty at {#} in regex m/%s/
9750
9751            (F) The part of the regexp subject to either the * or + quantifier
9752            could match an empty string. The {#} shows in the regular
9753            expression about where the problem was discovered.
9754
9755     */
9756
9757     if (!(flags&HASWIDTH) && op != '?')
9758       vFAIL("Regexp *+ operand could be empty");
9759 #endif
9760
9761 #ifdef RE_TRACK_PATTERN_OFFSETS
9762     parse_start = RExC_parse;
9763 #endif
9764     nextchar(pRExC_state);
9765
9766     *flagp = (op != '+') ? (WORST|SPSTART|HASWIDTH) : (WORST|HASWIDTH);
9767
9768     if (op == '*' && (flags&SIMPLE)) {
9769         reginsert(pRExC_state, STAR, ret, depth+1);
9770         ret->flags = 0;
9771         RExC_naughty += 4;
9772     }
9773     else if (op == '*') {
9774         min = 0;
9775         goto do_curly;
9776     }
9777     else if (op == '+' && (flags&SIMPLE)) {
9778         reginsert(pRExC_state, PLUS, ret, depth+1);
9779         ret->flags = 0;
9780         RExC_naughty += 3;
9781     }
9782     else if (op == '+') {
9783         min = 1;
9784         goto do_curly;
9785     }
9786     else if (op == '?') {
9787         min = 0; max = 1;
9788         goto do_curly;
9789     }
9790   nest_check:
9791     if (!SIZE_ONLY && !(flags&(HASWIDTH|POSTPONED)) && max > REG_INFTY/3) {
9792         SAVEFREESV(RExC_rx_sv); /* in case of fatal warnings */
9793         ckWARN3reg(RExC_parse,
9794                    "%.*s matches null string many times",
9795                    (int)(RExC_parse >= origparse ? RExC_parse - origparse : 0),
9796                    origparse);
9797         (void)ReREFCNT_inc(RExC_rx_sv);
9798     }
9799
9800     if (RExC_parse < RExC_end && *RExC_parse == '?') {
9801         nextchar(pRExC_state);
9802         reginsert(pRExC_state, MINMOD, ret, depth+1);
9803         REGTAIL(pRExC_state, ret, ret + NODE_STEP_REGNODE);
9804     }
9805 #ifndef REG_ALLOW_MINMOD_SUSPEND
9806     else
9807 #endif
9808     if (RExC_parse < RExC_end && *RExC_parse == '+') {
9809         regnode *ender;
9810         nextchar(pRExC_state);
9811         ender = reg_node(pRExC_state, SUCCEED);
9812         REGTAIL(pRExC_state, ret, ender);
9813         reginsert(pRExC_state, SUSPEND, ret, depth+1);
9814         ret->flags = 0;
9815         ender = reg_node(pRExC_state, TAIL);
9816         REGTAIL(pRExC_state, ret, ender);
9817         /*ret= ender;*/
9818     }
9819
9820     if (RExC_parse < RExC_end && ISMULT2(RExC_parse)) {
9821         RExC_parse++;
9822         vFAIL("Nested quantifiers");
9823     }
9824
9825     return(ret);
9826 }
9827
9828 STATIC bool
9829 S_grok_bslash_N(pTHX_ RExC_state_t *pRExC_state, regnode** node_p, UV *valuep, I32 *flagp, U32 depth, bool in_char_class,
9830         const bool strict   /* Apply stricter parsing rules? */
9831     )
9832 {
9833    
9834  /* This is expected to be called by a parser routine that has recognized '\N'
9835    and needs to handle the rest. RExC_parse is expected to point at the first
9836    char following the N at the time of the call.  On successful return,
9837    RExC_parse has been updated to point to just after the sequence identified
9838    by this routine, and <*flagp> has been updated.
9839
9840    The \N may be inside (indicated by the boolean <in_char_class>) or outside a
9841    character class.
9842
9843    \N may begin either a named sequence, or if outside a character class, mean
9844    to match a non-newline.  For non single-quoted regexes, the tokenizer has
9845    attempted to decide which, and in the case of a named sequence, converted it
9846    into one of the forms: \N{} (if the sequence is null), or \N{U+c1.c2...},
9847    where c1... are the characters in the sequence.  For single-quoted regexes,
9848    the tokenizer passes the \N sequence through unchanged; this code will not
9849    attempt to determine this nor expand those, instead raising a syntax error.
9850    The net effect is that if the beginning of the passed-in pattern isn't '{U+'
9851    or there is no '}', it signals that this \N occurrence means to match a
9852    non-newline.
9853
9854    Only the \N{U+...} form should occur in a character class, for the same
9855    reason that '.' inside a character class means to just match a period: it
9856    just doesn't make sense.
9857
9858    The function raises an error (via vFAIL), and doesn't return for various
9859    syntax errors.  Otherwise it returns TRUE and sets <node_p> or <valuep> on
9860    success; it returns FALSE otherwise. Returns FALSE, setting *flagp to
9861    RESTART_UTF8 if the sizing scan needs to be restarted. Such a restart is
9862    only possible if node_p is non-NULL.
9863
9864
9865    If <valuep> is non-null, it means the caller can accept an input sequence
9866    consisting of a just a single code point; <*valuep> is set to that value
9867    if the input is such.
9868
9869    If <node_p> is non-null it signifies that the caller can accept any other
9870    legal sequence (i.e., one that isn't just a single code point).  <*node_p>
9871    is set as follows:
9872     1) \N means not-a-NL: points to a newly created REG_ANY node;
9873     2) \N{}:              points to a new NOTHING node;
9874     3) otherwise:         points to a new EXACT node containing the resolved
9875                           string.
9876    Note that FALSE is returned for single code point sequences if <valuep> is
9877    null.
9878  */
9879
9880     char * endbrace;    /* '}' following the name */
9881     char* p;
9882     char *endchar;      /* Points to '.' or '}' ending cur char in the input
9883                            stream */
9884     bool has_multiple_chars; /* true if the input stream contains a sequence of
9885                                 more than one character */
9886
9887     GET_RE_DEBUG_FLAGS_DECL;
9888  
9889     PERL_ARGS_ASSERT_GROK_BSLASH_N;
9890
9891     GET_RE_DEBUG_FLAGS;
9892
9893     assert(cBOOL(node_p) ^ cBOOL(valuep));  /* Exactly one should be set */
9894
9895     /* The [^\n] meaning of \N ignores spaces and comments under the /x
9896      * modifier.  The other meaning does not */
9897     p = (RExC_flags & RXf_PMf_EXTENDED)
9898         ? regwhite( pRExC_state, RExC_parse )
9899         : RExC_parse;
9900
9901     /* Disambiguate between \N meaning a named character versus \N meaning
9902      * [^\n].  The former is assumed when it can't be the latter. */
9903     if (*p != '{' || regcurly(p, FALSE)) {
9904         RExC_parse = p;
9905         if (! node_p) {
9906             /* no bare \N in a charclass */
9907             if (in_char_class) {
9908                 vFAIL("\\N in a character class must be a named character: \\N{...}");
9909             }
9910             return FALSE;
9911         }
9912         nextchar(pRExC_state);
9913         *node_p = reg_node(pRExC_state, REG_ANY);
9914         *flagp |= HASWIDTH|SIMPLE;
9915         RExC_naughty++;
9916         RExC_parse--;
9917         Set_Node_Length(*node_p, 1); /* MJD */
9918         return TRUE;
9919     }
9920
9921     /* Here, we have decided it should be a named character or sequence */
9922
9923     /* The test above made sure that the next real character is a '{', but
9924      * under the /x modifier, it could be separated by space (or a comment and
9925      * \n) and this is not allowed (for consistency with \x{...} and the
9926      * tokenizer handling of \N{NAME}). */
9927     if (*RExC_parse != '{') {
9928         vFAIL("Missing braces on \\N{}");
9929     }
9930
9931     RExC_parse++;       /* Skip past the '{' */
9932
9933     if (! (endbrace = strchr(RExC_parse, '}')) /* no trailing brace */
9934         || ! (endbrace == RExC_parse            /* nothing between the {} */
9935               || (endbrace - RExC_parse >= 2    /* U+ (bad hex is checked below */
9936                   && strnEQ(RExC_parse, "U+", 2)))) /* for a better error msg) */
9937     {
9938         if (endbrace) RExC_parse = endbrace;    /* position msg's '<--HERE' */
9939         vFAIL("\\N{NAME} must be resolved by the lexer");
9940     }
9941
9942     if (endbrace == RExC_parse) {   /* empty: \N{} */
9943         bool ret = TRUE;
9944         if (node_p) {
9945             *node_p = reg_node(pRExC_state,NOTHING);
9946         }
9947         else if (in_char_class) {
9948             if (SIZE_ONLY && in_char_class) {
9949                 if (strict) {
9950                     RExC_parse++;   /* Position after the "}" */
9951                     vFAIL("Zero length \\N{}");
9952                 }
9953                 else {
9954                     ckWARNreg(RExC_parse,
9955                               "Ignoring zero length \\N{} in character class");
9956                 }
9957             }
9958             ret = FALSE;
9959         }
9960         else {
9961             return FALSE;
9962         }
9963         nextchar(pRExC_state);
9964         return ret;
9965     }
9966
9967     RExC_uni_semantics = 1; /* Unicode named chars imply Unicode semantics */
9968     RExC_parse += 2;    /* Skip past the 'U+' */
9969
9970     endchar = RExC_parse + strcspn(RExC_parse, ".}");
9971
9972     /* Code points are separated by dots.  If none, there is only one code
9973      * point, and is terminated by the brace */
9974     has_multiple_chars = (endchar < endbrace);
9975
9976     if (valuep && (! has_multiple_chars || in_char_class)) {
9977         /* We only pay attention to the first char of
9978         multichar strings being returned in char classes. I kinda wonder
9979         if this makes sense as it does change the behaviour
9980         from earlier versions, OTOH that behaviour was broken
9981         as well. XXX Solution is to recharacterize as
9982         [rest-of-class]|multi1|multi2... */
9983
9984         STRLEN length_of_hex = (STRLEN)(endchar - RExC_parse);
9985         I32 grok_hex_flags = PERL_SCAN_ALLOW_UNDERSCORES
9986             | PERL_SCAN_DISALLOW_PREFIX
9987             | (SIZE_ONLY ? PERL_SCAN_SILENT_ILLDIGIT : 0);
9988
9989         *valuep = grok_hex(RExC_parse, &length_of_hex, &grok_hex_flags, NULL);
9990
9991         /* The tokenizer should have guaranteed validity, but it's possible to
9992          * bypass it by using single quoting, so check */
9993         if (length_of_hex == 0
9994             || length_of_hex != (STRLEN)(endchar - RExC_parse) )
9995         {
9996             RExC_parse += length_of_hex;        /* Includes all the valid */
9997             RExC_parse += (RExC_orig_utf8)      /* point to after 1st invalid */
9998                             ? UTF8SKIP(RExC_parse)
9999                             : 1;
10000             /* Guard against malformed utf8 */
10001             if (RExC_parse >= endchar) {
10002                 RExC_parse = endchar;
10003             }
10004             vFAIL("Invalid hexadecimal number in \\N{U+...}");
10005         }
10006
10007         if (in_char_class && has_multiple_chars) {
10008             if (strict) {
10009                 RExC_parse = endbrace;
10010                 vFAIL("\\N{} in character class restricted to one character");
10011             }
10012             else {
10013                 ckWARNreg(endchar, "Using just the first character returned by \\N{} in character class");
10014             }
10015         }
10016
10017         RExC_parse = endbrace + 1;
10018     }
10019     else if (! node_p || ! has_multiple_chars) {
10020
10021         /* Here, the input is legal, but not according to the caller's
10022          * options.  We fail without advancing the parse, so that the
10023          * caller can try again */
10024         RExC_parse = p;
10025         return FALSE;
10026     }
10027     else {
10028
10029         /* What is done here is to convert this to a sub-pattern of the form
10030          * (?:\x{char1}\x{char2}...)
10031          * and then call reg recursively.  That way, it retains its atomicness,
10032          * while not having to worry about special handling that some code
10033          * points may have.  toke.c has converted the original Unicode values
10034          * to native, so that we can just pass on the hex values unchanged.  We
10035          * do have to set a flag to keep recoding from happening in the
10036          * recursion */
10037
10038         SV * substitute_parse = newSVpvn_flags("?:", 2, SVf_UTF8|SVs_TEMP);
10039         STRLEN len;
10040         char *orig_end = RExC_end;
10041         I32 flags;
10042
10043         while (RExC_parse < endbrace) {
10044
10045             /* Convert to notation the rest of the code understands */
10046             sv_catpv(substitute_parse, "\\x{");
10047             sv_catpvn(substitute_parse, RExC_parse, endchar - RExC_parse);
10048             sv_catpv(substitute_parse, "}");
10049
10050             /* Point to the beginning of the next character in the sequence. */
10051             RExC_parse = endchar + 1;
10052             endchar = RExC_parse + strcspn(RExC_parse, ".}");
10053         }
10054         sv_catpv(substitute_parse, ")");
10055
10056         RExC_parse = SvPV(substitute_parse, len);
10057
10058         /* Don't allow empty number */
10059         if (len < 8) {
10060             vFAIL("Invalid hexadecimal number in \\N{U+...}");
10061         }
10062         RExC_end = RExC_parse + len;
10063
10064         /* The values are Unicode, and therefore not subject to recoding */
10065         RExC_override_recoding = 1;
10066
10067         if (!(*node_p = reg(pRExC_state, 1, &flags, depth+1))) {
10068             if (flags & RESTART_UTF8) {
10069                 *flagp = RESTART_UTF8;
10070                 return FALSE;
10071             }
10072             FAIL2("panic: reg returned NULL to grok_bslash_N, flags=%#"UVxf"",
10073                   (UV) flags);
10074         } 
10075         *flagp |= flags&(HASWIDTH|SPSTART|SIMPLE|POSTPONED);
10076
10077         RExC_parse = endbrace;
10078         RExC_end = orig_end;
10079         RExC_override_recoding = 0;
10080
10081         nextchar(pRExC_state);
10082     }
10083
10084     return TRUE;
10085 }
10086
10087
10088 /*
10089  * reg_recode
10090  *
10091  * It returns the code point in utf8 for the value in *encp.
10092  *    value: a code value in the source encoding
10093  *    encp:  a pointer to an Encode object
10094  *
10095  * If the result from Encode is not a single character,
10096  * it returns U+FFFD (Replacement character) and sets *encp to NULL.
10097  */
10098 STATIC UV
10099 S_reg_recode(pTHX_ const char value, SV **encp)
10100 {
10101     STRLEN numlen = 1;
10102     SV * const sv = newSVpvn_flags(&value, numlen, SVs_TEMP);
10103     const char * const s = *encp ? sv_recode_to_utf8(sv, *encp) : SvPVX(sv);
10104     const STRLEN newlen = SvCUR(sv);
10105     UV uv = UNICODE_REPLACEMENT;
10106
10107     PERL_ARGS_ASSERT_REG_RECODE;
10108
10109     if (newlen)
10110         uv = SvUTF8(sv)
10111              ? utf8n_to_uvchr((U8*)s, newlen, &numlen, UTF8_ALLOW_DEFAULT)
10112              : *(U8*)s;
10113
10114     if (!newlen || numlen != newlen) {
10115         uv = UNICODE_REPLACEMENT;
10116         *encp = NULL;
10117     }
10118     return uv;
10119 }
10120
10121 PERL_STATIC_INLINE U8
10122 S_compute_EXACTish(pTHX_ RExC_state_t *pRExC_state)
10123 {
10124     U8 op;
10125
10126     PERL_ARGS_ASSERT_COMPUTE_EXACTISH;
10127
10128     if (! FOLD) {
10129         return EXACT;
10130     }
10131
10132     op = get_regex_charset(RExC_flags);
10133     if (op >= REGEX_ASCII_RESTRICTED_CHARSET) {
10134         op--; /* /a is same as /u, and map /aa's offset to what /a's would have
10135                  been, so there is no hole */
10136     }
10137
10138     return op + EXACTF;
10139 }
10140
10141 PERL_STATIC_INLINE void
10142 S_alloc_maybe_populate_EXACT(pTHX_ RExC_state_t *pRExC_state, regnode *node, I32* flagp, STRLEN len, UV code_point)
10143 {
10144     /* This knows the details about sizing an EXACTish node, setting flags for
10145      * it (by setting <*flagp>, and potentially populating it with a single
10146      * character.
10147      *
10148      * If <len> (the length in bytes) is non-zero, this function assumes that
10149      * the node has already been populated, and just does the sizing.  In this
10150      * case <code_point> should be the final code point that has already been
10151      * placed into the node.  This value will be ignored except that under some
10152      * circumstances <*flagp> is set based on it.
10153      *
10154      * If <len> is zero, the function assumes that the node is to contain only
10155      * the single character given by <code_point> and calculates what <len>
10156      * should be.  In pass 1, it sizes the node appropriately.  In pass 2, it
10157      * additionally will populate the node's STRING with <code_point>, if <len>
10158      * is 0.  In both cases <*flagp> is appropriately set
10159      *
10160      * It knows that under FOLD, the Latin Sharp S and UTF characters above
10161      * 255, must be folded (the former only when the rules indicate it can
10162      * match 'ss') */
10163
10164     bool len_passed_in = cBOOL(len != 0);
10165     U8 character[UTF8_MAXBYTES_CASE+1];
10166
10167     PERL_ARGS_ASSERT_ALLOC_MAYBE_POPULATE_EXACT;
10168
10169     if (! len_passed_in) {
10170         if (UTF) {
10171             if (FOLD && (! LOC || code_point > 255)) {
10172                 _to_uni_fold_flags(NATIVE_TO_UNI(code_point),
10173                                    character,
10174                                    &len,
10175                                    FOLD_FLAGS_FULL | ((LOC)
10176                                                      ? FOLD_FLAGS_LOCALE
10177                                                      : (ASCII_FOLD_RESTRICTED)
10178                                                        ? FOLD_FLAGS_NOMIX_ASCII
10179                                                        : 0));
10180             }
10181             else {
10182                 uvchr_to_utf8( character, code_point);
10183                 len = UTF8SKIP(character);
10184             }
10185         }
10186         else if (! FOLD
10187                  || code_point != LATIN_SMALL_LETTER_SHARP_S
10188                  || ASCII_FOLD_RESTRICTED
10189                  || ! AT_LEAST_UNI_SEMANTICS)
10190         {
10191             *character = (U8) code_point;
10192             len = 1;
10193         }
10194         else {
10195             *character = 's';
10196             *(character + 1) = 's';
10197             len = 2;
10198         }
10199     }
10200
10201     if (SIZE_ONLY) {
10202         RExC_size += STR_SZ(len);
10203     }
10204     else {
10205         RExC_emit += STR_SZ(len);
10206         STR_LEN(node) = len;
10207         if (! len_passed_in) {
10208             Copy((char *) character, STRING(node), len, char);
10209         }
10210     }
10211
10212     *flagp |= HASWIDTH;
10213
10214     /* A single character node is SIMPLE, except for the special-cased SHARP S
10215      * under /di. */
10216     if ((len == 1 || (UTF && len == UNISKIP(code_point)))
10217         && (code_point != LATIN_SMALL_LETTER_SHARP_S
10218             || ! FOLD || ! DEPENDS_SEMANTICS))
10219     {
10220         *flagp |= SIMPLE;
10221     }
10222 }
10223
10224 /*
10225  - regatom - the lowest level
10226
10227    Try to identify anything special at the start of the pattern. If there
10228    is, then handle it as required. This may involve generating a single regop,
10229    such as for an assertion; or it may involve recursing, such as to
10230    handle a () structure.
10231
10232    If the string doesn't start with something special then we gobble up
10233    as much literal text as we can.
10234
10235    Once we have been able to handle whatever type of thing started the
10236    sequence, we return.
10237
10238    Note: we have to be careful with escapes, as they can be both literal
10239    and special, and in the case of \10 and friends, context determines which.
10240
10241    A summary of the code structure is:
10242
10243    switch (first_byte) {
10244         cases for each special:
10245             handle this special;
10246             break;
10247         case '\\':
10248             switch (2nd byte) {
10249                 cases for each unambiguous special:
10250                     handle this special;
10251                     break;
10252                 cases for each ambigous special/literal:
10253                     disambiguate;
10254                     if (special)  handle here
10255                     else goto defchar;
10256                 default: // unambiguously literal:
10257                     goto defchar;
10258             }
10259         default:  // is a literal char
10260             // FALL THROUGH
10261         defchar:
10262             create EXACTish node for literal;
10263             while (more input and node isn't full) {
10264                 switch (input_byte) {
10265                    cases for each special;
10266                        make sure parse pointer is set so that the next call to
10267                            regatom will see this special first
10268                        goto loopdone; // EXACTish node terminated by prev. char
10269                    default:
10270                        append char to EXACTISH node;
10271                 }
10272                 get next input byte;
10273             }
10274         loopdone:
10275    }
10276    return the generated node;
10277
10278    Specifically there are two separate switches for handling
10279    escape sequences, with the one for handling literal escapes requiring
10280    a dummy entry for all of the special escapes that are actually handled
10281    by the other.
10282
10283    Returns NULL, setting *flagp to TRYAGAIN if reg() returns NULL with
10284    TRYAGAIN.  
10285    Returns NULL, setting *flagp to RESTART_UTF8 if the sizing scan needs to be
10286    restarted.
10287    Otherwise does not return NULL.
10288 */
10289
10290 STATIC regnode *
10291 S_regatom(pTHX_ RExC_state_t *pRExC_state, I32 *flagp, U32 depth)
10292 {
10293     dVAR;
10294     regnode *ret = NULL;
10295     I32 flags = 0;
10296     char *parse_start = RExC_parse;
10297     U8 op;
10298     int invert = 0;
10299
10300     GET_RE_DEBUG_FLAGS_DECL;
10301
10302     *flagp = WORST;             /* Tentatively. */
10303
10304     DEBUG_PARSE("atom");
10305
10306     PERL_ARGS_ASSERT_REGATOM;
10307
10308 tryagain:
10309     switch ((U8)*RExC_parse) {
10310     case '^':
10311         RExC_seen_zerolen++;
10312         nextchar(pRExC_state);
10313         if (RExC_flags & RXf_PMf_MULTILINE)
10314             ret = reg_node(pRExC_state, MBOL);
10315         else if (RExC_flags & RXf_PMf_SINGLELINE)
10316             ret = reg_node(pRExC_state, SBOL);
10317         else
10318             ret = reg_node(pRExC_state, BOL);
10319         Set_Node_Length(ret, 1); /* MJD */
10320         break;
10321     case '$':
10322         nextchar(pRExC_state);
10323         if (*RExC_parse)
10324             RExC_seen_zerolen++;
10325         if (RExC_flags & RXf_PMf_MULTILINE)
10326             ret = reg_node(pRExC_state, MEOL);
10327         else if (RExC_flags & RXf_PMf_SINGLELINE)
10328             ret = reg_node(pRExC_state, SEOL);
10329         else
10330             ret = reg_node(pRExC_state, EOL);
10331         Set_Node_Length(ret, 1); /* MJD */
10332         break;
10333     case '.':
10334         nextchar(pRExC_state);
10335         if (RExC_flags & RXf_PMf_SINGLELINE)
10336             ret = reg_node(pRExC_state, SANY);
10337         else
10338             ret = reg_node(pRExC_state, REG_ANY);
10339         *flagp |= HASWIDTH|SIMPLE;
10340         RExC_naughty++;
10341         Set_Node_Length(ret, 1); /* MJD */
10342         break;
10343     case '[':
10344     {
10345         char * const oregcomp_parse = ++RExC_parse;
10346         ret = regclass(pRExC_state, flagp,depth+1,
10347                        FALSE, /* means parse the whole char class */
10348                        TRUE, /* allow multi-char folds */
10349                        FALSE, /* don't silence non-portable warnings. */
10350                        NULL);
10351         if (*RExC_parse != ']') {
10352             RExC_parse = oregcomp_parse;
10353             vFAIL("Unmatched [");
10354         }
10355         if (ret == NULL) {
10356             if (*flagp & RESTART_UTF8)
10357                 return NULL;
10358             FAIL2("panic: regclass returned NULL to regatom, flags=%#"UVxf"",
10359                   (UV) *flagp);
10360         }
10361         nextchar(pRExC_state);
10362         Set_Node_Length(ret, RExC_parse - oregcomp_parse + 1); /* MJD */
10363         break;
10364     }
10365     case '(':
10366         nextchar(pRExC_state);
10367         ret = reg(pRExC_state, 2, &flags,depth+1);
10368         if (ret == NULL) {
10369                 if (flags & TRYAGAIN) {
10370                     if (RExC_parse == RExC_end) {
10371                          /* Make parent create an empty node if needed. */
10372                         *flagp |= TRYAGAIN;
10373                         return(NULL);
10374                     }
10375                     goto tryagain;
10376                 }
10377                 if (flags & RESTART_UTF8) {
10378                     *flagp = RESTART_UTF8;
10379                     return NULL;
10380                 }
10381                 FAIL2("panic: reg returned NULL to regatom, flags=%#"UVxf"", (UV) flags);
10382         }
10383         *flagp |= flags&(HASWIDTH|SPSTART|SIMPLE|POSTPONED);
10384         break;
10385     case '|':
10386     case ')':
10387         if (flags & TRYAGAIN) {
10388             *flagp |= TRYAGAIN;
10389             return NULL;
10390         }
10391         vFAIL("Internal urp");
10392                                 /* Supposed to be caught earlier. */
10393         break;
10394     case '{':
10395         if (!regcurly(RExC_parse, FALSE)) {
10396             RExC_parse++;
10397             goto defchar;
10398         }
10399         /* FALL THROUGH */
10400     case '?':
10401     case '+':
10402     case '*':
10403         RExC_parse++;
10404         vFAIL("Quantifier follows nothing");
10405         break;
10406     case '\\':
10407         /* Special Escapes
10408
10409            This switch handles escape sequences that resolve to some kind
10410            of special regop and not to literal text. Escape sequnces that
10411            resolve to literal text are handled below in the switch marked
10412            "Literal Escapes".
10413
10414            Every entry in this switch *must* have a corresponding entry
10415            in the literal escape switch. However, the opposite is not
10416            required, as the default for this switch is to jump to the
10417            literal text handling code.
10418         */
10419         switch ((U8)*++RExC_parse) {
10420             U8 arg;
10421         /* Special Escapes */
10422         case 'A':
10423             RExC_seen_zerolen++;
10424             ret = reg_node(pRExC_state, SBOL);
10425             *flagp |= SIMPLE;
10426             goto finish_meta_pat;
10427         case 'G':
10428             ret = reg_node(pRExC_state, GPOS);
10429             RExC_seen |= REG_SEEN_GPOS;
10430             *flagp |= SIMPLE;
10431             goto finish_meta_pat;
10432         case 'K':
10433             RExC_seen_zerolen++;
10434             ret = reg_node(pRExC_state, KEEPS);
10435             *flagp |= SIMPLE;
10436             /* XXX:dmq : disabling in-place substitution seems to
10437              * be necessary here to avoid cases of memory corruption, as
10438              * with: C<$_="x" x 80; s/x\K/y/> -- rgs
10439              */
10440             RExC_seen |= REG_SEEN_LOOKBEHIND;
10441             goto finish_meta_pat;
10442         case 'Z':
10443             ret = reg_node(pRExC_state, SEOL);
10444             *flagp |= SIMPLE;
10445             RExC_seen_zerolen++;                /* Do not optimize RE away */
10446             goto finish_meta_pat;
10447         case 'z':
10448             ret = reg_node(pRExC_state, EOS);
10449             *flagp |= SIMPLE;
10450             RExC_seen_zerolen++;                /* Do not optimize RE away */
10451             goto finish_meta_pat;
10452         case 'C':
10453             ret = reg_node(pRExC_state, CANY);
10454             RExC_seen |= REG_SEEN_CANY;
10455             *flagp |= HASWIDTH|SIMPLE;
10456             goto finish_meta_pat;
10457         case 'X':
10458             ret = reg_node(pRExC_state, CLUMP);
10459             *flagp |= HASWIDTH;
10460             goto finish_meta_pat;
10461
10462         case 'W':
10463             invert = 1;
10464             /* FALLTHROUGH */
10465         case 'w':
10466             arg = ANYOF_WORDCHAR;
10467             goto join_posix;
10468
10469         case 'b':
10470             RExC_seen_zerolen++;
10471             RExC_seen |= REG_SEEN_LOOKBEHIND;
10472             op = BOUND + get_regex_charset(RExC_flags);
10473             if (op > BOUNDA) {  /* /aa is same as /a */
10474                 op = BOUNDA;
10475             }
10476             ret = reg_node(pRExC_state, op);
10477             FLAGS(ret) = get_regex_charset(RExC_flags);
10478             *flagp |= SIMPLE;
10479             if (! SIZE_ONLY && (U8) *(RExC_parse + 1) == '{') {
10480                 ckWARNdep(RExC_parse, "\"\\b{\" is deprecated; use \"\\b\\{\" or \"\\b[{]\" instead");
10481             }
10482             goto finish_meta_pat;
10483         case 'B':
10484             RExC_seen_zerolen++;
10485             RExC_seen |= REG_SEEN_LOOKBEHIND;
10486             op = NBOUND + get_regex_charset(RExC_flags);
10487             if (op > NBOUNDA) { /* /aa is same as /a */
10488                 op = NBOUNDA;
10489             }
10490             ret = reg_node(pRExC_state, op);
10491             FLAGS(ret) = get_regex_charset(RExC_flags);
10492             *flagp |= SIMPLE;
10493             if (! SIZE_ONLY && (U8) *(RExC_parse + 1) == '{') {
10494                 ckWARNdep(RExC_parse, "\"\\B{\" is deprecated; use \"\\B\\{\" or \"\\B[{]\" instead");
10495             }
10496             goto finish_meta_pat;
10497
10498         case 'D':
10499             invert = 1;
10500             /* FALLTHROUGH */
10501         case 'd':
10502             arg = ANYOF_DIGIT;
10503             goto join_posix;
10504
10505         case 'R':
10506             ret = reg_node(pRExC_state, LNBREAK);
10507             *flagp |= HASWIDTH|SIMPLE;
10508             goto finish_meta_pat;
10509
10510         case 'H':
10511             invert = 1;
10512             /* FALLTHROUGH */
10513         case 'h':
10514             arg = ANYOF_BLANK;
10515             op = POSIXU;
10516             goto join_posix_op_known;
10517
10518         case 'V':
10519             invert = 1;
10520             /* FALLTHROUGH */
10521         case 'v':
10522             arg = ANYOF_VERTWS;
10523             op = POSIXU;
10524             goto join_posix_op_known;
10525
10526         case 'S':
10527             invert = 1;
10528             /* FALLTHROUGH */
10529         case 's':
10530             arg = ANYOF_SPACE;
10531
10532         join_posix:
10533
10534             op = POSIXD + get_regex_charset(RExC_flags);
10535             if (op > POSIXA) {  /* /aa is same as /a */
10536                 op = POSIXA;
10537             }
10538
10539         join_posix_op_known:
10540
10541             if (invert) {
10542                 op += NPOSIXD - POSIXD;
10543             }
10544
10545             ret = reg_node(pRExC_state, op);
10546             if (! SIZE_ONLY) {
10547                 FLAGS(ret) = namedclass_to_classnum(arg);
10548             }
10549
10550             *flagp |= HASWIDTH|SIMPLE;
10551             /* FALL THROUGH */
10552
10553          finish_meta_pat:           
10554             nextchar(pRExC_state);
10555             Set_Node_Length(ret, 2); /* MJD */
10556             break;          
10557         case 'p':
10558         case 'P':
10559             {
10560 #ifdef DEBUGGING
10561                 char* parse_start = RExC_parse - 2;
10562 #endif
10563
10564                 RExC_parse--;
10565
10566                 ret = regclass(pRExC_state, flagp,depth+1,
10567                                TRUE, /* means just parse this element */
10568                                FALSE, /* don't allow multi-char folds */
10569                                FALSE, /* don't silence non-portable warnings.
10570                                          It would be a bug if these returned
10571                                          non-portables */
10572                                NULL);
10573                 /* regclass() can only return RESTART_UTF8 if multi-char folds
10574                    are allowed.  */
10575                 if (!ret)
10576                     FAIL2("panic: regclass returned NULL to regatom, flags=%#"UVxf"",
10577                           (UV) *flagp);
10578
10579                 RExC_parse--;
10580
10581                 Set_Node_Offset(ret, parse_start + 2);
10582                 Set_Node_Cur_Length(ret);
10583                 nextchar(pRExC_state);
10584             }
10585             break;
10586         case 'N': 
10587             /* Handle \N and \N{NAME} with multiple code points here and not
10588              * below because it can be multicharacter. join_exact() will join
10589              * them up later on.  Also this makes sure that things like
10590              * /\N{BLAH}+/ and \N{BLAH} being multi char Just Happen. dmq.
10591              * The options to the grok function call causes it to fail if the
10592              * sequence is just a single code point.  We then go treat it as
10593              * just another character in the current EXACT node, and hence it
10594              * gets uniform treatment with all the other characters.  The
10595              * special treatment for quantifiers is not needed for such single
10596              * character sequences */
10597             ++RExC_parse;
10598             if (! grok_bslash_N(pRExC_state, &ret, NULL, flagp, depth, FALSE,
10599                                 FALSE /* not strict */ )) {
10600                 if (*flagp & RESTART_UTF8)
10601                     return NULL;
10602                 RExC_parse--;
10603                 goto defchar;
10604             }
10605             break;
10606         case 'k':    /* Handle \k<NAME> and \k'NAME' */
10607         parse_named_seq:
10608         {   
10609             char ch= RExC_parse[1];         
10610             if (ch != '<' && ch != '\'' && ch != '{') {
10611                 RExC_parse++;
10612                 vFAIL2("Sequence %.2s... not terminated",parse_start);
10613             } else {
10614                 /* this pretty much dupes the code for (?P=...) in reg(), if
10615                    you change this make sure you change that */
10616                 char* name_start = (RExC_parse += 2);
10617                 U32 num = 0;
10618                 SV *sv_dat = reg_scan_name(pRExC_state,
10619                     SIZE_ONLY ? REG_RSN_RETURN_NULL : REG_RSN_RETURN_DATA);
10620                 ch= (ch == '<') ? '>' : (ch == '{') ? '}' : '\'';
10621                 if (RExC_parse == name_start || *RExC_parse != ch)
10622                     vFAIL2("Sequence %.3s... not terminated",parse_start);
10623
10624                 if (!SIZE_ONLY) {
10625                     num = add_data( pRExC_state, 1, "S" );
10626                     RExC_rxi->data->data[num]=(void*)sv_dat;
10627                     SvREFCNT_inc_simple_void(sv_dat);
10628                 }
10629
10630                 RExC_sawback = 1;
10631                 ret = reganode(pRExC_state,
10632                                ((! FOLD)
10633                                  ? NREF
10634                                  : (ASCII_FOLD_RESTRICTED)
10635                                    ? NREFFA
10636                                    : (AT_LEAST_UNI_SEMANTICS)
10637                                      ? NREFFU
10638                                      : (LOC)
10639                                        ? NREFFL
10640                                        : NREFF),
10641                                 num);
10642                 *flagp |= HASWIDTH;
10643
10644                 /* override incorrect value set in reganode MJD */
10645                 Set_Node_Offset(ret, parse_start+1);
10646                 Set_Node_Cur_Length(ret); /* MJD */
10647                 nextchar(pRExC_state);
10648
10649             }
10650             break;
10651         }
10652         case 'g': 
10653         case '1': case '2': case '3': case '4':
10654         case '5': case '6': case '7': case '8': case '9':
10655             {
10656                 I32 num;
10657                 bool isg = *RExC_parse == 'g';
10658                 bool isrel = 0; 
10659                 bool hasbrace = 0;
10660                 if (isg) {
10661                     RExC_parse++;
10662                     if (*RExC_parse == '{') {
10663                         RExC_parse++;
10664                         hasbrace = 1;
10665                     }
10666                     if (*RExC_parse == '-') {
10667                         RExC_parse++;
10668                         isrel = 1;
10669                     }
10670                     if (hasbrace && !isDIGIT(*RExC_parse)) {
10671                         if (isrel) RExC_parse--;
10672                         RExC_parse -= 2;                            
10673                         goto parse_named_seq;
10674                 }   }
10675                 num = atoi(RExC_parse);
10676                 if (isg && num == 0) {
10677                     if (*RExC_parse == '0') {
10678                         vFAIL("Reference to invalid group 0");
10679                     }
10680                     else {
10681                         vFAIL("Unterminated \\g... pattern");
10682                     }
10683                 }
10684                 if (isrel) {
10685                     num = RExC_npar - num;
10686                     if (num < 1)
10687                         vFAIL("Reference to nonexistent or unclosed group");
10688                 }
10689                 if (!isg && num > 9 && num >= RExC_npar)
10690                     /* Probably a character specified in octal, e.g. \35 */
10691                     goto defchar;
10692                 else {
10693                     char * const parse_start = RExC_parse - 1; /* MJD */
10694                     while (isDIGIT(*RExC_parse))
10695                         RExC_parse++;
10696                     if (hasbrace) {
10697                         if (*RExC_parse != '}') 
10698                             vFAIL("Unterminated \\g{...} pattern");
10699                         RExC_parse++;
10700                     }    
10701                     if (!SIZE_ONLY) {
10702                         if (num > (I32)RExC_rx->nparens)
10703                             vFAIL("Reference to nonexistent group");
10704                     }
10705                     RExC_sawback = 1;
10706                     ret = reganode(pRExC_state,
10707                                    ((! FOLD)
10708                                      ? REF
10709                                      : (ASCII_FOLD_RESTRICTED)
10710                                        ? REFFA
10711                                        : (AT_LEAST_UNI_SEMANTICS)
10712                                          ? REFFU
10713                                          : (LOC)
10714                                            ? REFFL
10715                                            : REFF),
10716                                     num);
10717                     *flagp |= HASWIDTH;
10718
10719                     /* override incorrect value set in reganode MJD */
10720                     Set_Node_Offset(ret, parse_start+1);
10721                     Set_Node_Cur_Length(ret); /* MJD */
10722                     RExC_parse--;
10723                     nextchar(pRExC_state);
10724                 }
10725             }
10726             break;
10727         case '\0':
10728             if (RExC_parse >= RExC_end)
10729                 FAIL("Trailing \\");
10730             /* FALL THROUGH */
10731         default:
10732             /* Do not generate "unrecognized" warnings here, we fall
10733                back into the quick-grab loop below */
10734             parse_start--;
10735             goto defchar;
10736         }
10737         break;
10738
10739     case '#':
10740         if (RExC_flags & RXf_PMf_EXTENDED) {
10741             if ( reg_skipcomment( pRExC_state ) )
10742                 goto tryagain;
10743         }
10744         /* FALL THROUGH */
10745
10746     default:
10747
10748             parse_start = RExC_parse - 1;
10749
10750             RExC_parse++;
10751
10752         defchar: {
10753             STRLEN len = 0;
10754             UV ender;
10755             char *p;
10756             char *s;
10757 #define MAX_NODE_STRING_SIZE 127
10758             char foldbuf[MAX_NODE_STRING_SIZE+UTF8_MAXBYTES_CASE];
10759             char *s0;
10760             U8 upper_parse = MAX_NODE_STRING_SIZE;
10761             STRLEN foldlen;
10762             U8 node_type;
10763             bool next_is_quantifier;
10764             char * oldp = NULL;
10765
10766             /* If a folding node contains only code points that don't
10767              * participate in folds, it can be changed into an EXACT node,
10768              * which allows the optimizer more things to look for */
10769             bool maybe_exact;
10770
10771             ender = 0;
10772             node_type = compute_EXACTish(pRExC_state);
10773             ret = reg_node(pRExC_state, node_type);
10774
10775             /* In pass1, folded, we use a temporary buffer instead of the
10776              * actual node, as the node doesn't exist yet */
10777             s = (SIZE_ONLY && FOLD) ? foldbuf : STRING(ret);
10778
10779             s0 = s;
10780
10781         reparse:
10782
10783             /* We do the EXACTFish to EXACT node only if folding, and not if in
10784              * locale, as whether a character folds or not isn't known until
10785              * runtime */
10786             maybe_exact = FOLD && ! LOC;
10787
10788             /* XXX The node can hold up to 255 bytes, yet this only goes to
10789              * 127.  I (khw) do not know why.  Keeping it somewhat less than
10790              * 255 allows us to not have to worry about overflow due to
10791              * converting to utf8 and fold expansion, but that value is
10792              * 255-UTF8_MAXBYTES_CASE.  join_exact() may join adjacent nodes
10793              * split up by this limit into a single one using the real max of
10794              * 255.  Even at 127, this breaks under rare circumstances.  If
10795              * folding, we do not want to split a node at a character that is a
10796              * non-final in a multi-char fold, as an input string could just
10797              * happen to want to match across the node boundary.  The join
10798              * would solve that problem if the join actually happens.  But a
10799              * series of more than two nodes in a row each of 127 would cause
10800              * the first join to succeed to get to 254, but then there wouldn't
10801              * be room for the next one, which could at be one of those split
10802              * multi-char folds.  I don't know of any fool-proof solution.  One
10803              * could back off to end with only a code point that isn't such a
10804              * non-final, but it is possible for there not to be any in the
10805              * entire node. */
10806             for (p = RExC_parse - 1;
10807                  len < upper_parse && p < RExC_end;
10808                  len++)
10809             {
10810                 oldp = p;
10811
10812                 if (RExC_flags & RXf_PMf_EXTENDED)
10813                     p = regwhite( pRExC_state, p );
10814                 switch ((U8)*p) {
10815                 case '^':
10816                 case '$':
10817                 case '.':
10818                 case '[':
10819                 case '(':
10820                 case ')':
10821                 case '|':
10822                     goto loopdone;
10823                 case '\\':
10824                     /* Literal Escapes Switch
10825
10826                        This switch is meant to handle escape sequences that
10827                        resolve to a literal character.
10828
10829                        Every escape sequence that represents something
10830                        else, like an assertion or a char class, is handled
10831                        in the switch marked 'Special Escapes' above in this
10832                        routine, but also has an entry here as anything that
10833                        isn't explicitly mentioned here will be treated as
10834                        an unescaped equivalent literal.
10835                     */
10836
10837                     switch ((U8)*++p) {
10838                     /* These are all the special escapes. */
10839                     case 'A':             /* Start assertion */
10840                     case 'b': case 'B':   /* Word-boundary assertion*/
10841                     case 'C':             /* Single char !DANGEROUS! */
10842                     case 'd': case 'D':   /* digit class */
10843                     case 'g': case 'G':   /* generic-backref, pos assertion */
10844                     case 'h': case 'H':   /* HORIZWS */
10845                     case 'k': case 'K':   /* named backref, keep marker */
10846                     case 'p': case 'P':   /* Unicode property */
10847                               case 'R':   /* LNBREAK */
10848                     case 's': case 'S':   /* space class */
10849                     case 'v': case 'V':   /* VERTWS */
10850                     case 'w': case 'W':   /* word class */
10851                     case 'X':             /* eXtended Unicode "combining character sequence" */
10852                     case 'z': case 'Z':   /* End of line/string assertion */
10853                         --p;
10854                         goto loopdone;
10855
10856                     /* Anything after here is an escape that resolves to a
10857                        literal. (Except digits, which may or may not)
10858                      */
10859                     case 'n':
10860                         ender = '\n';
10861                         p++;
10862                         break;
10863                     case 'N': /* Handle a single-code point named character. */
10864                         /* The options cause it to fail if a multiple code
10865                          * point sequence.  Handle those in the switch() above
10866                          * */
10867                         RExC_parse = p + 1;
10868                         if (! grok_bslash_N(pRExC_state, NULL, &ender,
10869                                             flagp, depth, FALSE,
10870                                             FALSE /* not strict */ ))
10871                         {
10872                             if (*flagp & RESTART_UTF8)
10873                                 FAIL("panic: grok_bslash_N set RESTART_UTF8");
10874                             RExC_parse = p = oldp;
10875                             goto loopdone;
10876                         }
10877                         p = RExC_parse;
10878                         if (ender > 0xff) {
10879                             REQUIRE_UTF8;
10880                         }
10881                         break;
10882                     case 'r':
10883                         ender = '\r';
10884                         p++;
10885                         break;
10886                     case 't':
10887                         ender = '\t';
10888                         p++;
10889                         break;
10890                     case 'f':
10891                         ender = '\f';
10892                         p++;
10893                         break;
10894                     case 'e':
10895                           ender = ASCII_TO_NATIVE('\033');
10896                         p++;
10897                         break;
10898                     case 'a':
10899                           ender = ASCII_TO_NATIVE('\007');
10900                         p++;
10901                         break;
10902                     case 'o':
10903                         {
10904                             UV result;
10905                             const char* error_msg;
10906
10907                             bool valid = grok_bslash_o(&p,
10908                                                        &result,
10909                                                        &error_msg,
10910                                                        TRUE, /* out warnings */
10911                                                        FALSE, /* not strict */
10912                                                        TRUE, /* Output warnings
10913                                                                 for non-
10914                                                                 portables */
10915                                                        UTF);
10916                             if (! valid) {
10917                                 RExC_parse = p; /* going to die anyway; point
10918                                                    to exact spot of failure */
10919                                 vFAIL(error_msg);
10920                             }
10921                             ender = result;
10922                             if (PL_encoding && ender < 0x100) {
10923                                 goto recode_encoding;
10924                             }
10925                             if (ender > 0xff) {
10926                                 REQUIRE_UTF8;
10927                             }
10928                             break;
10929                         }
10930                     case 'x':
10931                         {
10932                             UV result = UV_MAX; /* initialize to erroneous
10933                                                    value */
10934                             const char* error_msg;
10935
10936                             bool valid = grok_bslash_x(&p,
10937                                                        &result,
10938                                                        &error_msg,
10939                                                        TRUE, /* out warnings */
10940                                                        FALSE, /* not strict */
10941                                                        TRUE, /* Output warnings
10942                                                                 for non-
10943                                                                 portables */
10944                                                        UTF);
10945                             if (! valid) {
10946                                 RExC_parse = p; /* going to die anyway; point
10947                                                    to exact spot of failure */
10948                                 vFAIL(error_msg);
10949                             }
10950                             ender = result;
10951
10952                             if (PL_encoding && ender < 0x100) {
10953                                 goto recode_encoding;
10954                             }
10955                             if (ender > 0xff) {
10956                                 REQUIRE_UTF8;
10957                             }
10958                             break;
10959                         }
10960                     case 'c':
10961                         p++;
10962                         ender = grok_bslash_c(*p++, UTF, SIZE_ONLY);
10963                         break;
10964                     case '0': case '1': case '2': case '3':case '4':
10965                     case '5': case '6': case '7':
10966                         if (*p == '0' ||
10967                             (isDIGIT(p[1]) && atoi(p) >= RExC_npar))
10968                         {
10969                             I32 flags = PERL_SCAN_SILENT_ILLDIGIT;
10970                             STRLEN numlen = 3;
10971                             ender = grok_oct(p, &numlen, &flags, NULL);
10972                             if (ender > 0xff) {
10973                                 REQUIRE_UTF8;
10974                             }
10975                             p += numlen;
10976                             if (SIZE_ONLY   /* like \08, \178 */
10977                                 && numlen < 3
10978                                 && p < RExC_end
10979                                 && isDIGIT(*p) && ckWARN(WARN_REGEXP))
10980                             {
10981                                 reg_warn_non_literal_string(
10982                                          p + 1,
10983                                          form_short_octal_warning(p, numlen));
10984                             }
10985                         }
10986                         else {  /* Not to be treated as an octal constant, go
10987                                    find backref */
10988                             --p;
10989                             goto loopdone;
10990                         }
10991                         if (PL_encoding && ender < 0x100)
10992                             goto recode_encoding;
10993                         break;
10994                     recode_encoding:
10995                         if (! RExC_override_recoding) {
10996                             SV* enc = PL_encoding;
10997                             ender = reg_recode((const char)(U8)ender, &enc);
10998                             if (!enc && SIZE_ONLY)
10999                                 ckWARNreg(p, "Invalid escape in the specified encoding");
11000                             REQUIRE_UTF8;
11001                         }
11002                         break;
11003                     case '\0':
11004                         if (p >= RExC_end)
11005                             FAIL("Trailing \\");
11006                         /* FALL THROUGH */
11007                     default:
11008                         if (!SIZE_ONLY&& isALPHANUMERIC(*p)) {
11009                             /* Include any { following the alpha to emphasize
11010                              * that it could be part of an escape at some point
11011                              * in the future */
11012                             int len = (isALPHA(*p) && *(p + 1) == '{') ? 2 : 1;
11013                             ckWARN3reg(p + len, "Unrecognized escape \\%.*s passed through", len, p);
11014                         }
11015                         goto normal_default;
11016                     } /* End of switch on '\' */
11017                     break;
11018                 default:    /* A literal character */
11019
11020                     if (! SIZE_ONLY
11021                         && RExC_flags & RXf_PMf_EXTENDED
11022                         && ckWARN(WARN_DEPRECATED)
11023                         && is_PATWS_non_low(p, UTF))
11024                     {
11025                         vWARN_dep(p + ((UTF) ? UTF8SKIP(p) : 1),
11026                                 "Escape literal pattern white space under /x");
11027                     }
11028
11029                   normal_default:
11030                     if (UTF8_IS_START(*p) && UTF) {
11031                         STRLEN numlen;
11032                         ender = utf8n_to_uvchr((U8*)p, RExC_end - p,
11033                                                &numlen, UTF8_ALLOW_DEFAULT);
11034                         p += numlen;
11035                     }
11036                     else
11037                         ender = (U8) *p++;
11038                     break;
11039                 } /* End of switch on the literal */
11040
11041                 /* Here, have looked at the literal character and <ender>
11042                  * contains its ordinal, <p> points to the character after it
11043                  */
11044
11045                 if ( RExC_flags & RXf_PMf_EXTENDED)
11046                     p = regwhite( pRExC_state, p );
11047
11048                 /* If the next thing is a quantifier, it applies to this
11049                  * character only, which means that this character has to be in
11050                  * its own node and can't just be appended to the string in an
11051                  * existing node, so if there are already other characters in
11052                  * the node, close the node with just them, and set up to do
11053                  * this character again next time through, when it will be the
11054                  * only thing in its new node */
11055                 if ((next_is_quantifier = (p < RExC_end && ISMULT2(p))) && len)
11056                 {
11057                     p = oldp;
11058                     goto loopdone;
11059                 }
11060
11061                 if (! FOLD) {
11062                     if (UTF) {
11063                         const STRLEN unilen = reguni(pRExC_state, ender, s);
11064                         if (unilen > 0) {
11065                            s   += unilen;
11066                            len += unilen;
11067                         }
11068
11069                         /* The loop increments <len> each time, as all but this
11070                          * path (and one other) through it add a single byte to
11071                          * the EXACTish node.  But this one has changed len to
11072                          * be the correct final value, so subtract one to
11073                          * cancel out the increment that follows */
11074                         len--;
11075                     }
11076                     else {
11077                         REGC((char)ender, s++);
11078                     }
11079                 }
11080                 else /* FOLD */
11081                      if (! ( UTF
11082                         /* See comments for join_exact() as to why we fold this
11083                          * non-UTF at compile time */
11084                         || (node_type == EXACTFU
11085                             && ender == LATIN_SMALL_LETTER_SHARP_S)))
11086                 {
11087                     *(s++) = (char) ender;
11088                     maybe_exact &= ! IS_IN_SOME_FOLD_L1(ender);
11089                 }
11090                 else {  /* UTF */
11091
11092                     /* Prime the casefolded buffer.  Locale rules, which apply
11093                      * only to code points < 256, aren't known until execution,
11094                      * so for them, just output the original character using
11095                      * utf8.  If we start to fold non-UTF patterns, be sure to
11096                      * update join_exact() */
11097                     if (LOC && ender < 256) {
11098                         if (UNI_IS_INVARIANT(ender)) {
11099                             *s = (U8) ender;
11100                             foldlen = 1;
11101                         } else {
11102                             *s = UTF8_TWO_BYTE_HI(ender);
11103                             *(s + 1) = UTF8_TWO_BYTE_LO(ender);
11104                             foldlen = 2;
11105                         }
11106                     }
11107                     else {
11108                         UV folded = _to_uni_fold_flags(
11109                                        ender,
11110                                        (U8 *) s,
11111                                        &foldlen,
11112                                        FOLD_FLAGS_FULL
11113                                        | ((LOC) ?  FOLD_FLAGS_LOCALE
11114                                                 : (ASCII_FOLD_RESTRICTED)
11115                                                   ? FOLD_FLAGS_NOMIX_ASCII
11116                                                   : 0)
11117                                         );
11118
11119                         /* If this node only contains non-folding code points
11120                          * so far, see if this new one is also non-folding */
11121                         if (maybe_exact) {
11122                             if (folded != ender) {
11123                                 maybe_exact = FALSE;
11124                             }
11125                             else {
11126                                 /* Here the fold is the original; we have
11127                                  * to check further to see if anything
11128                                  * folds to it */
11129                                 if (! PL_utf8_foldable) {
11130                                     SV* swash = swash_init("utf8",
11131                                                        "_Perl_Any_Folds",
11132                                                        &PL_sv_undef, 1, 0);
11133                                     PL_utf8_foldable =
11134                                                 _get_swash_invlist(swash);
11135                                     SvREFCNT_dec_NN(swash);
11136                                 }
11137                                 if (_invlist_contains_cp(PL_utf8_foldable,
11138                                                          ender))
11139                                 {
11140                                     maybe_exact = FALSE;
11141                                 }
11142                             }
11143                         }
11144                         ender = folded;
11145                     }
11146                     s += foldlen;
11147
11148                     /* The loop increments <len> each time, as all but this
11149                      * path (and one other) through it add a single byte to the
11150                      * EXACTish node.  But this one has changed len to be the
11151                      * correct final value, so subtract one to cancel out the
11152                      * increment that follows */
11153                     len += foldlen - 1;
11154                 }
11155
11156                 if (next_is_quantifier) {
11157
11158                     /* Here, the next input is a quantifier, and to get here,
11159                      * the current character is the only one in the node.
11160                      * Also, here <len> doesn't include the final byte for this
11161                      * character */
11162                     len++;
11163                     goto loopdone;
11164                 }
11165
11166             } /* End of loop through literal characters */
11167
11168             /* Here we have either exhausted the input or ran out of room in
11169              * the node.  (If we encountered a character that can't be in the
11170              * node, transfer is made directly to <loopdone>, and so we
11171              * wouldn't have fallen off the end of the loop.)  In the latter
11172              * case, we artificially have to split the node into two, because
11173              * we just don't have enough space to hold everything.  This
11174              * creates a problem if the final character participates in a
11175              * multi-character fold in the non-final position, as a match that
11176              * should have occurred won't, due to the way nodes are matched,
11177              * and our artificial boundary.  So back off until we find a non-
11178              * problematic character -- one that isn't at the beginning or
11179              * middle of such a fold.  (Either it doesn't participate in any
11180              * folds, or appears only in the final position of all the folds it
11181              * does participate in.)  A better solution with far fewer false
11182              * positives, and that would fill the nodes more completely, would
11183              * be to actually have available all the multi-character folds to
11184              * test against, and to back-off only far enough to be sure that
11185              * this node isn't ending with a partial one.  <upper_parse> is set
11186              * further below (if we need to reparse the node) to include just
11187              * up through that final non-problematic character that this code
11188              * identifies, so when it is set to less than the full node, we can
11189              * skip the rest of this */
11190             if (FOLD && p < RExC_end && upper_parse == MAX_NODE_STRING_SIZE) {
11191
11192                 const STRLEN full_len = len;
11193
11194                 assert(len >= MAX_NODE_STRING_SIZE);
11195
11196                 /* Here, <s> points to the final byte of the final character.
11197                  * Look backwards through the string until find a non-
11198                  * problematic character */
11199
11200                 if (! UTF) {
11201
11202                     /* These two have no multi-char folds to non-UTF characters
11203                      */
11204                     if (ASCII_FOLD_RESTRICTED || LOC) {
11205                         goto loopdone;
11206                     }
11207
11208                     while (--s >= s0 && IS_NON_FINAL_FOLD(*s)) { }
11209                     len = s - s0 + 1;
11210                 }
11211                 else {
11212                     if (!  PL_NonL1NonFinalFold) {
11213                         PL_NonL1NonFinalFold = _new_invlist_C_array(
11214                                         NonL1_Perl_Non_Final_Folds_invlist);
11215                     }
11216
11217                     /* Point to the first byte of the final character */
11218                     s = (char *) utf8_hop((U8 *) s, -1);
11219
11220                     while (s >= s0) {   /* Search backwards until find
11221                                            non-problematic char */
11222                         if (UTF8_IS_INVARIANT(*s)) {
11223
11224                             /* There are no ascii characters that participate
11225                              * in multi-char folds under /aa.  In EBCDIC, the
11226                              * non-ascii invariants are all control characters,
11227                              * so don't ever participate in any folds. */
11228                             if (ASCII_FOLD_RESTRICTED
11229                                 || ! IS_NON_FINAL_FOLD(*s))
11230                             {
11231                                 break;
11232                             }
11233                         }
11234                         else if (UTF8_IS_DOWNGRADEABLE_START(*s)) {
11235
11236                             /* No Latin1 characters participate in multi-char
11237                              * folds under /l */
11238                             if (LOC
11239                                 || ! IS_NON_FINAL_FOLD(TWO_BYTE_UTF8_TO_UNI(
11240                                                                 *s, *(s+1))))
11241                             {
11242                                 break;
11243                             }
11244                         }
11245                         else if (! _invlist_contains_cp(
11246                                         PL_NonL1NonFinalFold,
11247                                         valid_utf8_to_uvchr((U8 *) s, NULL)))
11248                         {
11249                             break;
11250                         }
11251
11252                         /* Here, the current character is problematic in that
11253                          * it does occur in the non-final position of some
11254                          * fold, so try the character before it, but have to
11255                          * special case the very first byte in the string, so
11256                          * we don't read outside the string */
11257                         s = (s == s0) ? s -1 : (char *) utf8_hop((U8 *) s, -1);
11258                     } /* End of loop backwards through the string */
11259
11260                     /* If there were only problematic characters in the string,
11261                      * <s> will point to before s0, in which case the length
11262                      * should be 0, otherwise include the length of the
11263                      * non-problematic character just found */
11264                     len = (s < s0) ? 0 : s - s0 + UTF8SKIP(s);
11265                 }
11266
11267                 /* Here, have found the final character, if any, that is
11268                  * non-problematic as far as ending the node without splitting
11269                  * it across a potential multi-char fold.  <len> contains the
11270                  * number of bytes in the node up-to and including that
11271                  * character, or is 0 if there is no such character, meaning
11272                  * the whole node contains only problematic characters.  In
11273                  * this case, give up and just take the node as-is.  We can't
11274                  * do any better */
11275                 if (len == 0) {
11276                     len = full_len;
11277                 } else {
11278
11279                     /* Here, the node does contain some characters that aren't
11280                      * problematic.  If one such is the final character in the
11281                      * node, we are done */
11282                     if (len == full_len) {
11283                         goto loopdone;
11284                     }
11285                     else if (len + ((UTF) ? UTF8SKIP(s) : 1) == full_len) {
11286
11287                         /* If the final character is problematic, but the
11288                          * penultimate is not, back-off that last character to
11289                          * later start a new node with it */
11290                         p = oldp;
11291                         goto loopdone;
11292                     }
11293
11294                     /* Here, the final non-problematic character is earlier
11295                      * in the input than the penultimate character.  What we do
11296                      * is reparse from the beginning, going up only as far as
11297                      * this final ok one, thus guaranteeing that the node ends
11298                      * in an acceptable character.  The reason we reparse is
11299                      * that we know how far in the character is, but we don't
11300                      * know how to correlate its position with the input parse.
11301                      * An alternate implementation would be to build that
11302                      * correlation as we go along during the original parse,
11303                      * but that would entail extra work for every node, whereas
11304                      * this code gets executed only when the string is too
11305                      * large for the node, and the final two characters are
11306                      * problematic, an infrequent occurrence.  Yet another
11307                      * possible strategy would be to save the tail of the
11308                      * string, and the next time regatom is called, initialize
11309                      * with that.  The problem with this is that unless you
11310                      * back off one more character, you won't be guaranteed
11311                      * regatom will get called again, unless regbranch,
11312                      * regpiece ... are also changed.  If you do back off that
11313                      * extra character, so that there is input guaranteed to
11314                      * force calling regatom, you can't handle the case where
11315                      * just the first character in the node is acceptable.  I
11316                      * (khw) decided to try this method which doesn't have that
11317                      * pitfall; if performance issues are found, we can do a
11318                      * combination of the current approach plus that one */
11319                     upper_parse = len;
11320                     len = 0;
11321                     s = s0;
11322                     goto reparse;
11323                 }
11324             }   /* End of verifying node ends with an appropriate char */
11325
11326         loopdone:   /* Jumped to when encounters something that shouldn't be in
11327                        the node */
11328
11329             /* If 'maybe_exact' is still set here, means there are no
11330              * code points in the node that participate in folds */
11331             if (FOLD && maybe_exact) {
11332                 OP(ret) = EXACT;
11333             }
11334
11335             /* I (khw) don't know if you can get here with zero length, but the
11336              * old code handled this situation by creating a zero-length EXACT
11337              * node.  Might as well be NOTHING instead */
11338             if (len == 0) {
11339                 OP(ret) = NOTHING;
11340             }
11341             else{
11342                 alloc_maybe_populate_EXACT(pRExC_state, ret, flagp, len, ender);
11343             }
11344
11345             RExC_parse = p - 1;
11346             Set_Node_Cur_Length(ret); /* MJD */
11347             nextchar(pRExC_state);
11348             {
11349                 /* len is STRLEN which is unsigned, need to copy to signed */
11350                 IV iv = len;
11351                 if (iv < 0)
11352                     vFAIL("Internal disaster");
11353             }
11354
11355         } /* End of label 'defchar:' */
11356         break;
11357     } /* End of giant switch on input character */
11358
11359     return(ret);
11360 }
11361
11362 STATIC char *
11363 S_regwhite( RExC_state_t *pRExC_state, char *p )
11364 {
11365     const char *e = RExC_end;
11366
11367     PERL_ARGS_ASSERT_REGWHITE;
11368
11369     while (p < e) {
11370         if (isSPACE(*p))
11371             ++p;
11372         else if (*p == '#') {
11373             bool ended = 0;
11374             do {
11375                 if (*p++ == '\n') {
11376                     ended = 1;
11377                     break;
11378                 }
11379             } while (p < e);
11380             if (!ended)
11381                 RExC_seen |= REG_SEEN_RUN_ON_COMMENT;
11382         }
11383         else
11384             break;
11385     }
11386     return p;
11387 }
11388
11389 STATIC char *
11390 S_regpatws( RExC_state_t *pRExC_state, char *p , const bool recognize_comment )
11391 {
11392     /* Returns the next non-pattern-white space, non-comment character (the
11393      * latter only if 'recognize_comment is true) in the string p, which is
11394      * ended by RExC_end.  If there is no line break ending a comment,
11395      * RExC_seen has added the REG_SEEN_RUN_ON_COMMENT flag; */
11396     const char *e = RExC_end;
11397
11398     PERL_ARGS_ASSERT_REGPATWS;
11399
11400     while (p < e) {
11401         STRLEN len;
11402         if ((len = is_PATWS_safe(p, e, UTF))) {
11403             p += len;
11404         }
11405         else if (recognize_comment && *p == '#') {
11406             bool ended = 0;
11407             do {
11408                 p++;
11409                 if (is_LNBREAK_safe(p, e, UTF)) {
11410                     ended = 1;
11411                     break;
11412                 }
11413             } while (p < e);
11414             if (!ended)
11415                 RExC_seen |= REG_SEEN_RUN_ON_COMMENT;
11416         }
11417         else
11418             break;
11419     }
11420     return p;
11421 }
11422
11423 /* Parse POSIX character classes: [[:foo:]], [[=foo=]], [[.foo.]].
11424    Character classes ([:foo:]) can also be negated ([:^foo:]).
11425    Returns a named class id (ANYOF_XXX) if successful, -1 otherwise.
11426    Equivalence classes ([=foo=]) and composites ([.foo.]) are parsed,
11427    but trigger failures because they are currently unimplemented. */
11428
11429 #define POSIXCC_DONE(c)   ((c) == ':')
11430 #define POSIXCC_NOTYET(c) ((c) == '=' || (c) == '.')
11431 #define POSIXCC(c) (POSIXCC_DONE(c) || POSIXCC_NOTYET(c))
11432
11433 PERL_STATIC_INLINE I32
11434 S_regpposixcc(pTHX_ RExC_state_t *pRExC_state, I32 value, const bool strict)
11435 {
11436     dVAR;
11437     I32 namedclass = OOB_NAMEDCLASS;
11438
11439     PERL_ARGS_ASSERT_REGPPOSIXCC;
11440
11441     if (value == '[' && RExC_parse + 1 < RExC_end &&
11442         /* I smell either [: or [= or [. -- POSIX has been here, right? */
11443         POSIXCC(UCHARAT(RExC_parse)))
11444     {
11445         const char c = UCHARAT(RExC_parse);
11446         char* const s = RExC_parse++;
11447
11448         while (RExC_parse < RExC_end && UCHARAT(RExC_parse) != c)
11449             RExC_parse++;
11450         if (RExC_parse == RExC_end) {
11451             if (strict) {
11452
11453                 /* Try to give a better location for the error (than the end of
11454                  * the string) by looking for the matching ']' */
11455                 RExC_parse = s;
11456                 while (RExC_parse < RExC_end && UCHARAT(RExC_parse) != ']') {
11457                     RExC_parse++;
11458                 }
11459                 vFAIL2("Unmatched '%c' in POSIX class", c);
11460             }
11461             /* Grandfather lone [:, [=, [. */
11462             RExC_parse = s;
11463         }
11464         else {
11465             const char* const t = RExC_parse++; /* skip over the c */
11466             assert(*t == c);
11467
11468             if (UCHARAT(RExC_parse) == ']') {
11469                 const char *posixcc = s + 1;
11470                 RExC_parse++; /* skip over the ending ] */
11471
11472                 if (*s == ':') {
11473                     const I32 complement = *posixcc == '^' ? *posixcc++ : 0;
11474                     const I32 skip = t - posixcc;
11475
11476                     /* Initially switch on the length of the name.  */
11477                     switch (skip) {
11478                     case 4:
11479                         if (memEQ(posixcc, "word", 4)) /* this is not POSIX,
11480                                                           this is the Perl \w
11481                                                         */
11482                             namedclass = ANYOF_WORDCHAR;
11483                         break;
11484                     case 5:
11485                         /* Names all of length 5.  */
11486                         /* alnum alpha ascii blank cntrl digit graph lower
11487                            print punct space upper  */
11488                         /* Offset 4 gives the best switch position.  */
11489                         switch (posixcc[4]) {
11490                         case 'a':
11491                             if (memEQ(posixcc, "alph", 4)) /* alpha */
11492                                 namedclass = ANYOF_ALPHA;
11493                             break;
11494                         case 'e':
11495                             if (memEQ(posixcc, "spac", 4)) /* space */
11496                                 namedclass = ANYOF_PSXSPC;
11497                             break;
11498                         case 'h':
11499                             if (memEQ(posixcc, "grap", 4)) /* graph */
11500                                 namedclass = ANYOF_GRAPH;
11501                             break;
11502                         case 'i':
11503                             if (memEQ(posixcc, "asci", 4)) /* ascii */
11504                                 namedclass = ANYOF_ASCII;
11505                             break;
11506                         case 'k':
11507                             if (memEQ(posixcc, "blan", 4)) /* blank */
11508                                 namedclass = ANYOF_BLANK;
11509                             break;
11510                         case 'l':
11511                             if (memEQ(posixcc, "cntr", 4)) /* cntrl */
11512                                 namedclass = ANYOF_CNTRL;
11513                             break;
11514                         case 'm':
11515                             if (memEQ(posixcc, "alnu", 4)) /* alnum */
11516                                 namedclass = ANYOF_ALPHANUMERIC;
11517                             break;
11518                         case 'r':
11519                             if (memEQ(posixcc, "lowe", 4)) /* lower */
11520                                 namedclass = (FOLD) ? ANYOF_CASED : ANYOF_LOWER;
11521                             else if (memEQ(posixcc, "uppe", 4)) /* upper */
11522                                 namedclass = (FOLD) ? ANYOF_CASED : ANYOF_UPPER;
11523                             break;
11524                         case 't':
11525                             if (memEQ(posixcc, "digi", 4)) /* digit */
11526                                 namedclass = ANYOF_DIGIT;
11527                             else if (memEQ(posixcc, "prin", 4)) /* print */
11528                                 namedclass = ANYOF_PRINT;
11529                             else if (memEQ(posixcc, "punc", 4)) /* punct */
11530                                 namedclass = ANYOF_PUNCT;
11531                             break;
11532                         }
11533                         break;
11534                     case 6:
11535                         if (memEQ(posixcc, "xdigit", 6))
11536                             namedclass = ANYOF_XDIGIT;
11537                         break;
11538                     }
11539
11540                     if (namedclass == OOB_NAMEDCLASS)
11541                         Simple_vFAIL3("POSIX class [:%.*s:] unknown",
11542                                       t - s - 1, s + 1);
11543
11544                     /* The #defines are structured so each complement is +1 to
11545                      * the normal one */
11546                     if (complement) {
11547                         namedclass++;
11548                     }
11549                     assert (posixcc[skip] == ':');
11550                     assert (posixcc[skip+1] == ']');
11551                 } else if (!SIZE_ONLY) {
11552                     /* [[=foo=]] and [[.foo.]] are still future. */
11553
11554                     /* adjust RExC_parse so the warning shows after
11555                        the class closes */
11556                     while (UCHARAT(RExC_parse) && UCHARAT(RExC_parse) != ']')
11557                         RExC_parse++;
11558                     vFAIL3("POSIX syntax [%c %c] is reserved for future extensions", c, c);
11559                 }
11560             } else {
11561                 /* Maternal grandfather:
11562                  * "[:" ending in ":" but not in ":]" */
11563                 if (strict) {
11564                     vFAIL("Unmatched '[' in POSIX class");
11565                 }
11566
11567                 /* Grandfather lone [:, [=, [. */
11568                 RExC_parse = s;
11569             }
11570         }
11571     }
11572
11573     return namedclass;
11574 }
11575
11576 STATIC bool
11577 S_could_it_be_a_POSIX_class(pTHX_ RExC_state_t *pRExC_state)
11578 {
11579     /* This applies some heuristics at the current parse position (which should
11580      * be at a '[') to see if what follows might be intended to be a [:posix:]
11581      * class.  It returns true if it really is a posix class, of course, but it
11582      * also can return true if it thinks that what was intended was a posix
11583      * class that didn't quite make it.
11584      *
11585      * It will return true for
11586      *      [:alphanumerics:
11587      *      [:alphanumerics]  (as long as the ] isn't followed immediately by a
11588      *                         ')' indicating the end of the (?[
11589      *      [:any garbage including %^&$ punctuation:]
11590      *
11591      * This is designed to be called only from S_handle_regex_sets; it could be
11592      * easily adapted to be called from the spot at the beginning of regclass()
11593      * that checks to see in a normal bracketed class if the surrounding []
11594      * have been omitted ([:word:] instead of [[:word:]]).  But doing so would
11595      * change long-standing behavior, so I (khw) didn't do that */
11596     char* p = RExC_parse + 1;
11597     char first_char = *p;
11598
11599     PERL_ARGS_ASSERT_COULD_IT_BE_A_POSIX_CLASS;
11600
11601     assert(*(p - 1) == '[');
11602
11603     if (! POSIXCC(first_char)) {
11604         return FALSE;
11605     }
11606
11607     p++;
11608     while (p < RExC_end && isWORDCHAR(*p)) p++;
11609
11610     if (p >= RExC_end) {
11611         return FALSE;
11612     }
11613
11614     if (p - RExC_parse > 2    /* Got at least 1 word character */
11615         && (*p == first_char
11616             || (*p == ']' && p + 1 < RExC_end && *(p + 1) != ')')))
11617     {
11618         return TRUE;
11619     }
11620
11621     p = (char *) memchr(RExC_parse, ']', RExC_end - RExC_parse);
11622
11623     return (p
11624             && p - RExC_parse > 2 /* [:] evaluates to colon;
11625                                       [::] is a bad posix class. */
11626             && first_char == *(p - 1));
11627 }
11628
11629 STATIC regnode *
11630 S_handle_regex_sets(pTHX_ RExC_state_t *pRExC_state, SV** return_invlist, I32 *flagp, U32 depth,
11631                    char * const oregcomp_parse)
11632 {
11633     /* Handle the (?[...]) construct to do set operations */
11634
11635     U8 curchar;
11636     UV start, end;      /* End points of code point ranges */
11637     SV* result_string;
11638     char *save_end, *save_parse;
11639     SV* final;
11640     STRLEN len;
11641     regnode* node;
11642     AV* stack;
11643     const bool save_fold = FOLD;
11644
11645     GET_RE_DEBUG_FLAGS_DECL;
11646
11647     PERL_ARGS_ASSERT_HANDLE_REGEX_SETS;
11648
11649     if (LOC) {
11650         vFAIL("(?[...]) not valid in locale");
11651     }
11652     RExC_uni_semantics = 1;
11653
11654     /* This will return only an ANYOF regnode, or (unlikely) something smaller
11655      * (such as EXACT).  Thus we can skip most everything if just sizing.  We
11656      * call regclass to handle '[]' so as to not have to reinvent its parsing
11657      * rules here (throwing away the size it computes each time).  And, we exit
11658      * upon an unescaped ']' that isn't one ending a regclass.  To do both
11659      * these things, we need to realize that something preceded by a backslash
11660      * is escaped, so we have to keep track of backslashes */
11661     if (SIZE_ONLY) {
11662
11663         Perl_ck_warner_d(aTHX_
11664             packWARN(WARN_EXPERIMENTAL__REGEX_SETS),
11665             "The regex_sets feature is experimental" REPORT_LOCATION,
11666             (int) (RExC_parse - RExC_precomp) , RExC_precomp, RExC_parse);
11667
11668         while (RExC_parse < RExC_end) {
11669             SV* current = NULL;
11670             RExC_parse = regpatws(pRExC_state, RExC_parse,
11671                                 TRUE); /* means recognize comments */
11672             switch (*RExC_parse) {
11673                 default:
11674                     break;
11675                 case '\\':
11676                     /* Skip the next byte (which could cause us to end up in
11677                      * the middle of a UTF-8 character, but since none of those
11678                      * are confusable with anything we currently handle in this
11679                      * switch (invariants all), it's safe.  We'll just hit the
11680                      * default: case next time and keep on incrementing until
11681                      * we find one of the invariants we do handle. */
11682                     RExC_parse++;
11683                     break;
11684                 case '[':
11685                 {
11686                     /* If this looks like it is a [:posix:] class, leave the
11687                      * parse pointer at the '[' to fool regclass() into
11688                      * thinking it is part of a '[[:posix:]]'.  That function
11689                      * will use strict checking to force a syntax error if it
11690                      * doesn't work out to a legitimate class */
11691                     bool is_posix_class
11692                                     = could_it_be_a_POSIX_class(pRExC_state);
11693                     if (! is_posix_class) {
11694                         RExC_parse++;
11695                     }
11696
11697                     /* regclass() can only return RESTART_UTF8 if multi-char
11698                        folds are allowed.  */
11699                     if (!regclass(pRExC_state, flagp,depth+1,
11700                                   is_posix_class, /* parse the whole char
11701                                                      class only if not a
11702                                                      posix class */
11703                                   FALSE, /* don't allow multi-char folds */
11704                                   TRUE, /* silence non-portable warnings. */
11705                                   &current))
11706                         FAIL2("panic: regclass returned NULL to handle_sets, flags=%#"UVxf"",
11707                               (UV) *flagp);
11708
11709                     /* function call leaves parse pointing to the ']', except
11710                      * if we faked it */
11711                     if (is_posix_class) {
11712                         RExC_parse--;
11713                     }
11714
11715                     SvREFCNT_dec(current);   /* In case it returned something */
11716                     break;
11717                 }
11718
11719                 case ']':
11720                     RExC_parse++;
11721                     if (RExC_parse < RExC_end
11722                         && *RExC_parse == ')')
11723                     {
11724                         node = reganode(pRExC_state, ANYOF, 0);
11725                         RExC_size += ANYOF_SKIP;
11726                         nextchar(pRExC_state);
11727                         Set_Node_Length(node,
11728                                 RExC_parse - oregcomp_parse + 1); /* MJD */
11729                         return node;
11730                     }
11731                     goto no_close;
11732             }
11733             RExC_parse++;
11734         }
11735
11736         no_close:
11737         FAIL("Syntax error in (?[...])");
11738     }
11739
11740     /* Pass 2 only after this.  Everything in this construct is a
11741      * metacharacter.  Operands begin with either a '\' (for an escape
11742      * sequence), or a '[' for a bracketed character class.  Any other
11743      * character should be an operator, or parenthesis for grouping.  Both
11744      * types of operands are handled by calling regclass() to parse them.  It
11745      * is called with a parameter to indicate to return the computed inversion
11746      * list.  The parsing here is implemented via a stack.  Each entry on the
11747      * stack is a single character representing one of the operators, or the
11748      * '('; or else a pointer to an operand inversion list. */
11749
11750 #define IS_OPERAND(a)  (! SvIOK(a))
11751
11752     /* The stack starts empty.  It is a syntax error if the first thing parsed
11753      * is a binary operator; everything else is pushed on the stack.  When an
11754      * operand is parsed, the top of the stack is examined.  If it is a binary
11755      * operator, the item before it should be an operand, and both are replaced
11756      * by the result of doing that operation on the new operand and the one on
11757      * the stack.   Thus a sequence of binary operands is reduced to a single
11758      * one before the next one is parsed.
11759      *
11760      * A unary operator may immediately follow a binary in the input, for
11761      * example
11762      *      [a] + ! [b]
11763      * When an operand is parsed and the top of the stack is a unary operator,
11764      * the operation is performed, and then the stack is rechecked to see if
11765      * this new operand is part of a binary operation; if so, it is handled as
11766      * above.
11767      *
11768      * A '(' is simply pushed on the stack; it is valid only if the stack is
11769      * empty, or the top element of the stack is an operator or another '('
11770      * (for which the parenthesized expression will become an operand).  By the
11771      * time the corresponding ')' is parsed everything in between should have
11772      * been parsed and evaluated to a single operand (or else is a syntax
11773      * error), and is handled as a regular operand */
11774
11775     stack = newAV();
11776
11777     while (RExC_parse < RExC_end) {
11778         I32 top_index = av_tindex(stack);
11779         SV** top_ptr;
11780         SV* current = NULL;
11781
11782         /* Skip white space */
11783         RExC_parse = regpatws(pRExC_state, RExC_parse,
11784                                 TRUE); /* means recognize comments */
11785         if (RExC_parse >= RExC_end) {
11786             Perl_croak(aTHX_ "panic: Read past end of '(?[ ])'");
11787         }
11788         if ((curchar = UCHARAT(RExC_parse)) == ']') {
11789             break;
11790         }
11791
11792         switch (curchar) {
11793
11794             case '?':
11795                 if (av_tindex(stack) >= 0   /* This makes sure that we can
11796                                                safely subtract 1 from
11797                                                RExC_parse in the next clause.
11798                                                If we have something on the
11799                                                stack, we have parsed something
11800                                              */
11801                     && UCHARAT(RExC_parse - 1) == '('
11802                     && RExC_parse < RExC_end)
11803                 {
11804                     /* If is a '(?', could be an embedded '(?flags:(?[...])'.
11805                      * This happens when we have some thing like
11806                      *
11807                      *   my $thai_or_lao = qr/(?[ \p{Thai} + \p{Lao} ])/;
11808                      *   ...
11809                      *   qr/(?[ \p{Digit} & $thai_or_lao ])/;
11810                      *
11811                      * Here we would be handling the interpolated
11812                      * '$thai_or_lao'.  We handle this by a recursive call to
11813                      * ourselves which returns the inversion list the
11814                      * interpolated expression evaluates to.  We use the flags
11815                      * from the interpolated pattern. */
11816                     U32 save_flags = RExC_flags;
11817                     const char * const save_parse = ++RExC_parse;
11818
11819                     parse_lparen_question_flags(pRExC_state);
11820
11821                     if (RExC_parse == save_parse  /* Makes sure there was at
11822                                                      least one flag (or this
11823                                                      embedding wasn't compiled)
11824                                                    */
11825                         || RExC_parse >= RExC_end - 4
11826                         || UCHARAT(RExC_parse) != ':'
11827                         || UCHARAT(++RExC_parse) != '('
11828                         || UCHARAT(++RExC_parse) != '?'
11829                         || UCHARAT(++RExC_parse) != '[')
11830                     {
11831
11832                         /* In combination with the above, this moves the
11833                          * pointer to the point just after the first erroneous
11834                          * character (or if there are no flags, to where they
11835                          * should have been) */
11836                         if (RExC_parse >= RExC_end - 4) {
11837                             RExC_parse = RExC_end;
11838                         }
11839                         else if (RExC_parse != save_parse) {
11840                             RExC_parse += (UTF) ? UTF8SKIP(RExC_parse) : 1;
11841                         }
11842                         vFAIL("Expecting '(?flags:(?[...'");
11843                     }
11844                     RExC_parse++;
11845                     (void) handle_regex_sets(pRExC_state, &current, flagp,
11846                                                     depth+1, oregcomp_parse);
11847
11848                     /* Here, 'current' contains the embedded expression's
11849                      * inversion list, and RExC_parse points to the trailing
11850                      * ']'; the next character should be the ')' which will be
11851                      * paired with the '(' that has been put on the stack, so
11852                      * the whole embedded expression reduces to '(operand)' */
11853                     RExC_parse++;
11854
11855                     RExC_flags = save_flags;
11856                     goto handle_operand;
11857                 }
11858                 /* FALL THROUGH */
11859
11860             default:
11861                 RExC_parse += (UTF) ? UTF8SKIP(RExC_parse) : 1;
11862                 vFAIL("Unexpected character");
11863
11864             case '\\':
11865                 /* regclass() can only return RESTART_UTF8 if multi-char
11866                    folds are allowed.  */
11867                 if (!regclass(pRExC_state, flagp,depth+1,
11868                               TRUE, /* means parse just the next thing */
11869                               FALSE, /* don't allow multi-char folds */
11870                               FALSE, /* don't silence non-portable warnings.  */
11871                               &current))
11872                     FAIL2("panic: regclass returned NULL to handle_sets, flags=%#"UVxf"",
11873                           (UV) *flagp);
11874                 /* regclass() will return with parsing just the \ sequence,
11875                  * leaving the parse pointer at the next thing to parse */
11876                 RExC_parse--;
11877                 goto handle_operand;
11878
11879             case '[':   /* Is a bracketed character class */
11880             {
11881                 bool is_posix_class = could_it_be_a_POSIX_class(pRExC_state);
11882
11883                 if (! is_posix_class) {
11884                     RExC_parse++;
11885                 }
11886
11887                 /* regclass() can only return RESTART_UTF8 if multi-char
11888                    folds are allowed.  */
11889                 if(!regclass(pRExC_state, flagp,depth+1,
11890                              is_posix_class, /* parse the whole char class
11891                                                 only if not a posix class */
11892                              FALSE, /* don't allow multi-char folds */
11893                              FALSE, /* don't silence non-portable warnings.  */
11894                              &current))
11895                     FAIL2("panic: regclass returned NULL to handle_sets, flags=%#"UVxf"",
11896                           (UV) *flagp);
11897                 /* function call leaves parse pointing to the ']', except if we
11898                  * faked it */
11899                 if (is_posix_class) {
11900                     RExC_parse--;
11901                 }
11902
11903                 goto handle_operand;
11904             }
11905
11906             case '&':
11907             case '|':
11908             case '+':
11909             case '-':
11910             case '^':
11911                 if (top_index < 0
11912                     || ( ! (top_ptr = av_fetch(stack, top_index, FALSE)))
11913                     || ! IS_OPERAND(*top_ptr))
11914                 {
11915                     RExC_parse++;
11916                     vFAIL2("Unexpected binary operator '%c' with no preceding operand", curchar);
11917                 }
11918                 av_push(stack, newSVuv(curchar));
11919                 break;
11920
11921             case '!':
11922                 av_push(stack, newSVuv(curchar));
11923                 break;
11924
11925             case '(':
11926                 if (top_index >= 0) {
11927                     top_ptr = av_fetch(stack, top_index, FALSE);
11928                     assert(top_ptr);
11929                     if (IS_OPERAND(*top_ptr)) {
11930                         RExC_parse++;
11931                         vFAIL("Unexpected '(' with no preceding operator");
11932                     }
11933                 }
11934                 av_push(stack, newSVuv(curchar));
11935                 break;
11936
11937             case ')':
11938             {
11939                 SV* lparen;
11940                 if (top_index < 1
11941                     || ! (current = av_pop(stack))
11942                     || ! IS_OPERAND(current)
11943                     || ! (lparen = av_pop(stack))
11944                     || IS_OPERAND(lparen)
11945                     || SvUV(lparen) != '(')
11946                 {
11947                     RExC_parse++;
11948                     vFAIL("Unexpected ')'");
11949                 }
11950                 top_index -= 2;
11951                 SvREFCNT_dec_NN(lparen);
11952
11953                 /* FALL THROUGH */
11954             }
11955
11956               handle_operand:
11957
11958                 /* Here, we have an operand to process, in 'current' */
11959
11960                 if (top_index < 0) {    /* Just push if stack is empty */
11961                     av_push(stack, current);
11962                 }
11963                 else {
11964                     SV* top = av_pop(stack);
11965                     char current_operator;
11966
11967                     if (IS_OPERAND(top)) {
11968                         vFAIL("Operand with no preceding operator");
11969                     }
11970                     current_operator = (char) SvUV(top);
11971                     switch (current_operator) {
11972                         case '(':   /* Push the '(' back on followed by the new
11973                                        operand */
11974                             av_push(stack, top);
11975                             av_push(stack, current);
11976                             SvREFCNT_inc(top);  /* Counters the '_dec' done
11977                                                    just after the 'break', so
11978                                                    it doesn't get wrongly freed
11979                                                  */
11980                             break;
11981
11982                         case '!':
11983                             _invlist_invert(current);
11984
11985                             /* Unlike binary operators, the top of the stack,
11986                              * now that this unary one has been popped off, may
11987                              * legally be an operator, and we now have operand
11988                              * for it. */
11989                             top_index--;
11990                             SvREFCNT_dec_NN(top);
11991                             goto handle_operand;
11992
11993                         case '&':
11994                             _invlist_intersection(av_pop(stack),
11995                                                    current,
11996                                                    &current);
11997                             av_push(stack, current);
11998                             break;
11999
12000                         case '|':
12001                         case '+':
12002                             _invlist_union(av_pop(stack), current, &current);
12003                             av_push(stack, current);
12004                             break;
12005
12006                         case '-':
12007                             _invlist_subtract(av_pop(stack), current, &current);
12008                             av_push(stack, current);
12009                             break;
12010
12011                         case '^':   /* The union minus the intersection */
12012                         {
12013                             SV* i = NULL;
12014                             SV* u = NULL;
12015                             SV* element;
12016
12017                             element = av_pop(stack);
12018                             _invlist_union(element, current, &u);
12019                             _invlist_intersection(element, current, &i);
12020                             _invlist_subtract(u, i, &current);
12021                             av_push(stack, current);
12022                             SvREFCNT_dec_NN(i);
12023                             SvREFCNT_dec_NN(u);
12024                             SvREFCNT_dec_NN(element);
12025                             break;
12026                         }
12027
12028                         default:
12029                             Perl_croak(aTHX_ "panic: Unexpected item on '(?[ ])' stack");
12030                 }
12031                 SvREFCNT_dec_NN(top);
12032             }
12033         }
12034
12035         RExC_parse += (UTF) ? UTF8SKIP(RExC_parse) : 1;
12036     }
12037
12038     if (av_tindex(stack) < 0   /* Was empty */
12039         || ((final = av_pop(stack)) == NULL)
12040         || ! IS_OPERAND(final)
12041         || av_tindex(stack) >= 0)  /* More left on stack */
12042     {
12043         vFAIL("Incomplete expression within '(?[ ])'");
12044     }
12045
12046     /* Here, 'final' is the resultant inversion list from evaluating the
12047      * expression.  Return it if so requested */
12048     if (return_invlist) {
12049         *return_invlist = final;
12050         return END;
12051     }
12052
12053     /* Otherwise generate a resultant node, based on 'final'.  regclass() is
12054      * expecting a string of ranges and individual code points */
12055     invlist_iterinit(final);
12056     result_string = newSVpvs("");
12057     while (invlist_iternext(final, &start, &end)) {
12058         if (start == end) {
12059             Perl_sv_catpvf(aTHX_ result_string, "\\x{%"UVXf"}", start);
12060         }
12061         else {
12062             Perl_sv_catpvf(aTHX_ result_string, "\\x{%"UVXf"}-\\x{%"UVXf"}",
12063                                                      start,          end);
12064         }
12065     }
12066
12067     save_parse = RExC_parse;
12068     RExC_parse = SvPV(result_string, len);
12069     save_end = RExC_end;
12070     RExC_end = RExC_parse + len;
12071
12072     /* We turn off folding around the call, as the class we have constructed
12073      * already has all folding taken into consideration, and we don't want
12074      * regclass() to add to that */
12075     RExC_flags &= ~RXf_PMf_FOLD;
12076     /* regclass() can only return RESTART_UTF8 if multi-char folds are allowed.
12077      */
12078     node = regclass(pRExC_state, flagp,depth+1,
12079                     FALSE, /* means parse the whole char class */
12080                     FALSE, /* don't allow multi-char folds */
12081                     TRUE, /* silence non-portable warnings.  The above may very
12082                              well have generated non-portable code points, but
12083                              they're valid on this machine */
12084                     NULL);
12085     if (!node)
12086         FAIL2("panic: regclass returned NULL to handle_sets, flags=%#"UVxf,
12087                     PTR2UV(flagp));
12088     if (save_fold) {
12089         RExC_flags |= RXf_PMf_FOLD;
12090     }
12091     RExC_parse = save_parse + 1;
12092     RExC_end = save_end;
12093     SvREFCNT_dec_NN(final);
12094     SvREFCNT_dec_NN(result_string);
12095     SvREFCNT_dec_NN(stack);
12096
12097     nextchar(pRExC_state);
12098     Set_Node_Length(node, RExC_parse - oregcomp_parse + 1); /* MJD */
12099     return node;
12100 }
12101 #undef IS_OPERAND
12102
12103 /* The names of properties whose definitions are not known at compile time are
12104  * stored in this SV, after a constant heading.  So if the length has been
12105  * changed since initialization, then there is a run-time definition. */
12106 #define HAS_NONLOCALE_RUNTIME_PROPERTY_DEFINITION (SvCUR(listsv) != initial_listsv_len)
12107
12108 STATIC regnode *
12109 S_regclass(pTHX_ RExC_state_t *pRExC_state, I32 *flagp, U32 depth,
12110                  const bool stop_at_1,  /* Just parse the next thing, don't
12111                                            look for a full character class */
12112                  bool allow_multi_folds,
12113                  const bool silence_non_portable,   /* Don't output warnings
12114                                                        about too large
12115                                                        characters */
12116                  SV** ret_invlist)  /* Return an inversion list, not a node */
12117 {
12118     /* parse a bracketed class specification.  Most of these will produce an
12119      * ANYOF node; but something like [a] will produce an EXACT node; [aA], an
12120      * EXACTFish node; [[:ascii:]], a POSIXA node; etc.  It is more complex
12121      * under /i with multi-character folds: it will be rewritten following the
12122      * paradigm of this example, where the <multi-fold>s are characters which
12123      * fold to multiple character sequences:
12124      *      /[abc\x{multi-fold1}def\x{multi-fold2}ghi]/i
12125      * gets effectively rewritten as:
12126      *      /(?:\x{multi-fold1}|\x{multi-fold2}|[abcdefghi]/i
12127      * reg() gets called (recursively) on the rewritten version, and this
12128      * function will return what it constructs.  (Actually the <multi-fold>s
12129      * aren't physically removed from the [abcdefghi], it's just that they are
12130      * ignored in the recursion by means of a flag:
12131      * <RExC_in_multi_char_class>.)
12132      *
12133      * ANYOF nodes contain a bit map for the first 256 characters, with the
12134      * corresponding bit set if that character is in the list.  For characters
12135      * above 255, a range list or swash is used.  There are extra bits for \w,
12136      * etc. in locale ANYOFs, as what these match is not determinable at
12137      * compile time
12138      *
12139      * Returns NULL, setting *flagp to RESTART_UTF8 if the sizing scan needs
12140      * to be restarted.  This can only happen if ret_invlist is non-NULL.
12141      */
12142
12143     dVAR;
12144     UV prevvalue = OOB_UNICODE, save_prevvalue = OOB_UNICODE;
12145     IV range = 0;
12146     UV value = OOB_UNICODE, save_value = OOB_UNICODE;
12147     regnode *ret;
12148     STRLEN numlen;
12149     IV namedclass = OOB_NAMEDCLASS;
12150     char *rangebegin = NULL;
12151     bool need_class = 0;
12152     SV *listsv = NULL;
12153     STRLEN initial_listsv_len = 0; /* Kind of a kludge to see if it is more
12154                                       than just initialized.  */
12155     SV* properties = NULL;    /* Code points that match \p{} \P{} */
12156     SV* posixes = NULL;     /* Code points that match classes like, [:word:],
12157                                extended beyond the Latin1 range */
12158     UV element_count = 0;   /* Number of distinct elements in the class.
12159                                Optimizations may be possible if this is tiny */
12160     AV * multi_char_matches = NULL; /* Code points that fold to more than one
12161                                        character; used under /i */
12162     UV n;
12163     char * stop_ptr = RExC_end;    /* where to stop parsing */
12164     const bool skip_white = cBOOL(ret_invlist); /* ignore unescaped white
12165                                                    space? */
12166     const bool strict = cBOOL(ret_invlist); /* Apply strict parsing rules? */
12167
12168     /* Unicode properties are stored in a swash; this holds the current one
12169      * being parsed.  If this swash is the only above-latin1 component of the
12170      * character class, an optimization is to pass it directly on to the
12171      * execution engine.  Otherwise, it is set to NULL to indicate that there
12172      * are other things in the class that have to be dealt with at execution
12173      * time */
12174     SV* swash = NULL;           /* Code points that match \p{} \P{} */
12175
12176     /* Set if a component of this character class is user-defined; just passed
12177      * on to the engine */
12178     bool has_user_defined_property = FALSE;
12179
12180     /* inversion list of code points this node matches only when the target
12181      * string is in UTF-8.  (Because is under /d) */
12182     SV* depends_list = NULL;
12183
12184     /* inversion list of code points this node matches.  For much of the
12185      * function, it includes only those that match regardless of the utf8ness
12186      * of the target string */
12187     SV* cp_list = NULL;
12188
12189 #ifdef EBCDIC
12190     /* In a range, counts how many 0-2 of the ends of it came from literals,
12191      * not escapes.  Thus we can tell if 'A' was input vs \x{C1} */
12192     UV literal_endpoint = 0;
12193 #endif
12194     bool invert = FALSE;    /* Is this class to be complemented */
12195
12196     /* Is there any thing like \W or [:^digit:] that matches above the legal
12197      * Unicode range? */
12198     bool runtime_posix_matches_above_Unicode = FALSE;
12199
12200     regnode * const orig_emit = RExC_emit; /* Save the original RExC_emit in
12201         case we need to change the emitted regop to an EXACT. */
12202     const char * orig_parse = RExC_parse;
12203     const I32 orig_size = RExC_size;
12204     GET_RE_DEBUG_FLAGS_DECL;
12205
12206     PERL_ARGS_ASSERT_REGCLASS;
12207 #ifndef DEBUGGING
12208     PERL_UNUSED_ARG(depth);
12209 #endif
12210
12211     DEBUG_PARSE("clas");
12212
12213     /* Assume we are going to generate an ANYOF node. */
12214     ret = reganode(pRExC_state, ANYOF, 0);
12215
12216     if (SIZE_ONLY) {
12217         RExC_size += ANYOF_SKIP;
12218         listsv = &PL_sv_undef; /* For code scanners: listsv always non-NULL. */
12219     }
12220     else {
12221         ANYOF_FLAGS(ret) = 0;
12222
12223         RExC_emit += ANYOF_SKIP;
12224         if (LOC) {
12225             ANYOF_FLAGS(ret) |= ANYOF_LOCALE;
12226         }
12227         listsv = newSVpvs_flags("# comment\n", SVs_TEMP);
12228         initial_listsv_len = SvCUR(listsv);
12229         SvTEMP_off(listsv); /* Grr, TEMPs and mortals are conflated.  */
12230     }
12231
12232     if (skip_white) {
12233         RExC_parse = regpatws(pRExC_state, RExC_parse,
12234                               FALSE /* means don't recognize comments */);
12235     }
12236
12237     if (UCHARAT(RExC_parse) == '^') {   /* Complement of range. */
12238         RExC_parse++;
12239         invert = TRUE;
12240         allow_multi_folds = FALSE;
12241         RExC_naughty++;
12242         if (skip_white) {
12243             RExC_parse = regpatws(pRExC_state, RExC_parse,
12244                                   FALSE /* means don't recognize comments */);
12245         }
12246     }
12247
12248     /* Check that they didn't say [:posix:] instead of [[:posix:]] */
12249     if (!SIZE_ONLY && RExC_parse < RExC_end && POSIXCC(UCHARAT(RExC_parse))) {
12250         const char *s = RExC_parse;
12251         const char  c = *s++;
12252
12253         while (isWORDCHAR(*s))
12254             s++;
12255         if (*s && c == *s && s[1] == ']') {
12256             SAVEFREESV(RExC_rx_sv);
12257             ckWARN3reg(s+2,
12258                        "POSIX syntax [%c %c] belongs inside character classes",
12259                        c, c);
12260             (void)ReREFCNT_inc(RExC_rx_sv);
12261         }
12262     }
12263
12264     /* If the caller wants us to just parse a single element, accomplish this
12265      * by faking the loop ending condition */
12266     if (stop_at_1 && RExC_end > RExC_parse) {
12267         stop_ptr = RExC_parse + 1;
12268     }
12269
12270     /* allow 1st char to be ']' (allowing it to be '-' is dealt with later) */
12271     if (UCHARAT(RExC_parse) == ']')
12272         goto charclassloop;
12273
12274 parseit:
12275     while (1) {
12276         if  (RExC_parse >= stop_ptr) {
12277             break;
12278         }
12279
12280         if (skip_white) {
12281             RExC_parse = regpatws(pRExC_state, RExC_parse,
12282                                   FALSE /* means don't recognize comments */);
12283         }
12284
12285         if  (UCHARAT(RExC_parse) == ']') {
12286             break;
12287         }
12288
12289     charclassloop:
12290
12291         namedclass = OOB_NAMEDCLASS; /* initialize as illegal */
12292         save_value = value;
12293         save_prevvalue = prevvalue;
12294
12295         if (!range) {
12296             rangebegin = RExC_parse;
12297             element_count++;
12298         }
12299         if (UTF) {
12300             value = utf8n_to_uvchr((U8*)RExC_parse,
12301                                    RExC_end - RExC_parse,
12302                                    &numlen, UTF8_ALLOW_DEFAULT);
12303             RExC_parse += numlen;
12304         }
12305         else
12306             value = UCHARAT(RExC_parse++);
12307
12308         if (value == '['
12309             && RExC_parse < RExC_end
12310             && POSIXCC(UCHARAT(RExC_parse)))
12311         {
12312             namedclass = regpposixcc(pRExC_state, value, strict);
12313         }
12314         else if (value == '\\') {
12315             if (UTF) {
12316                 value = utf8n_to_uvchr((U8*)RExC_parse,
12317                                    RExC_end - RExC_parse,
12318                                    &numlen, UTF8_ALLOW_DEFAULT);
12319                 RExC_parse += numlen;
12320             }
12321             else
12322                 value = UCHARAT(RExC_parse++);
12323
12324             /* Some compilers cannot handle switching on 64-bit integer
12325              * values, therefore value cannot be an UV.  Yes, this will
12326              * be a problem later if we want switch on Unicode.
12327              * A similar issue a little bit later when switching on
12328              * namedclass. --jhi */
12329
12330             /* If the \ is escaping white space when white space is being
12331              * skipped, it means that that white space is wanted literally, and
12332              * is already in 'value'.  Otherwise, need to translate the escape
12333              * into what it signifies. */
12334             if (! skip_white || ! is_PATWS_cp(value)) switch ((I32)value) {
12335
12336             case 'w':   namedclass = ANYOF_WORDCHAR;    break;
12337             case 'W':   namedclass = ANYOF_NWORDCHAR;   break;
12338             case 's':   namedclass = ANYOF_SPACE;       break;
12339             case 'S':   namedclass = ANYOF_NSPACE;      break;
12340             case 'd':   namedclass = ANYOF_DIGIT;       break;
12341             case 'D':   namedclass = ANYOF_NDIGIT;      break;
12342             case 'v':   namedclass = ANYOF_VERTWS;      break;
12343             case 'V':   namedclass = ANYOF_NVERTWS;     break;
12344             case 'h':   namedclass = ANYOF_HORIZWS;     break;
12345             case 'H':   namedclass = ANYOF_NHORIZWS;    break;
12346             case 'N':  /* Handle \N{NAME} in class */
12347                 {
12348                     /* We only pay attention to the first char of 
12349                     multichar strings being returned. I kinda wonder
12350                     if this makes sense as it does change the behaviour
12351                     from earlier versions, OTOH that behaviour was broken
12352                     as well. */
12353                     if (! grok_bslash_N(pRExC_state, NULL, &value, flagp, depth,
12354                                       TRUE, /* => charclass */
12355                                       strict))
12356                     {
12357                         if (*flagp & RESTART_UTF8)
12358                             FAIL("panic: grok_bslash_N set RESTART_UTF8");
12359                         goto parseit;
12360                     }
12361                 }
12362                 break;
12363             case 'p':
12364             case 'P':
12365                 {
12366                 char *e;
12367
12368                 /* We will handle any undefined properties ourselves */
12369                 U8 swash_init_flags = _CORE_SWASH_INIT_RETURN_IF_UNDEF;
12370
12371                 if (RExC_parse >= RExC_end)
12372                     vFAIL2("Empty \\%c{}", (U8)value);
12373                 if (*RExC_parse == '{') {
12374                     const U8 c = (U8)value;
12375                     e = strchr(RExC_parse++, '}');
12376                     if (!e)
12377                         vFAIL2("Missing right brace on \\%c{}", c);
12378                     while (isSPACE(UCHARAT(RExC_parse)))
12379                         RExC_parse++;
12380                     if (e == RExC_parse)
12381                         vFAIL2("Empty \\%c{}", c);
12382                     n = e - RExC_parse;
12383                     while (isSPACE(UCHARAT(RExC_parse + n - 1)))
12384                         n--;
12385                 }
12386                 else {
12387                     e = RExC_parse;
12388                     n = 1;
12389                 }
12390                 if (!SIZE_ONLY) {
12391                     SV* invlist;
12392                     char* name;
12393
12394                     if (UCHARAT(RExC_parse) == '^') {
12395                          RExC_parse++;
12396                          n--;
12397                          /* toggle.  (The rhs xor gets the single bit that
12398                           * differs between P and p; the other xor inverts just
12399                           * that bit) */
12400                          value ^= 'P' ^ 'p';
12401
12402                          while (isSPACE(UCHARAT(RExC_parse))) {
12403                               RExC_parse++;
12404                               n--;
12405                          }
12406                     }
12407                     /* Try to get the definition of the property into
12408                      * <invlist>.  If /i is in effect, the effective property
12409                      * will have its name be <__NAME_i>.  The design is
12410                      * discussed in commit
12411                      * 2f833f5208e26b208886e51e09e2c072b5eabb46 */
12412                     Newx(name, n + sizeof("_i__\n"), char);
12413
12414                     sprintf(name, "%s%.*s%s\n",
12415                                     (FOLD) ? "__" : "",
12416                                     (int)n,
12417                                     RExC_parse,
12418                                     (FOLD) ? "_i" : ""
12419                     );
12420
12421                     /* Look up the property name, and get its swash and
12422                      * inversion list, if the property is found  */
12423                     if (swash) {
12424                         SvREFCNT_dec_NN(swash);
12425                     }
12426                     swash = _core_swash_init("utf8", name, &PL_sv_undef,
12427                                              1, /* binary */
12428                                              0, /* not tr/// */
12429                                              NULL, /* No inversion list */
12430                                              &swash_init_flags
12431                                             );
12432                     if (! swash || ! (invlist = _get_swash_invlist(swash))) {
12433                         if (swash) {
12434                             SvREFCNT_dec_NN(swash);
12435                             swash = NULL;
12436                         }
12437
12438                         /* Here didn't find it.  It could be a user-defined
12439                          * property that will be available at run-time.  If we
12440                          * accept only compile-time properties, is an error;
12441                          * otherwise add it to the list for run-time look up */
12442                         if (ret_invlist) {
12443                             RExC_parse = e + 1;
12444                             vFAIL3("Property '%.*s' is unknown", (int) n, name);
12445                         }
12446                         Perl_sv_catpvf(aTHX_ listsv, "%cutf8::%s\n",
12447                                         (value == 'p' ? '+' : '!'),
12448                                         name);
12449                         has_user_defined_property = TRUE;
12450
12451                         /* We don't know yet, so have to assume that the
12452                          * property could match something in the Latin1 range,
12453                          * hence something that isn't utf8.  Note that this
12454                          * would cause things in <depends_list> to match
12455                          * inappropriately, except that any \p{}, including
12456                          * this one forces Unicode semantics, which means there
12457                          * is <no depends_list> */
12458                         ANYOF_FLAGS(ret) |= ANYOF_NONBITMAP_NON_UTF8;
12459                     }
12460                     else {
12461
12462                         /* Here, did get the swash and its inversion list.  If
12463                          * the swash is from a user-defined property, then this
12464                          * whole character class should be regarded as such */
12465                         has_user_defined_property =
12466                                     (swash_init_flags
12467                                      & _CORE_SWASH_INIT_USER_DEFINED_PROPERTY);
12468
12469                         /* Invert if asking for the complement */
12470                         if (value == 'P') {
12471                             _invlist_union_complement_2nd(properties,
12472                                                           invlist,
12473                                                           &properties);
12474
12475                             /* The swash can't be used as-is, because we've
12476                              * inverted things; delay removing it to here after
12477                              * have copied its invlist above */
12478                             SvREFCNT_dec_NN(swash);
12479                             swash = NULL;
12480                         }
12481                         else {
12482                             _invlist_union(properties, invlist, &properties);
12483                         }
12484                     }
12485                     Safefree(name);
12486                 }
12487                 RExC_parse = e + 1;
12488                 namedclass = ANYOF_UNIPROP;  /* no official name, but it's
12489                                                 named */
12490
12491                 /* \p means they want Unicode semantics */
12492                 RExC_uni_semantics = 1;
12493                 }
12494                 break;
12495             case 'n':   value = '\n';                   break;
12496             case 'r':   value = '\r';                   break;
12497             case 't':   value = '\t';                   break;
12498             case 'f':   value = '\f';                   break;
12499             case 'b':   value = '\b';                   break;
12500             case 'e':   value = ASCII_TO_NATIVE('\033');break;
12501             case 'a':   value = ASCII_TO_NATIVE('\007');break;
12502             case 'o':
12503                 RExC_parse--;   /* function expects to be pointed at the 'o' */
12504                 {
12505                     const char* error_msg;
12506                     bool valid = grok_bslash_o(&RExC_parse,
12507                                                &value,
12508                                                &error_msg,
12509                                                SIZE_ONLY,   /* warnings in pass
12510                                                                1 only */
12511                                                strict,
12512                                                silence_non_portable,
12513                                                UTF);
12514                     if (! valid) {
12515                         vFAIL(error_msg);
12516                     }
12517                 }
12518                 if (PL_encoding && value < 0x100) {
12519                     goto recode_encoding;
12520                 }
12521                 break;
12522             case 'x':
12523                 RExC_parse--;   /* function expects to be pointed at the 'x' */
12524                 {
12525                     const char* error_msg;
12526                     bool valid = grok_bslash_x(&RExC_parse,
12527                                                &value,
12528                                                &error_msg,
12529                                                TRUE, /* Output warnings */
12530                                                strict,
12531                                                silence_non_portable,
12532                                                UTF);
12533                     if (! valid) {
12534                         vFAIL(error_msg);
12535                     }
12536                 }
12537                 if (PL_encoding && value < 0x100)
12538                     goto recode_encoding;
12539                 break;
12540             case 'c':
12541                 value = grok_bslash_c(*RExC_parse++, UTF, SIZE_ONLY);
12542                 break;
12543             case '0': case '1': case '2': case '3': case '4':
12544             case '5': case '6': case '7':
12545                 {
12546                     /* Take 1-3 octal digits */
12547                     I32 flags = PERL_SCAN_SILENT_ILLDIGIT;
12548                     numlen = (strict) ? 4 : 3;
12549                     value = grok_oct(--RExC_parse, &numlen, &flags, NULL);
12550                     RExC_parse += numlen;
12551                     if (numlen != 3) {
12552                         if (strict) {
12553                             RExC_parse += (UTF) ? UTF8SKIP(RExC_parse) : 1;
12554                             vFAIL("Need exactly 3 octal digits");
12555                         }
12556                         else if (! SIZE_ONLY /* like \08, \178 */
12557                                  && numlen < 3
12558                                  && RExC_parse < RExC_end
12559                                  && isDIGIT(*RExC_parse)
12560                                  && ckWARN(WARN_REGEXP))
12561                         {
12562                             SAVEFREESV(RExC_rx_sv);
12563                             reg_warn_non_literal_string(
12564                                  RExC_parse + 1,
12565                                  form_short_octal_warning(RExC_parse, numlen));
12566                             (void)ReREFCNT_inc(RExC_rx_sv);
12567                         }
12568                     }
12569                     if (PL_encoding && value < 0x100)
12570                         goto recode_encoding;
12571                     break;
12572                 }
12573             recode_encoding:
12574                 if (! RExC_override_recoding) {
12575                     SV* enc = PL_encoding;
12576                     value = reg_recode((const char)(U8)value, &enc);
12577                     if (!enc) {
12578                         if (strict) {
12579                             vFAIL("Invalid escape in the specified encoding");
12580                         }
12581                         else if (SIZE_ONLY) {
12582                             ckWARNreg(RExC_parse,
12583                                   "Invalid escape in the specified encoding");
12584                         }
12585                     }
12586                     break;
12587                 }
12588             default:
12589                 /* Allow \_ to not give an error */
12590                 if (!SIZE_ONLY && isWORDCHAR(value) && value != '_') {
12591                     if (strict) {
12592                         vFAIL2("Unrecognized escape \\%c in character class",
12593                                (int)value);
12594                     }
12595                     else {
12596                         SAVEFREESV(RExC_rx_sv);
12597                         ckWARN2reg(RExC_parse,
12598                             "Unrecognized escape \\%c in character class passed through",
12599                             (int)value);
12600                         (void)ReREFCNT_inc(RExC_rx_sv);
12601                     }
12602                 }
12603                 break;
12604             }   /* End of switch on char following backslash */
12605         } /* end of handling backslash escape sequences */
12606 #ifdef EBCDIC
12607         else
12608             literal_endpoint++;
12609 #endif
12610
12611         /* Here, we have the current token in 'value' */
12612
12613         /* What matches in a locale is not known until runtime.  This includes
12614          * what the Posix classes (like \w, [:space:]) match.  Room must be
12615          * reserved (one time per class) to store such classes, either if Perl
12616          * is compiled so that locale nodes always should have this space, or
12617          * if there is such class info to be stored.  The space will contain a
12618          * bit for each named class that is to be matched against.  This isn't
12619          * needed for \p{} and pseudo-classes, as they are not affected by
12620          * locale, and hence are dealt with separately */
12621         if (LOC
12622             && ! need_class
12623             && (ANYOF_LOCALE == ANYOF_CLASS
12624                 || (namedclass > OOB_NAMEDCLASS && namedclass < ANYOF_MAX)))
12625         {
12626             need_class = 1;
12627             if (SIZE_ONLY) {
12628                 RExC_size += ANYOF_CLASS_SKIP - ANYOF_SKIP;
12629             }
12630             else {
12631                 RExC_emit += ANYOF_CLASS_SKIP - ANYOF_SKIP;
12632                 ANYOF_CLASS_ZERO(ret);
12633             }
12634             ANYOF_FLAGS(ret) |= ANYOF_CLASS;
12635         }
12636
12637         if (namedclass > OOB_NAMEDCLASS) { /* this is a named class \blah */
12638
12639             /* a bad range like a-\d, a-[:digit:].  The '-' is taken as a
12640              * literal, as is the character that began the false range, i.e.
12641              * the 'a' in the examples */
12642             if (range) {
12643                 if (!SIZE_ONLY) {
12644                     const int w = (RExC_parse >= rangebegin)
12645                                   ? RExC_parse - rangebegin
12646                                   : 0;
12647                     if (strict) {
12648                         vFAIL4("False [] range \"%*.*s\"", w, w, rangebegin);
12649                     }
12650                     else {
12651                         SAVEFREESV(RExC_rx_sv); /* in case of fatal warnings */
12652                         ckWARN4reg(RExC_parse,
12653                                 "False [] range \"%*.*s\"",
12654                                 w, w, rangebegin);
12655                         (void)ReREFCNT_inc(RExC_rx_sv);
12656                         cp_list = add_cp_to_invlist(cp_list, '-');
12657                         cp_list = add_cp_to_invlist(cp_list, prevvalue);
12658                     }
12659                 }
12660
12661                 range = 0; /* this was not a true range */
12662                 element_count += 2; /* So counts for three values */
12663             }
12664
12665             if (! SIZE_ONLY) {
12666                 U8 classnum = namedclass_to_classnum(namedclass);
12667                 if (namedclass >= ANYOF_MAX) {  /* If a special class */
12668                     if (namedclass != ANYOF_UNIPROP) { /* UNIPROP = \p and \P */
12669
12670                         /* Here, should be \h, \H, \v, or \V.  Neither /d nor
12671                          * /l make a difference in what these match.  There
12672                          * would be problems if these characters had folds
12673                          * other than themselves, as cp_list is subject to
12674                          * folding. */
12675                         if (classnum != _CC_VERTSPACE) {
12676                             assert(   namedclass == ANYOF_HORIZWS
12677                                    || namedclass == ANYOF_NHORIZWS);
12678
12679                             /* It turns out that \h is just a synonym for
12680                              * XPosixBlank */
12681                             classnum = _CC_BLANK;
12682                         }
12683
12684                         _invlist_union_maybe_complement_2nd(
12685                                 cp_list,
12686                                 PL_XPosix_ptrs[classnum],
12687                                 cBOOL(namedclass % 2), /* Complement if odd
12688                                                           (NHORIZWS, NVERTWS)
12689                                                         */
12690                                 &cp_list);
12691                     }
12692                 }
12693                 else if (classnum == _CC_ASCII) {
12694 #ifdef HAS_ISASCII
12695                     if (LOC) {
12696                         ANYOF_CLASS_SET(ret, namedclass);
12697                     }
12698                     else
12699 #endif  /* Not isascii(); just use the hard-coded definition for it */
12700                         _invlist_union_maybe_complement_2nd(
12701                                 posixes,
12702                                 PL_ASCII,
12703                                 cBOOL(namedclass % 2), /* Complement if odd
12704                                                           (NASCII) */
12705                                 &posixes);
12706                 }
12707                 else {  /* Garden variety class */
12708
12709                     /* The ascii range inversion list */
12710                     SV* ascii_source = PL_Posix_ptrs[classnum];
12711
12712                     /* The full Latin1 range inversion list */
12713                     SV* l1_source = PL_L1Posix_ptrs[classnum];
12714
12715                     /* This code is structured into two major clauses.  The
12716                      * first is for classes whose complete definitions may not
12717                      * already be known.  It not, the Latin1 definition
12718                      * (guaranteed to already known) is used plus code is
12719                      * generated to load the rest at run-time (only if needed).
12720                      * If the complete definition is known, it drops down to
12721                      * the second clause, where the complete definition is
12722                      * known */
12723
12724                     if (classnum < _FIRST_NON_SWASH_CC) {
12725
12726                         /* Here, the class has a swash, which may or not
12727                          * already be loaded */
12728
12729                         /* The name of the property to use to match the full
12730                          * eXtended Unicode range swash for this character
12731                          * class */
12732                         const char *Xname = swash_property_names[classnum];
12733
12734                         /* If returning the inversion list, we can't defer
12735                          * getting this until runtime */
12736                         if (ret_invlist && !  PL_utf8_swash_ptrs[classnum]) {
12737                             PL_utf8_swash_ptrs[classnum] =
12738                                 _core_swash_init("utf8", Xname, &PL_sv_undef,
12739                                              1, /* binary */
12740                                              0, /* not tr/// */
12741                                              NULL, /* No inversion list */
12742                                              NULL  /* No flags */
12743                                             );
12744                             assert(PL_utf8_swash_ptrs[classnum]);
12745                         }
12746                         if ( !  PL_utf8_swash_ptrs[classnum]) {
12747                             if (namedclass % 2 == 0) { /* A non-complemented
12748                                                           class */
12749                                 /* If not /a matching, there are code points we
12750                                  * don't know at compile time.  Arrange for the
12751                                  * unknown matches to be loaded at run-time, if
12752                                  * needed */
12753                                 if (! AT_LEAST_ASCII_RESTRICTED) {
12754                                     Perl_sv_catpvf(aTHX_ listsv, "+utf8::%s\n",
12755                                                                  Xname);
12756                                 }
12757                                 if (LOC) {  /* Under locale, set run-time
12758                                                lookup */
12759                                     ANYOF_CLASS_SET(ret, namedclass);
12760                                 }
12761                                 else {
12762                                     /* Add the current class's code points to
12763                                      * the running total */
12764                                     _invlist_union(posixes,
12765                                                    (AT_LEAST_ASCII_RESTRICTED)
12766                                                         ? ascii_source
12767                                                         : l1_source,
12768                                                    &posixes);
12769                                 }
12770                             }
12771                             else {  /* A complemented class */
12772                                 if (AT_LEAST_ASCII_RESTRICTED) {
12773                                     /* Under /a should match everything above
12774                                      * ASCII, plus the complement of the set's
12775                                      * ASCII matches */
12776                                     _invlist_union_complement_2nd(posixes,
12777                                                                   ascii_source,
12778                                                                   &posixes);
12779                                 }
12780                                 else {
12781                                     /* Arrange for the unknown matches to be
12782                                      * loaded at run-time, if needed */
12783                                     Perl_sv_catpvf(aTHX_ listsv, "!utf8::%s\n",
12784                                                                  Xname);
12785                                     runtime_posix_matches_above_Unicode = TRUE;
12786                                     if (LOC) {
12787                                         ANYOF_CLASS_SET(ret, namedclass);
12788                                     }
12789                                     else {
12790
12791                                         /* We want to match everything in
12792                                          * Latin1, except those things that
12793                                          * l1_source matches */
12794                                         SV* scratch_list = NULL;
12795                                         _invlist_subtract(PL_Latin1, l1_source,
12796                                                           &scratch_list);
12797
12798                                         /* Add the list from this class to the
12799                                          * running total */
12800                                         if (! posixes) {
12801                                             posixes = scratch_list;
12802                                         }
12803                                         else {
12804                                             _invlist_union(posixes,
12805                                                            scratch_list,
12806                                                            &posixes);
12807                                             SvREFCNT_dec_NN(scratch_list);
12808                                         }
12809                                         if (DEPENDS_SEMANTICS) {
12810                                             ANYOF_FLAGS(ret)
12811                                                   |= ANYOF_NON_UTF8_LATIN1_ALL;
12812                                         }
12813                                     }
12814                                 }
12815                             }
12816                             goto namedclass_done;
12817                         }
12818
12819                         /* Here, there is a swash loaded for the class.  If no
12820                          * inversion list for it yet, get it */
12821                         if (! PL_XPosix_ptrs[classnum]) {
12822                             PL_XPosix_ptrs[classnum]
12823                              = _swash_to_invlist(PL_utf8_swash_ptrs[classnum]);
12824                         }
12825                     }
12826
12827                     /* Here there is an inversion list already loaded for the
12828                      * entire class */
12829
12830                     if (namedclass % 2 == 0) {  /* A non-complemented class,
12831                                                    like ANYOF_PUNCT */
12832                         if (! LOC) {
12833                             /* For non-locale, just add it to any existing list
12834                              * */
12835                             _invlist_union(posixes,
12836                                            (AT_LEAST_ASCII_RESTRICTED)
12837                                                ? ascii_source
12838                                                : PL_XPosix_ptrs[classnum],
12839                                            &posixes);
12840                         }
12841                         else {  /* Locale */
12842                             SV* scratch_list = NULL;
12843
12844                             /* For above Latin1 code points, we use the full
12845                              * Unicode range */
12846                             _invlist_intersection(PL_AboveLatin1,
12847                                                   PL_XPosix_ptrs[classnum],
12848                                                   &scratch_list);
12849                             /* And set the output to it, adding instead if
12850                              * there already is an output.  Checking if
12851                              * 'posixes' is NULL first saves an extra clone.
12852                              * Its reference count will be decremented at the
12853                              * next union, etc, or if this is the only
12854                              * instance, at the end of the routine */
12855                             if (! posixes) {
12856                                 posixes = scratch_list;
12857                             }
12858                             else {
12859                                 _invlist_union(posixes, scratch_list, &posixes);
12860                                 SvREFCNT_dec_NN(scratch_list);
12861                             }
12862
12863 #ifndef HAS_ISBLANK
12864                             if (namedclass != ANYOF_BLANK) {
12865 #endif
12866                                 /* Set this class in the node for runtime
12867                                  * matching */
12868                                 ANYOF_CLASS_SET(ret, namedclass);
12869 #ifndef HAS_ISBLANK
12870                             }
12871                             else {
12872                                 /* No isblank(), use the hard-coded ASCII-range
12873                                  * blanks, adding them to the running total. */
12874
12875                                 _invlist_union(posixes, ascii_source, &posixes);
12876                             }
12877 #endif
12878                         }
12879                     }
12880                     else {  /* A complemented class, like ANYOF_NPUNCT */
12881                         if (! LOC) {
12882                             _invlist_union_complement_2nd(
12883                                                 posixes,
12884                                                 (AT_LEAST_ASCII_RESTRICTED)
12885                                                     ? ascii_source
12886                                                     : PL_XPosix_ptrs[classnum],
12887                                                 &posixes);
12888                             /* Under /d, everything in the upper half of the
12889                              * Latin1 range matches this complement */
12890                             if (DEPENDS_SEMANTICS) {
12891                                 ANYOF_FLAGS(ret) |= ANYOF_NON_UTF8_LATIN1_ALL;
12892                             }
12893                         }
12894                         else {  /* Locale */
12895                             SV* scratch_list = NULL;
12896                             _invlist_subtract(PL_AboveLatin1,
12897                                               PL_XPosix_ptrs[classnum],
12898                                               &scratch_list);
12899                             if (! posixes) {
12900                                 posixes = scratch_list;
12901                             }
12902                             else {
12903                                 _invlist_union(posixes, scratch_list, &posixes);
12904                                 SvREFCNT_dec_NN(scratch_list);
12905                             }
12906 #ifndef HAS_ISBLANK
12907                             if (namedclass != ANYOF_NBLANK) {
12908 #endif
12909                                 ANYOF_CLASS_SET(ret, namedclass);
12910 #ifndef HAS_ISBLANK
12911                             }
12912                             else {
12913                                 /* Get the list of all code points in Latin1
12914                                  * that are not ASCII blanks, and add them to
12915                                  * the running total */
12916                                 _invlist_subtract(PL_Latin1, ascii_source,
12917                                                   &scratch_list);
12918                                 _invlist_union(posixes, scratch_list, &posixes);
12919                                 SvREFCNT_dec_NN(scratch_list);
12920                             }
12921 #endif
12922                         }
12923                     }
12924                 }
12925               namedclass_done:
12926                 continue;   /* Go get next character */
12927             }
12928         } /* end of namedclass \blah */
12929
12930         /* Here, we have a single value.  If 'range' is set, it is the ending
12931          * of a range--check its validity.  Later, we will handle each
12932          * individual code point in the range.  If 'range' isn't set, this
12933          * could be the beginning of a range, so check for that by looking
12934          * ahead to see if the next real character to be processed is the range
12935          * indicator--the minus sign */
12936
12937         if (skip_white) {
12938             RExC_parse = regpatws(pRExC_state, RExC_parse,
12939                                 FALSE /* means don't recognize comments */);
12940         }
12941
12942         if (range) {
12943             if (prevvalue > value) /* b-a */ {
12944                 const int w = RExC_parse - rangebegin;
12945                 Simple_vFAIL4("Invalid [] range \"%*.*s\"", w, w, rangebegin);
12946                 range = 0; /* not a valid range */
12947             }
12948         }
12949         else {
12950             prevvalue = value; /* save the beginning of the potential range */
12951             if (! stop_at_1     /* Can't be a range if parsing just one thing */
12952                 && *RExC_parse == '-')
12953             {
12954                 char* next_char_ptr = RExC_parse + 1;
12955                 if (skip_white) {   /* Get the next real char after the '-' */
12956                     next_char_ptr = regpatws(pRExC_state,
12957                                              RExC_parse + 1,
12958                                              FALSE); /* means don't recognize
12959                                                         comments */
12960                 }
12961
12962                 /* If the '-' is at the end of the class (just before the ']',
12963                  * it is a literal minus; otherwise it is a range */
12964                 if (next_char_ptr < RExC_end && *next_char_ptr != ']') {
12965                     RExC_parse = next_char_ptr;
12966
12967                     /* a bad range like \w-, [:word:]- ? */
12968                     if (namedclass > OOB_NAMEDCLASS) {
12969                         if (strict || ckWARN(WARN_REGEXP)) {
12970                             const int w =
12971                                 RExC_parse >= rangebegin ?
12972                                 RExC_parse - rangebegin : 0;
12973                             if (strict) {
12974                                 vFAIL4("False [] range \"%*.*s\"",
12975                                     w, w, rangebegin);
12976                             }
12977                             else {
12978                                 vWARN4(RExC_parse,
12979                                     "False [] range \"%*.*s\"",
12980                                     w, w, rangebegin);
12981                             }
12982                         }
12983                         if (!SIZE_ONLY) {
12984                             cp_list = add_cp_to_invlist(cp_list, '-');
12985                         }
12986                         element_count++;
12987                     } else
12988                         range = 1;      /* yeah, it's a range! */
12989                     continue;   /* but do it the next time */
12990                 }
12991             }
12992         }
12993
12994         /* Here, <prevvalue> is the beginning of the range, if any; or <value>
12995          * if not */
12996
12997         /* non-Latin1 code point implies unicode semantics.  Must be set in
12998          * pass1 so is there for the whole of pass 2 */
12999         if (value > 255) {
13000             RExC_uni_semantics = 1;
13001         }
13002
13003         /* Ready to process either the single value, or the completed range.
13004          * For single-valued non-inverted ranges, we consider the possibility
13005          * of multi-char folds.  (We made a conscious decision to not do this
13006          * for the other cases because it can often lead to non-intuitive
13007          * results.  For example, you have the peculiar case that:
13008          *  "s s" =~ /^[^\xDF]+$/i => Y
13009          *  "ss"  =~ /^[^\xDF]+$/i => N
13010          *
13011          * See [perl #89750] */
13012         if (FOLD && allow_multi_folds && value == prevvalue) {
13013             if (value == LATIN_SMALL_LETTER_SHARP_S
13014                 || (value > 255 && _invlist_contains_cp(PL_HasMultiCharFold,
13015                                                         value)))
13016             {
13017                 /* Here <value> is indeed a multi-char fold.  Get what it is */
13018
13019                 U8 foldbuf[UTF8_MAXBYTES_CASE];
13020                 STRLEN foldlen;
13021
13022                 UV folded = _to_uni_fold_flags(
13023                                 value,
13024                                 foldbuf,
13025                                 &foldlen,
13026                                 FOLD_FLAGS_FULL
13027                                 | ((LOC) ?  FOLD_FLAGS_LOCALE
13028                                             : (ASCII_FOLD_RESTRICTED)
13029                                               ? FOLD_FLAGS_NOMIX_ASCII
13030                                               : 0)
13031                                 );
13032
13033                 /* Here, <folded> should be the first character of the
13034                  * multi-char fold of <value>, with <foldbuf> containing the
13035                  * whole thing.  But, if this fold is not allowed (because of
13036                  * the flags), <fold> will be the same as <value>, and should
13037                  * be processed like any other character, so skip the special
13038                  * handling */
13039                 if (folded != value) {
13040
13041                     /* Skip if we are recursed, currently parsing the class
13042                      * again.  Otherwise add this character to the list of
13043                      * multi-char folds. */
13044                     if (! RExC_in_multi_char_class) {
13045                         AV** this_array_ptr;
13046                         AV* this_array;
13047                         STRLEN cp_count = utf8_length(foldbuf,
13048                                                       foldbuf + foldlen);
13049                         SV* multi_fold = sv_2mortal(newSVpvn("", 0));
13050
13051                         Perl_sv_catpvf(aTHX_ multi_fold, "\\x{%"UVXf"}", value);
13052
13053
13054                         if (! multi_char_matches) {
13055                             multi_char_matches = newAV();
13056                         }
13057
13058                         /* <multi_char_matches> is actually an array of arrays.
13059                          * There will be one or two top-level elements: [2],
13060                          * and/or [3].  The [2] element is an array, each
13061                          * element thereof is a character which folds to TWO
13062                          * characters; [3] is for folds to THREE characters.
13063                          * (Unicode guarantees a maximum of 3 characters in any
13064                          * fold.)  When we rewrite the character class below,
13065                          * we will do so such that the longest folds are
13066                          * written first, so that it prefers the longest
13067                          * matching strings first.  This is done even if it
13068                          * turns out that any quantifier is non-greedy, out of
13069                          * programmer laziness.  Tom Christiansen has agreed
13070                          * that this is ok.  This makes the test for the
13071                          * ligature 'ffi' come before the test for 'ff' */
13072                         if (av_exists(multi_char_matches, cp_count)) {
13073                             this_array_ptr = (AV**) av_fetch(multi_char_matches,
13074                                                              cp_count, FALSE);
13075                             this_array = *this_array_ptr;
13076                         }
13077                         else {
13078                             this_array = newAV();
13079                             av_store(multi_char_matches, cp_count,
13080                                      (SV*) this_array);
13081                         }
13082                         av_push(this_array, multi_fold);
13083                     }
13084
13085                     /* This element should not be processed further in this
13086                      * class */
13087                     element_count--;
13088                     value = save_value;
13089                     prevvalue = save_prevvalue;
13090                     continue;
13091                 }
13092             }
13093         }
13094
13095         /* Deal with this element of the class */
13096         if (! SIZE_ONLY) {
13097 #ifndef EBCDIC
13098             cp_list = _add_range_to_invlist(cp_list, prevvalue, value);
13099 #else
13100             SV* this_range = _new_invlist(1);
13101             _append_range_to_invlist(this_range, prevvalue, value);
13102
13103             /* In EBCDIC, the ranges 'A-Z' and 'a-z' are each not contiguous.
13104              * If this range was specified using something like 'i-j', we want
13105              * to include only the 'i' and the 'j', and not anything in
13106              * between, so exclude non-ASCII, non-alphabetics from it.
13107              * However, if the range was specified with something like
13108              * [\x89-\x91] or [\x89-j], all code points within it should be
13109              * included.  literal_endpoint==2 means both ends of the range used
13110              * a literal character, not \x{foo} */
13111             if (literal_endpoint == 2
13112                 && (prevvalue >= 'a' && value <= 'z')
13113                     || (prevvalue >= 'A' && value <= 'Z'))
13114             {
13115                 _invlist_intersection(this_range, PL_Posix_ptrs[_CC_ALPHA],
13116                                       &this_range);
13117             }
13118             _invlist_union(cp_list, this_range, &cp_list);
13119             literal_endpoint = 0;
13120 #endif
13121         }
13122
13123         range = 0; /* this range (if it was one) is done now */
13124     } /* End of loop through all the text within the brackets */
13125
13126     /* If anything in the class expands to more than one character, we have to
13127      * deal with them by building up a substitute parse string, and recursively
13128      * calling reg() on it, instead of proceeding */
13129     if (multi_char_matches) {
13130         SV * substitute_parse = newSVpvn_flags("?:", 2, SVs_TEMP);
13131         I32 cp_count;
13132         STRLEN len;
13133         char *save_end = RExC_end;
13134         char *save_parse = RExC_parse;
13135         bool first_time = TRUE;     /* First multi-char occurrence doesn't get
13136                                        a "|" */
13137         I32 reg_flags;
13138
13139         assert(! invert);
13140 #if 0   /* Have decided not to deal with multi-char folds in inverted classes,
13141            because too confusing */
13142         if (invert) {
13143             sv_catpv(substitute_parse, "(?:");
13144         }
13145 #endif
13146
13147         /* Look at the longest folds first */
13148         for (cp_count = av_len(multi_char_matches); cp_count > 0; cp_count--) {
13149
13150             if (av_exists(multi_char_matches, cp_count)) {
13151                 AV** this_array_ptr;
13152                 SV* this_sequence;
13153
13154                 this_array_ptr = (AV**) av_fetch(multi_char_matches,
13155                                                  cp_count, FALSE);
13156                 while ((this_sequence = av_pop(*this_array_ptr)) !=
13157                                                                 &PL_sv_undef)
13158                 {
13159                     if (! first_time) {
13160                         sv_catpv(substitute_parse, "|");
13161                     }
13162                     first_time = FALSE;
13163
13164                     sv_catpv(substitute_parse, SvPVX(this_sequence));
13165                 }
13166             }
13167         }
13168
13169         /* If the character class contains anything else besides these
13170          * multi-character folds, have to include it in recursive parsing */
13171         if (element_count) {
13172             sv_catpv(substitute_parse, "|[");
13173             sv_catpvn(substitute_parse, orig_parse, RExC_parse - orig_parse);
13174             sv_catpv(substitute_parse, "]");
13175         }
13176
13177         sv_catpv(substitute_parse, ")");
13178 #if 0
13179         if (invert) {
13180             /* This is a way to get the parse to skip forward a whole named
13181              * sequence instead of matching the 2nd character when it fails the
13182              * first */
13183             sv_catpv(substitute_parse, "(*THEN)(*SKIP)(*FAIL)|.)");
13184         }
13185 #endif
13186
13187         RExC_parse = SvPV(substitute_parse, len);
13188         RExC_end = RExC_parse + len;
13189         RExC_in_multi_char_class = 1;
13190         RExC_emit = (regnode *)orig_emit;
13191
13192         ret = reg(pRExC_state, 1, &reg_flags, depth+1);
13193
13194         *flagp |= reg_flags&(HASWIDTH|SIMPLE|SPSTART|POSTPONED|RESTART_UTF8);
13195
13196         RExC_parse = save_parse;
13197         RExC_end = save_end;
13198         RExC_in_multi_char_class = 0;
13199         SvREFCNT_dec_NN(multi_char_matches);
13200         return ret;
13201     }
13202
13203     /* If the character class contains only a single element, it may be
13204      * optimizable into another node type which is smaller and runs faster.
13205      * Check if this is the case for this class */
13206     if (element_count == 1 && ! ret_invlist) {
13207         U8 op = END;
13208         U8 arg = 0;
13209
13210         if (namedclass > OOB_NAMEDCLASS) { /* this is a named class, like \w or
13211                                               [:digit:] or \p{foo} */
13212
13213             /* All named classes are mapped into POSIXish nodes, with its FLAG
13214              * argument giving which class it is */
13215             switch ((I32)namedclass) {
13216                 case ANYOF_UNIPROP:
13217                     break;
13218
13219                 /* These don't depend on the charset modifiers.  They always
13220                  * match under /u rules */
13221                 case ANYOF_NHORIZWS:
13222                 case ANYOF_HORIZWS:
13223                     namedclass = ANYOF_BLANK + namedclass - ANYOF_HORIZWS;
13224                     /* FALLTHROUGH */
13225
13226                 case ANYOF_NVERTWS:
13227                 case ANYOF_VERTWS:
13228                     op = POSIXU;
13229                     goto join_posix;
13230
13231                 /* The actual POSIXish node for all the rest depends on the
13232                  * charset modifier.  The ones in the first set depend only on
13233                  * ASCII or, if available on this platform, locale */
13234                 case ANYOF_ASCII:
13235                 case ANYOF_NASCII:
13236 #ifdef HAS_ISASCII
13237                     op = (LOC) ? POSIXL : POSIXA;
13238 #else
13239                     op = POSIXA;
13240 #endif
13241                     goto join_posix;
13242
13243                 case ANYOF_NCASED:
13244                 case ANYOF_LOWER:
13245                 case ANYOF_NLOWER:
13246                 case ANYOF_UPPER:
13247                 case ANYOF_NUPPER:
13248                     /* under /a could be alpha */
13249                     if (FOLD) {
13250                         if (ASCII_RESTRICTED) {
13251                             namedclass = ANYOF_ALPHA + (namedclass % 2);
13252                         }
13253                         else if (! LOC) {
13254                             break;
13255                         }
13256                     }
13257                     /* FALLTHROUGH */
13258
13259                 /* The rest have more possibilities depending on the charset.
13260                  * We take advantage of the enum ordering of the charset
13261                  * modifiers to get the exact node type, */
13262                 default:
13263                     op = POSIXD + get_regex_charset(RExC_flags);
13264                     if (op > POSIXA) { /* /aa is same as /a */
13265                         op = POSIXA;
13266                     }
13267 #ifndef HAS_ISBLANK
13268                     if (op == POSIXL
13269                         && (namedclass == ANYOF_BLANK
13270                             || namedclass == ANYOF_NBLANK))
13271                     {
13272                         op = POSIXA;
13273                     }
13274 #endif
13275
13276                 join_posix:
13277                     /* The odd numbered ones are the complements of the
13278                      * next-lower even number one */
13279                     if (namedclass % 2 == 1) {
13280                         invert = ! invert;
13281                         namedclass--;
13282                     }
13283                     arg = namedclass_to_classnum(namedclass);
13284                     break;
13285             }
13286         }
13287         else if (value == prevvalue) {
13288
13289             /* Here, the class consists of just a single code point */
13290
13291             if (invert) {
13292                 if (! LOC && value == '\n') {
13293                     op = REG_ANY; /* Optimize [^\n] */
13294                     *flagp |= HASWIDTH|SIMPLE;
13295                     RExC_naughty++;
13296                 }
13297             }
13298             else if (value < 256 || UTF) {
13299
13300                 /* Optimize a single value into an EXACTish node, but not if it
13301                  * would require converting the pattern to UTF-8. */
13302                 op = compute_EXACTish(pRExC_state);
13303             }
13304         } /* Otherwise is a range */
13305         else if (! LOC) {   /* locale could vary these */
13306             if (prevvalue == '0') {
13307                 if (value == '9') {
13308                     arg = _CC_DIGIT;
13309                     op = POSIXA;
13310                 }
13311             }
13312         }
13313
13314         /* Here, we have changed <op> away from its initial value iff we found
13315          * an optimization */
13316         if (op != END) {
13317
13318             /* Throw away this ANYOF regnode, and emit the calculated one,
13319              * which should correspond to the beginning, not current, state of
13320              * the parse */
13321             const char * cur_parse = RExC_parse;
13322             RExC_parse = (char *)orig_parse;
13323             if ( SIZE_ONLY) {
13324                 if (! LOC) {
13325
13326                     /* To get locale nodes to not use the full ANYOF size would
13327                      * require moving the code above that writes the portions
13328                      * of it that aren't in other nodes to after this point.
13329                      * e.g.  ANYOF_CLASS_SET */
13330                     RExC_size = orig_size;
13331                 }
13332             }
13333             else {
13334                 RExC_emit = (regnode *)orig_emit;
13335                 if (PL_regkind[op] == POSIXD) {
13336                     if (invert) {
13337                         op += NPOSIXD - POSIXD;
13338                     }
13339                 }
13340             }
13341
13342             ret = reg_node(pRExC_state, op);
13343
13344             if (PL_regkind[op] == POSIXD || PL_regkind[op] == NPOSIXD) {
13345                 if (! SIZE_ONLY) {
13346                     FLAGS(ret) = arg;
13347                 }
13348                 *flagp |= HASWIDTH|SIMPLE;
13349             }
13350             else if (PL_regkind[op] == EXACT) {
13351                 alloc_maybe_populate_EXACT(pRExC_state, ret, flagp, 0, value);
13352             }
13353
13354             RExC_parse = (char *) cur_parse;
13355
13356             SvREFCNT_dec(posixes);
13357             SvREFCNT_dec(cp_list);
13358             return ret;
13359         }
13360     }
13361
13362     if (SIZE_ONLY)
13363         return ret;
13364     /****** !SIZE_ONLY (Pass 2) AFTER HERE *********/
13365
13366     /* If folding, we calculate all characters that could fold to or from the
13367      * ones already on the list */
13368     if (FOLD && cp_list) {
13369         UV start, end;  /* End points of code point ranges */
13370
13371         SV* fold_intersection = NULL;
13372
13373         /* If the highest code point is within Latin1, we can use the
13374          * compiled-in Alphas list, and not have to go out to disk.  This
13375          * yields two false positives, the masculine and feminine ordinal
13376          * indicators, which are weeded out below using the
13377          * IS_IN_SOME_FOLD_L1() macro */
13378         if (invlist_highest(cp_list) < 256) {
13379             _invlist_intersection(PL_L1Posix_ptrs[_CC_ALPHA], cp_list,
13380                                                            &fold_intersection);
13381         }
13382         else {
13383
13384             /* Here, there are non-Latin1 code points, so we will have to go
13385              * fetch the list of all the characters that participate in folds
13386              */
13387             if (! PL_utf8_foldable) {
13388                 SV* swash = swash_init("utf8", "_Perl_Any_Folds",
13389                                        &PL_sv_undef, 1, 0);
13390                 PL_utf8_foldable = _get_swash_invlist(swash);
13391                 SvREFCNT_dec_NN(swash);
13392             }
13393
13394             /* This is a hash that for a particular fold gives all characters
13395              * that are involved in it */
13396             if (! PL_utf8_foldclosures) {
13397
13398                 /* If we were unable to find any folds, then we likely won't be
13399                  * able to find the closures.  So just create an empty list.
13400                  * Folding will effectively be restricted to the non-Unicode
13401                  * rules hard-coded into Perl.  (This case happens legitimately
13402                  * during compilation of Perl itself before the Unicode tables
13403                  * are generated) */
13404                 if (_invlist_len(PL_utf8_foldable) == 0) {
13405                     PL_utf8_foldclosures = newHV();
13406                 }
13407                 else {
13408                     /* If the folds haven't been read in, call a fold function
13409                      * to force that */
13410                     if (! PL_utf8_tofold) {
13411                         U8 dummy[UTF8_MAXBYTES+1];
13412
13413                         /* This string is just a short named one above \xff */
13414                         to_utf8_fold((U8*) HYPHEN_UTF8, dummy, NULL);
13415                         assert(PL_utf8_tofold); /* Verify that worked */
13416                     }
13417                     PL_utf8_foldclosures =
13418                                     _swash_inversion_hash(PL_utf8_tofold);
13419                 }
13420             }
13421
13422             /* Only the characters in this class that participate in folds need
13423              * be checked.  Get the intersection of this class and all the
13424              * possible characters that are foldable.  This can quickly narrow
13425              * down a large class */
13426             _invlist_intersection(PL_utf8_foldable, cp_list,
13427                                   &fold_intersection);
13428         }
13429
13430         /* Now look at the foldable characters in this class individually */
13431         invlist_iterinit(fold_intersection);
13432         while (invlist_iternext(fold_intersection, &start, &end)) {
13433             UV j;
13434
13435             /* Locale folding for Latin1 characters is deferred until runtime */
13436             if (LOC && start < 256) {
13437                 start = 256;
13438             }
13439
13440             /* Look at every character in the range */
13441             for (j = start; j <= end; j++) {
13442
13443                 U8 foldbuf[UTF8_MAXBYTES_CASE+1];
13444                 STRLEN foldlen;
13445                 SV** listp;
13446
13447                 if (j < 256) {
13448
13449                     /* We have the latin1 folding rules hard-coded here so that
13450                      * an innocent-looking character class, like /[ks]/i won't
13451                      * have to go out to disk to find the possible matches.
13452                      * XXX It would be better to generate these via regen, in
13453                      * case a new version of the Unicode standard adds new
13454                      * mappings, though that is not really likely, and may be
13455                      * caught by the default: case of the switch below. */
13456
13457                     if (IS_IN_SOME_FOLD_L1(j)) {
13458
13459                         /* ASCII is always matched; non-ASCII is matched only
13460                          * under Unicode rules */
13461                         if (isASCII(j) || AT_LEAST_UNI_SEMANTICS) {
13462                             cp_list =
13463                                 add_cp_to_invlist(cp_list, PL_fold_latin1[j]);
13464                         }
13465                         else {
13466                             depends_list =
13467                              add_cp_to_invlist(depends_list, PL_fold_latin1[j]);
13468                         }
13469                     }
13470
13471                     if (HAS_NONLATIN1_FOLD_CLOSURE(j)
13472                         && (! isASCII(j) || ! ASCII_FOLD_RESTRICTED))
13473                     {
13474                         /* Certain Latin1 characters have matches outside
13475                          * Latin1.  To get here, <j> is one of those
13476                          * characters.   None of these matches is valid for
13477                          * ASCII characters under /aa, which is why the 'if'
13478                          * just above excludes those.  These matches only
13479                          * happen when the target string is utf8.  The code
13480                          * below adds the single fold closures for <j> to the
13481                          * inversion list. */
13482                         switch (j) {
13483                             case 'k':
13484                             case 'K':
13485                                 cp_list =
13486                                     add_cp_to_invlist(cp_list, KELVIN_SIGN);
13487                                 break;
13488                             case 's':
13489                             case 'S':
13490                                 cp_list = add_cp_to_invlist(cp_list,
13491                                                     LATIN_SMALL_LETTER_LONG_S);
13492                                 break;
13493                             case MICRO_SIGN:
13494                                 cp_list = add_cp_to_invlist(cp_list,
13495                                                     GREEK_CAPITAL_LETTER_MU);
13496                                 cp_list = add_cp_to_invlist(cp_list,
13497                                                     GREEK_SMALL_LETTER_MU);
13498                                 break;
13499                             case LATIN_CAPITAL_LETTER_A_WITH_RING_ABOVE:
13500                             case LATIN_SMALL_LETTER_A_WITH_RING_ABOVE:
13501                                 cp_list =
13502                                     add_cp_to_invlist(cp_list, ANGSTROM_SIGN);
13503                                 break;
13504                             case LATIN_SMALL_LETTER_Y_WITH_DIAERESIS:
13505                                 cp_list = add_cp_to_invlist(cp_list,
13506                                         LATIN_CAPITAL_LETTER_Y_WITH_DIAERESIS);
13507                                 break;
13508                             case LATIN_SMALL_LETTER_SHARP_S:
13509                                 cp_list = add_cp_to_invlist(cp_list,
13510                                                 LATIN_CAPITAL_LETTER_SHARP_S);
13511                                 break;
13512                             case 'F': case 'f':
13513                             case 'I': case 'i':
13514                             case 'L': case 'l':
13515                             case 'T': case 't':
13516                             case 'A': case 'a':
13517                             case 'H': case 'h':
13518                             case 'J': case 'j':
13519                             case 'N': case 'n':
13520                             case 'W': case 'w':
13521                             case 'Y': case 'y':
13522                                 /* These all are targets of multi-character
13523                                  * folds from code points that require UTF8 to
13524                                  * express, so they can't match unless the
13525                                  * target string is in UTF-8, so no action here
13526                                  * is necessary, as regexec.c properly handles
13527                                  * the general case for UTF-8 matching and
13528                                  * multi-char folds */
13529                                 break;
13530                             default:
13531                                 /* Use deprecated warning to increase the
13532                                  * chances of this being output */
13533                                 ckWARN2regdep(RExC_parse, "Perl folding rules are not up-to-date for 0x%"UVXf"; please use the perlbug utility to report;", j);
13534                                 break;
13535                         }
13536                     }
13537                     continue;
13538                 }
13539
13540                 /* Here is an above Latin1 character.  We don't have the rules
13541                  * hard-coded for it.  First, get its fold.  This is the simple
13542                  * fold, as the multi-character folds have been handled earlier
13543                  * and separated out */
13544                 _to_uni_fold_flags(j, foldbuf, &foldlen,
13545                                                ((LOC)
13546                                                ? FOLD_FLAGS_LOCALE
13547                                                : (ASCII_FOLD_RESTRICTED)
13548                                                   ? FOLD_FLAGS_NOMIX_ASCII
13549                                                   : 0));
13550
13551                 /* Single character fold of above Latin1.  Add everything in
13552                  * its fold closure to the list that this node should match.
13553                  * The fold closures data structure is a hash with the keys
13554                  * being the UTF-8 of every character that is folded to, like
13555                  * 'k', and the values each an array of all code points that
13556                  * fold to its key.  e.g. [ 'k', 'K', KELVIN_SIGN ].
13557                  * Multi-character folds are not included */
13558                 if ((listp = hv_fetch(PL_utf8_foldclosures,
13559                                       (char *) foldbuf, foldlen, FALSE)))
13560                 {
13561                     AV* list = (AV*) *listp;
13562                     IV k;
13563                     for (k = 0; k <= av_len(list); k++) {
13564                         SV** c_p = av_fetch(list, k, FALSE);
13565                         UV c;
13566                         if (c_p == NULL) {
13567                             Perl_croak(aTHX_ "panic: invalid PL_utf8_foldclosures structure");
13568                         }
13569                         c = SvUV(*c_p);
13570
13571                         /* /aa doesn't allow folds between ASCII and non-; /l
13572                          * doesn't allow them between above and below 256 */
13573                         if ((ASCII_FOLD_RESTRICTED
13574                                   && (isASCII(c) != isASCII(j)))
13575                             || (LOC && c < 256)) {
13576                             continue;
13577                         }
13578
13579                         /* Folds involving non-ascii Latin1 characters
13580                          * under /d are added to a separate list */
13581                         if (isASCII(c) || c > 255 || AT_LEAST_UNI_SEMANTICS)
13582                         {
13583                             cp_list = add_cp_to_invlist(cp_list, c);
13584                         }
13585                         else {
13586                           depends_list = add_cp_to_invlist(depends_list, c);
13587                         }
13588                     }
13589                 }
13590             }
13591         }
13592         SvREFCNT_dec_NN(fold_intersection);
13593     }
13594
13595     /* And combine the result (if any) with any inversion list from posix
13596      * classes.  The lists are kept separate up to now because we don't want to
13597      * fold the classes (folding of those is automatically handled by the swash
13598      * fetching code) */
13599     if (posixes) {
13600         if (! DEPENDS_SEMANTICS) {
13601             if (cp_list) {
13602                 _invlist_union(cp_list, posixes, &cp_list);
13603                 SvREFCNT_dec_NN(posixes);
13604             }
13605             else {
13606                 cp_list = posixes;
13607             }
13608         }
13609         else {
13610             /* Under /d, we put into a separate list the Latin1 things that
13611              * match only when the target string is utf8 */
13612             SV* nonascii_but_latin1_properties = NULL;
13613             _invlist_intersection(posixes, PL_Latin1,
13614                                   &nonascii_but_latin1_properties);
13615             _invlist_subtract(nonascii_but_latin1_properties, PL_ASCII,
13616                               &nonascii_but_latin1_properties);
13617             _invlist_subtract(posixes, nonascii_but_latin1_properties,
13618                               &posixes);
13619             if (cp_list) {
13620                 _invlist_union(cp_list, posixes, &cp_list);
13621                 SvREFCNT_dec_NN(posixes);
13622             }
13623             else {
13624                 cp_list = posixes;
13625             }
13626
13627             if (depends_list) {
13628                 _invlist_union(depends_list, nonascii_but_latin1_properties,
13629                                &depends_list);
13630                 SvREFCNT_dec_NN(nonascii_but_latin1_properties);
13631             }
13632             else {
13633                 depends_list = nonascii_but_latin1_properties;
13634             }
13635         }
13636     }
13637
13638     /* And combine the result (if any) with any inversion list from properties.
13639      * The lists are kept separate up to now so that we can distinguish the two
13640      * in regards to matching above-Unicode.  A run-time warning is generated
13641      * if a Unicode property is matched against a non-Unicode code point. But,
13642      * we allow user-defined properties to match anything, without any warning,
13643      * and we also suppress the warning if there is a portion of the character
13644      * class that isn't a Unicode property, and which matches above Unicode, \W
13645      * or [\x{110000}] for example.
13646      * (Note that in this case, unlike the Posix one above, there is no
13647      * <depends_list>, because having a Unicode property forces Unicode
13648      * semantics */
13649     if (properties) {
13650         bool warn_super = ! has_user_defined_property;
13651         if (cp_list) {
13652
13653             /* If it matters to the final outcome, see if a non-property
13654              * component of the class matches above Unicode.  If so, the
13655              * warning gets suppressed.  This is true even if just a single
13656              * such code point is specified, as though not strictly correct if
13657              * another such code point is matched against, the fact that they
13658              * are using above-Unicode code points indicates they should know
13659              * the issues involved */
13660             if (warn_super) {
13661                 bool non_prop_matches_above_Unicode =
13662                             runtime_posix_matches_above_Unicode
13663                             | (invlist_highest(cp_list) > PERL_UNICODE_MAX);
13664                 if (invert) {
13665                     non_prop_matches_above_Unicode =
13666                                             !  non_prop_matches_above_Unicode;
13667                 }
13668                 warn_super = ! non_prop_matches_above_Unicode;
13669             }
13670
13671             _invlist_union(properties, cp_list, &cp_list);
13672             SvREFCNT_dec_NN(properties);
13673         }
13674         else {
13675             cp_list = properties;
13676         }
13677
13678         if (warn_super) {
13679             OP(ret) = ANYOF_WARN_SUPER;
13680         }
13681     }
13682
13683     /* Here, we have calculated what code points should be in the character
13684      * class.
13685      *
13686      * Now we can see about various optimizations.  Fold calculation (which we
13687      * did above) needs to take place before inversion.  Otherwise /[^k]/i
13688      * would invert to include K, which under /i would match k, which it
13689      * shouldn't.  Therefore we can't invert folded locale now, as it won't be
13690      * folded until runtime */
13691
13692     /* Optimize inverted simple patterns (e.g. [^a-z]) when everything is known
13693      * at compile time.  Besides not inverting folded locale now, we can't
13694      * invert if there are things such as \w, which aren't known until runtime
13695      * */
13696     if (invert
13697         && ! (LOC && (FOLD || (ANYOF_FLAGS(ret) & ANYOF_CLASS)))
13698         && ! depends_list
13699         && ! HAS_NONLOCALE_RUNTIME_PROPERTY_DEFINITION)
13700     {
13701         _invlist_invert(cp_list);
13702
13703         /* Any swash can't be used as-is, because we've inverted things */
13704         if (swash) {
13705             SvREFCNT_dec_NN(swash);
13706             swash = NULL;
13707         }
13708
13709         /* Clear the invert flag since have just done it here */
13710         invert = FALSE;
13711     }
13712
13713     if (ret_invlist) {
13714         *ret_invlist = cp_list;
13715
13716         /* Discard the generated node */
13717         if (SIZE_ONLY) {
13718             RExC_size = orig_size;
13719         }
13720         else {
13721             RExC_emit = orig_emit;
13722         }
13723         return orig_emit;
13724     }
13725
13726     /* If we didn't do folding, it's because some information isn't available
13727      * until runtime; set the run-time fold flag for these.  (We don't have to
13728      * worry about properties folding, as that is taken care of by the swash
13729      * fetching) */
13730     if (FOLD && LOC)
13731     {
13732        ANYOF_FLAGS(ret) |= ANYOF_LOC_FOLD;
13733     }
13734
13735     /* Some character classes are equivalent to other nodes.  Such nodes take
13736      * up less room and generally fewer operations to execute than ANYOF nodes.
13737      * Above, we checked for and optimized into some such equivalents for
13738      * certain common classes that are easy to test.  Getting to this point in
13739      * the code means that the class didn't get optimized there.  Since this
13740      * code is only executed in Pass 2, it is too late to save space--it has
13741      * been allocated in Pass 1, and currently isn't given back.  But turning
13742      * things into an EXACTish node can allow the optimizer to join it to any
13743      * adjacent such nodes.  And if the class is equivalent to things like /./,
13744      * expensive run-time swashes can be avoided.  Now that we have more
13745      * complete information, we can find things necessarily missed by the
13746      * earlier code.  I (khw) am not sure how much to look for here.  It would
13747      * be easy, but perhaps too slow, to check any candidates against all the
13748      * node types they could possibly match using _invlistEQ(). */
13749
13750     if (cp_list
13751         && ! invert
13752         && ! depends_list
13753         && ! (ANYOF_FLAGS(ret) & ANYOF_CLASS)
13754         && ! HAS_NONLOCALE_RUNTIME_PROPERTY_DEFINITION)
13755     {
13756         UV start, end;
13757         U8 op = END;  /* The optimzation node-type */
13758         const char * cur_parse= RExC_parse;
13759
13760         invlist_iterinit(cp_list);
13761         if (! invlist_iternext(cp_list, &start, &end)) {
13762
13763             /* Here, the list is empty.  This happens, for example, when a
13764              * Unicode property is the only thing in the character class, and
13765              * it doesn't match anything.  (perluniprops.pod notes such
13766              * properties) */
13767             op = OPFAIL;
13768             *flagp |= HASWIDTH|SIMPLE;
13769         }
13770         else if (start == end) {    /* The range is a single code point */
13771             if (! invlist_iternext(cp_list, &start, &end)
13772
13773                     /* Don't do this optimization if it would require changing
13774                      * the pattern to UTF-8 */
13775                 && (start < 256 || UTF))
13776             {
13777                 /* Here, the list contains a single code point.  Can optimize
13778                  * into an EXACT node */
13779
13780                 value = start;
13781
13782                 if (! FOLD) {
13783                     op = EXACT;
13784                 }
13785                 else if (LOC) {
13786
13787                     /* A locale node under folding with one code point can be
13788                      * an EXACTFL, as its fold won't be calculated until
13789                      * runtime */
13790                     op = EXACTFL;
13791                 }
13792                 else {
13793
13794                     /* Here, we are generally folding, but there is only one
13795                      * code point to match.  If we have to, we use an EXACT
13796                      * node, but it would be better for joining with adjacent
13797                      * nodes in the optimization pass if we used the same
13798                      * EXACTFish node that any such are likely to be.  We can
13799                      * do this iff the code point doesn't participate in any
13800                      * folds.  For example, an EXACTF of a colon is the same as
13801                      * an EXACT one, since nothing folds to or from a colon. */
13802                     if (value < 256) {
13803                         if (IS_IN_SOME_FOLD_L1(value)) {
13804                             op = EXACT;
13805                         }
13806                     }
13807                     else {
13808                         if (! PL_utf8_foldable) {
13809                             SV* swash = swash_init("utf8", "_Perl_Any_Folds",
13810                                                 &PL_sv_undef, 1, 0);
13811                             PL_utf8_foldable = _get_swash_invlist(swash);
13812                             SvREFCNT_dec_NN(swash);
13813                         }
13814                         if (_invlist_contains_cp(PL_utf8_foldable, value)) {
13815                             op = EXACT;
13816                         }
13817                     }
13818
13819                     /* If we haven't found the node type, above, it means we
13820                      * can use the prevailing one */
13821                     if (op == END) {
13822                         op = compute_EXACTish(pRExC_state);
13823                     }
13824                 }
13825             }
13826         }
13827         else if (start == 0) {
13828             if (end == UV_MAX) {
13829                 op = SANY;
13830                 *flagp |= HASWIDTH|SIMPLE;
13831                 RExC_naughty++;
13832             }
13833             else if (end == '\n' - 1
13834                     && invlist_iternext(cp_list, &start, &end)
13835                     && start == '\n' + 1 && end == UV_MAX)
13836             {
13837                 op = REG_ANY;
13838                 *flagp |= HASWIDTH|SIMPLE;
13839                 RExC_naughty++;
13840             }
13841         }
13842         invlist_iterfinish(cp_list);
13843
13844         if (op != END) {
13845             RExC_parse = (char *)orig_parse;
13846             RExC_emit = (regnode *)orig_emit;
13847
13848             ret = reg_node(pRExC_state, op);
13849
13850             RExC_parse = (char *)cur_parse;
13851
13852             if (PL_regkind[op] == EXACT) {
13853                 alloc_maybe_populate_EXACT(pRExC_state, ret, flagp, 0, value);
13854             }
13855
13856             SvREFCNT_dec_NN(cp_list);
13857             return ret;
13858         }
13859     }
13860
13861     /* Here, <cp_list> contains all the code points we can determine at
13862      * compile time that match under all conditions.  Go through it, and
13863      * for things that belong in the bitmap, put them there, and delete from
13864      * <cp_list>.  While we are at it, see if everything above 255 is in the
13865      * list, and if so, set a flag to speed up execution */
13866     ANYOF_BITMAP_ZERO(ret);
13867     if (cp_list) {
13868
13869         /* This gets set if we actually need to modify things */
13870         bool change_invlist = FALSE;
13871
13872         UV start, end;
13873
13874         /* Start looking through <cp_list> */
13875         invlist_iterinit(cp_list);
13876         while (invlist_iternext(cp_list, &start, &end)) {
13877             UV high;
13878             int i;
13879
13880             if (end == UV_MAX && start <= 256) {
13881                 ANYOF_FLAGS(ret) |= ANYOF_UNICODE_ALL;
13882             }
13883
13884             /* Quit if are above what we should change */
13885             if (start > 255) {
13886                 break;
13887             }
13888
13889             change_invlist = TRUE;
13890
13891             /* Set all the bits in the range, up to the max that we are doing */
13892             high = (end < 255) ? end : 255;
13893             for (i = start; i <= (int) high; i++) {
13894                 if (! ANYOF_BITMAP_TEST(ret, i)) {
13895                     ANYOF_BITMAP_SET(ret, i);
13896                     prevvalue = value;
13897                     value = i;
13898                 }
13899             }
13900         }
13901         invlist_iterfinish(cp_list);
13902
13903         /* Done with loop; remove any code points that are in the bitmap from
13904          * <cp_list> */
13905         if (change_invlist) {
13906             _invlist_subtract(cp_list, PL_Latin1, &cp_list);
13907         }
13908
13909         /* If have completely emptied it, remove it completely */
13910         if (_invlist_len(cp_list) == 0) {
13911             SvREFCNT_dec_NN(cp_list);
13912             cp_list = NULL;
13913         }
13914     }
13915
13916     if (invert) {
13917         ANYOF_FLAGS(ret) |= ANYOF_INVERT;
13918     }
13919
13920     /* Here, the bitmap has been populated with all the Latin1 code points that
13921      * always match.  Can now add to the overall list those that match only
13922      * when the target string is UTF-8 (<depends_list>). */
13923     if (depends_list) {
13924         if (cp_list) {
13925             _invlist_union(cp_list, depends_list, &cp_list);
13926             SvREFCNT_dec_NN(depends_list);
13927         }
13928         else {
13929             cp_list = depends_list;
13930         }
13931     }
13932
13933     /* If there is a swash and more than one element, we can't use the swash in
13934      * the optimization below. */
13935     if (swash && element_count > 1) {
13936         SvREFCNT_dec_NN(swash);
13937         swash = NULL;
13938     }
13939
13940     if (! cp_list
13941         && ! HAS_NONLOCALE_RUNTIME_PROPERTY_DEFINITION)
13942     {
13943         ARG_SET(ret, ANYOF_NONBITMAP_EMPTY);
13944     }
13945     else {
13946         /* av[0] stores the character class description in its textual form:
13947          *       used later (regexec.c:Perl_regclass_swash()) to initialize the
13948          *       appropriate swash, and is also useful for dumping the regnode.
13949          * av[1] if NULL, is a placeholder to later contain the swash computed
13950          *       from av[0].  But if no further computation need be done, the
13951          *       swash is stored there now.
13952          * av[2] stores the cp_list inversion list for use in addition or
13953          *       instead of av[0]; used only if av[1] is NULL
13954          * av[3] is set if any component of the class is from a user-defined
13955          *       property; used only if av[1] is NULL */
13956         AV * const av = newAV();
13957         SV *rv;
13958
13959         av_store(av, 0, (HAS_NONLOCALE_RUNTIME_PROPERTY_DEFINITION)
13960                         ? SvREFCNT_inc(listsv) : &PL_sv_undef);
13961         if (swash) {
13962             av_store(av, 1, swash);
13963             SvREFCNT_dec_NN(cp_list);
13964         }
13965         else {
13966             av_store(av, 1, NULL);
13967             if (cp_list) {
13968                 av_store(av, 2, cp_list);
13969                 av_store(av, 3, newSVuv(has_user_defined_property));
13970             }
13971         }
13972
13973         rv = newRV_noinc(MUTABLE_SV(av));
13974         n = add_data(pRExC_state, 1, "s");
13975         RExC_rxi->data->data[n] = (void*)rv;
13976         ARG_SET(ret, n);
13977     }
13978
13979     *flagp |= HASWIDTH|SIMPLE;
13980     return ret;
13981 }
13982 #undef HAS_NONLOCALE_RUNTIME_PROPERTY_DEFINITION
13983
13984
13985 /* reg_skipcomment()
13986
13987    Absorbs an /x style # comments from the input stream.
13988    Returns true if there is more text remaining in the stream.
13989    Will set the REG_SEEN_RUN_ON_COMMENT flag if the comment
13990    terminates the pattern without including a newline.
13991
13992    Note its the callers responsibility to ensure that we are
13993    actually in /x mode
13994
13995 */
13996
13997 STATIC bool
13998 S_reg_skipcomment(pTHX_ RExC_state_t *pRExC_state)
13999 {
14000     bool ended = 0;
14001
14002     PERL_ARGS_ASSERT_REG_SKIPCOMMENT;
14003
14004     while (RExC_parse < RExC_end)
14005         if (*RExC_parse++ == '\n') {
14006             ended = 1;
14007             break;
14008         }
14009     if (!ended) {
14010         /* we ran off the end of the pattern without ending
14011            the comment, so we have to add an \n when wrapping */
14012         RExC_seen |= REG_SEEN_RUN_ON_COMMENT;
14013         return 0;
14014     } else
14015         return 1;
14016 }
14017
14018 /* nextchar()
14019
14020    Advances the parse position, and optionally absorbs
14021    "whitespace" from the inputstream.
14022
14023    Without /x "whitespace" means (?#...) style comments only,
14024    with /x this means (?#...) and # comments and whitespace proper.
14025
14026    Returns the RExC_parse point from BEFORE the scan occurs.
14027
14028    This is the /x friendly way of saying RExC_parse++.
14029 */
14030
14031 STATIC char*
14032 S_nextchar(pTHX_ RExC_state_t *pRExC_state)
14033 {
14034     char* const retval = RExC_parse++;
14035
14036     PERL_ARGS_ASSERT_NEXTCHAR;
14037
14038     for (;;) {
14039         if (RExC_end - RExC_parse >= 3
14040             && *RExC_parse == '('
14041             && RExC_parse[1] == '?'
14042             && RExC_parse[2] == '#')
14043         {
14044             while (*RExC_parse != ')') {
14045                 if (RExC_parse == RExC_end)
14046                     FAIL("Sequence (?#... not terminated");
14047                 RExC_parse++;
14048             }
14049             RExC_parse++;
14050             continue;
14051         }
14052         if (RExC_flags & RXf_PMf_EXTENDED) {
14053             if (isSPACE(*RExC_parse)) {
14054                 RExC_parse++;
14055                 continue;
14056             }
14057             else if (*RExC_parse == '#') {
14058                 if ( reg_skipcomment( pRExC_state ) )
14059                     continue;
14060             }
14061         }
14062         return retval;
14063     }
14064 }
14065
14066 /*
14067 - reg_node - emit a node
14068 */
14069 STATIC regnode *                        /* Location. */
14070 S_reg_node(pTHX_ RExC_state_t *pRExC_state, U8 op)
14071 {
14072     dVAR;
14073     regnode *ptr;
14074     regnode * const ret = RExC_emit;
14075     GET_RE_DEBUG_FLAGS_DECL;
14076
14077     PERL_ARGS_ASSERT_REG_NODE;
14078
14079     if (SIZE_ONLY) {
14080         SIZE_ALIGN(RExC_size);
14081         RExC_size += 1;
14082         return(ret);
14083     }
14084     if (RExC_emit >= RExC_emit_bound)
14085         Perl_croak(aTHX_ "panic: reg_node overrun trying to emit %d, %p>=%p",
14086                    op, RExC_emit, RExC_emit_bound);
14087
14088     NODE_ALIGN_FILL(ret);
14089     ptr = ret;
14090     FILL_ADVANCE_NODE(ptr, op);
14091 #ifdef RE_TRACK_PATTERN_OFFSETS
14092     if (RExC_offsets) {         /* MJD */
14093         MJD_OFFSET_DEBUG(("%s:%d: (op %s) %s %"UVuf" (len %"UVuf") (max %"UVuf").\n", 
14094               "reg_node", __LINE__, 
14095               PL_reg_name[op],
14096               (UV)(RExC_emit - RExC_emit_start) > RExC_offsets[0] 
14097                 ? "Overwriting end of array!\n" : "OK",
14098               (UV)(RExC_emit - RExC_emit_start),
14099               (UV)(RExC_parse - RExC_start),
14100               (UV)RExC_offsets[0])); 
14101         Set_Node_Offset(RExC_emit, RExC_parse + (op == END));
14102     }
14103 #endif
14104     RExC_emit = ptr;
14105     return(ret);
14106 }
14107
14108 /*
14109 - reganode - emit a node with an argument
14110 */
14111 STATIC regnode *                        /* Location. */
14112 S_reganode(pTHX_ RExC_state_t *pRExC_state, U8 op, U32 arg)
14113 {
14114     dVAR;
14115     regnode *ptr;
14116     regnode * const ret = RExC_emit;
14117     GET_RE_DEBUG_FLAGS_DECL;
14118
14119     PERL_ARGS_ASSERT_REGANODE;
14120
14121     if (SIZE_ONLY) {
14122         SIZE_ALIGN(RExC_size);
14123         RExC_size += 2;
14124         /* 
14125            We can't do this:
14126            
14127            assert(2==regarglen[op]+1); 
14128
14129            Anything larger than this has to allocate the extra amount.
14130            If we changed this to be:
14131            
14132            RExC_size += (1 + regarglen[op]);
14133            
14134            then it wouldn't matter. Its not clear what side effect
14135            might come from that so its not done so far.
14136            -- dmq
14137         */
14138         return(ret);
14139     }
14140     if (RExC_emit >= RExC_emit_bound)
14141         Perl_croak(aTHX_ "panic: reg_node overrun trying to emit %d, %p>=%p",
14142                    op, RExC_emit, RExC_emit_bound);
14143
14144     NODE_ALIGN_FILL(ret);
14145     ptr = ret;
14146     FILL_ADVANCE_NODE_ARG(ptr, op, arg);
14147 #ifdef RE_TRACK_PATTERN_OFFSETS
14148     if (RExC_offsets) {         /* MJD */
14149         MJD_OFFSET_DEBUG(("%s(%d): (op %s) %s %"UVuf" <- %"UVuf" (max %"UVuf").\n", 
14150               "reganode",
14151               __LINE__,
14152               PL_reg_name[op],
14153               (UV)(RExC_emit - RExC_emit_start) > RExC_offsets[0] ? 
14154               "Overwriting end of array!\n" : "OK",
14155               (UV)(RExC_emit - RExC_emit_start),
14156               (UV)(RExC_parse - RExC_start),
14157               (UV)RExC_offsets[0])); 
14158         Set_Cur_Node_Offset;
14159     }
14160 #endif            
14161     RExC_emit = ptr;
14162     return(ret);
14163 }
14164
14165 /*
14166 - reguni - emit (if appropriate) a Unicode character
14167 */
14168 STATIC STRLEN
14169 S_reguni(pTHX_ const RExC_state_t *pRExC_state, UV uv, char* s)
14170 {
14171     dVAR;
14172
14173     PERL_ARGS_ASSERT_REGUNI;
14174
14175     return SIZE_ONLY ? UNISKIP(uv) : (uvchr_to_utf8((U8*)s, uv) - (U8*)s);
14176 }
14177
14178 /*
14179 - reginsert - insert an operator in front of already-emitted operand
14180 *
14181 * Means relocating the operand.
14182 */
14183 STATIC void
14184 S_reginsert(pTHX_ RExC_state_t *pRExC_state, U8 op, regnode *opnd, U32 depth)
14185 {
14186     dVAR;
14187     regnode *src;
14188     regnode *dst;
14189     regnode *place;
14190     const int offset = regarglen[(U8)op];
14191     const int size = NODE_STEP_REGNODE + offset;
14192     GET_RE_DEBUG_FLAGS_DECL;
14193
14194     PERL_ARGS_ASSERT_REGINSERT;
14195     PERL_UNUSED_ARG(depth);
14196 /* (PL_regkind[(U8)op] == CURLY ? EXTRA_STEP_2ARGS : 0); */
14197     DEBUG_PARSE_FMT("inst"," - %s",PL_reg_name[op]);
14198     if (SIZE_ONLY) {
14199         RExC_size += size;
14200         return;
14201     }
14202
14203     src = RExC_emit;
14204     RExC_emit += size;
14205     dst = RExC_emit;
14206     if (RExC_open_parens) {
14207         int paren;
14208         /*DEBUG_PARSE_FMT("inst"," - %"IVdf, (IV)RExC_npar);*/
14209         for ( paren=0 ; paren < RExC_npar ; paren++ ) {
14210             if ( RExC_open_parens[paren] >= opnd ) {
14211                 /*DEBUG_PARSE_FMT("open"," - %d",size);*/
14212                 RExC_open_parens[paren] += size;
14213             } else {
14214                 /*DEBUG_PARSE_FMT("open"," - %s","ok");*/
14215             }
14216             if ( RExC_close_parens[paren] >= opnd ) {
14217                 /*DEBUG_PARSE_FMT("close"," - %d",size);*/
14218                 RExC_close_parens[paren] += size;
14219             } else {
14220                 /*DEBUG_PARSE_FMT("close"," - %s","ok");*/
14221             }
14222         }
14223     }
14224
14225     while (src > opnd) {
14226         StructCopy(--src, --dst, regnode);
14227 #ifdef RE_TRACK_PATTERN_OFFSETS
14228         if (RExC_offsets) {     /* MJD 20010112 */
14229             MJD_OFFSET_DEBUG(("%s(%d): (op %s) %s copy %"UVuf" -> %"UVuf" (max %"UVuf").\n",
14230                   "reg_insert",
14231                   __LINE__,
14232                   PL_reg_name[op],
14233                   (UV)(dst - RExC_emit_start) > RExC_offsets[0] 
14234                     ? "Overwriting end of array!\n" : "OK",
14235                   (UV)(src - RExC_emit_start),
14236                   (UV)(dst - RExC_emit_start),
14237                   (UV)RExC_offsets[0])); 
14238             Set_Node_Offset_To_R(dst-RExC_emit_start, Node_Offset(src));
14239             Set_Node_Length_To_R(dst-RExC_emit_start, Node_Length(src));
14240         }
14241 #endif
14242     }
14243     
14244
14245     place = opnd;               /* Op node, where operand used to be. */
14246 #ifdef RE_TRACK_PATTERN_OFFSETS
14247     if (RExC_offsets) {         /* MJD */
14248         MJD_OFFSET_DEBUG(("%s(%d): (op %s) %s %"UVuf" <- %"UVuf" (max %"UVuf").\n", 
14249               "reginsert",
14250               __LINE__,
14251               PL_reg_name[op],
14252               (UV)(place - RExC_emit_start) > RExC_offsets[0] 
14253               ? "Overwriting end of array!\n" : "OK",
14254               (UV)(place - RExC_emit_start),
14255               (UV)(RExC_parse - RExC_start),
14256               (UV)RExC_offsets[0]));
14257         Set_Node_Offset(place, RExC_parse);
14258         Set_Node_Length(place, 1);
14259     }
14260 #endif    
14261     src = NEXTOPER(place);
14262     FILL_ADVANCE_NODE(place, op);
14263     Zero(src, offset, regnode);
14264 }
14265
14266 /*
14267 - regtail - set the next-pointer at the end of a node chain of p to val.
14268 - SEE ALSO: regtail_study
14269 */
14270 /* TODO: All three parms should be const */
14271 STATIC void
14272 S_regtail(pTHX_ RExC_state_t *pRExC_state, regnode *p, const regnode *val,U32 depth)
14273 {
14274     dVAR;
14275     regnode *scan;
14276     GET_RE_DEBUG_FLAGS_DECL;
14277
14278     PERL_ARGS_ASSERT_REGTAIL;
14279 #ifndef DEBUGGING
14280     PERL_UNUSED_ARG(depth);
14281 #endif
14282
14283     if (SIZE_ONLY)
14284         return;
14285
14286     /* Find last node. */
14287     scan = p;
14288     for (;;) {
14289         regnode * const temp = regnext(scan);
14290         DEBUG_PARSE_r({
14291             SV * const mysv=sv_newmortal();
14292             DEBUG_PARSE_MSG((scan==p ? "tail" : ""));
14293             regprop(RExC_rx, mysv, scan);
14294             PerlIO_printf(Perl_debug_log, "~ %s (%d) %s %s\n",
14295                 SvPV_nolen_const(mysv), REG_NODE_NUM(scan),
14296                     (temp == NULL ? "->" : ""),
14297                     (temp == NULL ? PL_reg_name[OP(val)] : "")
14298             );
14299         });
14300         if (temp == NULL)
14301             break;
14302         scan = temp;
14303     }
14304
14305     if (reg_off_by_arg[OP(scan)]) {
14306         ARG_SET(scan, val - scan);
14307     }
14308     else {
14309         NEXT_OFF(scan) = val - scan;
14310     }
14311 }
14312
14313 #ifdef DEBUGGING
14314 /*
14315 - regtail_study - set the next-pointer at the end of a node chain of p to val.
14316 - Look for optimizable sequences at the same time.
14317 - currently only looks for EXACT chains.
14318
14319 This is experimental code. The idea is to use this routine to perform 
14320 in place optimizations on branches and groups as they are constructed,
14321 with the long term intention of removing optimization from study_chunk so
14322 that it is purely analytical.
14323
14324 Currently only used when in DEBUG mode. The macro REGTAIL_STUDY() is used
14325 to control which is which.
14326
14327 */
14328 /* TODO: All four parms should be const */
14329
14330 STATIC U8
14331 S_regtail_study(pTHX_ RExC_state_t *pRExC_state, regnode *p, const regnode *val,U32 depth)
14332 {
14333     dVAR;
14334     regnode *scan;
14335     U8 exact = PSEUDO;
14336 #ifdef EXPERIMENTAL_INPLACESCAN
14337     I32 min = 0;
14338 #endif
14339     GET_RE_DEBUG_FLAGS_DECL;
14340
14341     PERL_ARGS_ASSERT_REGTAIL_STUDY;
14342
14343
14344     if (SIZE_ONLY)
14345         return exact;
14346
14347     /* Find last node. */
14348
14349     scan = p;
14350     for (;;) {
14351         regnode * const temp = regnext(scan);
14352 #ifdef EXPERIMENTAL_INPLACESCAN
14353         if (PL_regkind[OP(scan)] == EXACT) {
14354             bool has_exactf_sharp_s;    /* Unexamined in this routine */
14355             if (join_exact(pRExC_state,scan,&min, &has_exactf_sharp_s, 1,val,depth+1))
14356                 return EXACT;
14357         }
14358 #endif
14359         if ( exact ) {
14360             switch (OP(scan)) {
14361                 case EXACT:
14362                 case EXACTF:
14363                 case EXACTFA:
14364                 case EXACTFU:
14365                 case EXACTFU_SS:
14366                 case EXACTFU_TRICKYFOLD:
14367                 case EXACTFL:
14368                         if( exact == PSEUDO )
14369                             exact= OP(scan);
14370                         else if ( exact != OP(scan) )
14371                             exact= 0;
14372                 case NOTHING:
14373                     break;
14374                 default:
14375                     exact= 0;
14376             }
14377         }
14378         DEBUG_PARSE_r({
14379             SV * const mysv=sv_newmortal();
14380             DEBUG_PARSE_MSG((scan==p ? "tsdy" : ""));
14381             regprop(RExC_rx, mysv, scan);
14382             PerlIO_printf(Perl_debug_log, "~ %s (%d) -> %s\n",
14383                 SvPV_nolen_const(mysv),
14384                 REG_NODE_NUM(scan),
14385                 PL_reg_name[exact]);
14386         });
14387         if (temp == NULL)
14388             break;
14389         scan = temp;
14390     }
14391     DEBUG_PARSE_r({
14392         SV * const mysv_val=sv_newmortal();
14393         DEBUG_PARSE_MSG("");
14394         regprop(RExC_rx, mysv_val, val);
14395         PerlIO_printf(Perl_debug_log, "~ attach to %s (%"IVdf") offset to %"IVdf"\n",
14396                       SvPV_nolen_const(mysv_val),
14397                       (IV)REG_NODE_NUM(val),
14398                       (IV)(val - scan)
14399         );
14400     });
14401     if (reg_off_by_arg[OP(scan)]) {
14402         ARG_SET(scan, val - scan);
14403     }
14404     else {
14405         NEXT_OFF(scan) = val - scan;
14406     }
14407
14408     return exact;
14409 }
14410 #endif
14411
14412 /*
14413  - regdump - dump a regexp onto Perl_debug_log in vaguely comprehensible form
14414  */
14415 #ifdef DEBUGGING
14416 static void 
14417 S_regdump_extflags(pTHX_ const char *lead, const U32 flags)
14418 {
14419     int bit;
14420     int set=0;
14421     regex_charset cs;
14422
14423     for (bit=0; bit<32; bit++) {
14424         if (flags & (1<<bit)) {
14425             if ((1<<bit) & RXf_PMf_CHARSET) {   /* Output separately, below */
14426                 continue;
14427             }
14428             if (!set++ && lead) 
14429                 PerlIO_printf(Perl_debug_log, "%s",lead);
14430             PerlIO_printf(Perl_debug_log, "%s ",PL_reg_extflags_name[bit]);
14431         }               
14432     }      
14433     if ((cs = get_regex_charset(flags)) != REGEX_DEPENDS_CHARSET) {
14434             if (!set++ && lead) {
14435                 PerlIO_printf(Perl_debug_log, "%s",lead);
14436             }
14437             switch (cs) {
14438                 case REGEX_UNICODE_CHARSET:
14439                     PerlIO_printf(Perl_debug_log, "UNICODE");
14440                     break;
14441                 case REGEX_LOCALE_CHARSET:
14442                     PerlIO_printf(Perl_debug_log, "LOCALE");
14443                     break;
14444                 case REGEX_ASCII_RESTRICTED_CHARSET:
14445                     PerlIO_printf(Perl_debug_log, "ASCII-RESTRICTED");
14446                     break;
14447                 case REGEX_ASCII_MORE_RESTRICTED_CHARSET:
14448                     PerlIO_printf(Perl_debug_log, "ASCII-MORE_RESTRICTED");
14449                     break;
14450                 default:
14451                     PerlIO_printf(Perl_debug_log, "UNKNOWN CHARACTER SET");
14452                     break;
14453             }
14454     }
14455     if (lead)  {
14456         if (set) 
14457             PerlIO_printf(Perl_debug_log, "\n");
14458         else 
14459             PerlIO_printf(Perl_debug_log, "%s[none-set]\n",lead);
14460     }            
14461 }   
14462 #endif
14463
14464 void
14465 Perl_regdump(pTHX_ const regexp *r)
14466 {
14467 #ifdef DEBUGGING
14468     dVAR;
14469     SV * const sv = sv_newmortal();
14470     SV *dsv= sv_newmortal();
14471     RXi_GET_DECL(r,ri);
14472     GET_RE_DEBUG_FLAGS_DECL;
14473
14474     PERL_ARGS_ASSERT_REGDUMP;
14475
14476     (void)dumpuntil(r, ri->program, ri->program + 1, NULL, NULL, sv, 0, 0);
14477
14478     /* Header fields of interest. */
14479     if (r->anchored_substr) {
14480         RE_PV_QUOTED_DECL(s, 0, dsv, SvPVX_const(r->anchored_substr), 
14481             RE_SV_DUMPLEN(r->anchored_substr), 30);
14482         PerlIO_printf(Perl_debug_log,
14483                       "anchored %s%s at %"IVdf" ",
14484                       s, RE_SV_TAIL(r->anchored_substr),
14485                       (IV)r->anchored_offset);
14486     } else if (r->anchored_utf8) {
14487         RE_PV_QUOTED_DECL(s, 1, dsv, SvPVX_const(r->anchored_utf8), 
14488             RE_SV_DUMPLEN(r->anchored_utf8), 30);
14489         PerlIO_printf(Perl_debug_log,
14490                       "anchored utf8 %s%s at %"IVdf" ",
14491                       s, RE_SV_TAIL(r->anchored_utf8),
14492                       (IV)r->anchored_offset);
14493     }                 
14494     if (r->float_substr) {
14495         RE_PV_QUOTED_DECL(s, 0, dsv, SvPVX_const(r->float_substr), 
14496             RE_SV_DUMPLEN(r->float_substr), 30);
14497         PerlIO_printf(Perl_debug_log,
14498                       "floating %s%s at %"IVdf"..%"UVuf" ",
14499                       s, RE_SV_TAIL(r->float_substr),
14500                       (IV)r->float_min_offset, (UV)r->float_max_offset);
14501     } else if (r->float_utf8) {
14502         RE_PV_QUOTED_DECL(s, 1, dsv, SvPVX_const(r->float_utf8), 
14503             RE_SV_DUMPLEN(r->float_utf8), 30);
14504         PerlIO_printf(Perl_debug_log,
14505                       "floating utf8 %s%s at %"IVdf"..%"UVuf" ",
14506                       s, RE_SV_TAIL(r->float_utf8),
14507                       (IV)r->float_min_offset, (UV)r->float_max_offset);
14508     }
14509     if (r->check_substr || r->check_utf8)
14510         PerlIO_printf(Perl_debug_log,
14511                       (const char *)
14512                       (r->check_substr == r->float_substr
14513                        && r->check_utf8 == r->float_utf8
14514                        ? "(checking floating" : "(checking anchored"));
14515     if (r->extflags & RXf_NOSCAN)
14516         PerlIO_printf(Perl_debug_log, " noscan");
14517     if (r->extflags & RXf_CHECK_ALL)
14518         PerlIO_printf(Perl_debug_log, " isall");
14519     if (r->check_substr || r->check_utf8)
14520         PerlIO_printf(Perl_debug_log, ") ");
14521
14522     if (ri->regstclass) {
14523         regprop(r, sv, ri->regstclass);
14524         PerlIO_printf(Perl_debug_log, "stclass %s ", SvPVX_const(sv));
14525     }
14526     if (r->extflags & RXf_ANCH) {
14527         PerlIO_printf(Perl_debug_log, "anchored");
14528         if (r->extflags & RXf_ANCH_BOL)
14529             PerlIO_printf(Perl_debug_log, "(BOL)");
14530         if (r->extflags & RXf_ANCH_MBOL)
14531             PerlIO_printf(Perl_debug_log, "(MBOL)");
14532         if (r->extflags & RXf_ANCH_SBOL)
14533             PerlIO_printf(Perl_debug_log, "(SBOL)");
14534         if (r->extflags & RXf_ANCH_GPOS)
14535             PerlIO_printf(Perl_debug_log, "(GPOS)");
14536         PerlIO_putc(Perl_debug_log, ' ');
14537     }
14538     if (r->extflags & RXf_GPOS_SEEN)
14539         PerlIO_printf(Perl_debug_log, "GPOS:%"UVuf" ", (UV)r->gofs);
14540     if (r->intflags & PREGf_SKIP)
14541         PerlIO_printf(Perl_debug_log, "plus ");
14542     if (r->intflags & PREGf_IMPLICIT)
14543         PerlIO_printf(Perl_debug_log, "implicit ");
14544     PerlIO_printf(Perl_debug_log, "minlen %"IVdf" ", (IV)r->minlen);
14545     if (r->extflags & RXf_EVAL_SEEN)
14546         PerlIO_printf(Perl_debug_log, "with eval ");
14547     PerlIO_printf(Perl_debug_log, "\n");
14548     DEBUG_FLAGS_r(regdump_extflags("r->extflags: ",r->extflags));            
14549 #else
14550     PERL_ARGS_ASSERT_REGDUMP;
14551     PERL_UNUSED_CONTEXT;
14552     PERL_UNUSED_ARG(r);
14553 #endif  /* DEBUGGING */
14554 }
14555
14556 /*
14557 - regprop - printable representation of opcode
14558 */
14559 #define EMIT_ANYOF_TEST_SEPARATOR(do_sep,sv,flags) \
14560 STMT_START { \
14561         if (do_sep) {                           \
14562             Perl_sv_catpvf(aTHX_ sv,"%s][%s",PL_colors[1],PL_colors[0]); \
14563             if (flags & ANYOF_INVERT)           \
14564                 /*make sure the invert info is in each */ \
14565                 sv_catpvs(sv, "^");             \
14566             do_sep = 0;                         \
14567         }                                       \
14568 } STMT_END
14569
14570 void
14571 Perl_regprop(pTHX_ const regexp *prog, SV *sv, const regnode *o)
14572 {
14573 #ifdef DEBUGGING
14574     dVAR;
14575     int k;
14576
14577     /* Should be synchronized with * ANYOF_ #xdefines in regcomp.h */
14578     static const char * const anyofs[] = {
14579 #if _CC_WORDCHAR != 0 || _CC_DIGIT != 1 || _CC_ALPHA != 2 || _CC_LOWER != 3 \
14580     || _CC_UPPER != 4 || _CC_PUNCT != 5 || _CC_PRINT != 6                   \
14581     || _CC_ALPHANUMERIC != 7 || _CC_GRAPH != 8 || _CC_CASED != 9            \
14582     || _CC_SPACE != 10 || _CC_BLANK != 11 || _CC_XDIGIT != 12               \
14583     || _CC_PSXSPC != 13 || _CC_CNTRL != 14 || _CC_ASCII != 15               \
14584     || _CC_VERTSPACE != 16
14585   #error Need to adjust order of anyofs[]
14586 #endif
14587         "[\\w]",
14588         "[\\W]",
14589         "[\\d]",
14590         "[\\D]",
14591         "[:alpha:]",
14592         "[:^alpha:]",
14593         "[:lower:]",
14594         "[:^lower:]",
14595         "[:upper:]",
14596         "[:^upper:]",
14597         "[:punct:]",
14598         "[:^punct:]",
14599         "[:print:]",
14600         "[:^print:]",
14601         "[:alnum:]",
14602         "[:^alnum:]",
14603         "[:graph:]",
14604         "[:^graph:]",
14605         "[:cased:]",
14606         "[:^cased:]",
14607         "[\\s]",
14608         "[\\S]",
14609         "[:blank:]",
14610         "[:^blank:]",
14611         "[:xdigit:]",
14612         "[:^xdigit:]",
14613         "[:space:]",
14614         "[:^space:]",
14615         "[:cntrl:]",
14616         "[:^cntrl:]",
14617         "[:ascii:]",
14618         "[:^ascii:]",
14619         "[\\v]",
14620         "[\\V]"
14621     };
14622     RXi_GET_DECL(prog,progi);
14623     GET_RE_DEBUG_FLAGS_DECL;
14624     
14625     PERL_ARGS_ASSERT_REGPROP;
14626
14627     sv_setpvs(sv, "");
14628
14629     if (OP(o) > REGNODE_MAX)            /* regnode.type is unsigned */
14630         /* It would be nice to FAIL() here, but this may be called from
14631            regexec.c, and it would be hard to supply pRExC_state. */
14632         Perl_croak(aTHX_ "Corrupted regexp opcode %d > %d", (int)OP(o), (int)REGNODE_MAX);
14633     sv_catpv(sv, PL_reg_name[OP(o)]); /* Take off const! */
14634
14635     k = PL_regkind[OP(o)];
14636
14637     if (k == EXACT) {
14638         sv_catpvs(sv, " ");
14639         /* Using is_utf8_string() (via PERL_PV_UNI_DETECT) 
14640          * is a crude hack but it may be the best for now since 
14641          * we have no flag "this EXACTish node was UTF-8" 
14642          * --jhi */
14643         pv_pretty(sv, STRING(o), STR_LEN(o), 60, PL_colors[0], PL_colors[1],
14644                   PERL_PV_ESCAPE_UNI_DETECT |
14645                   PERL_PV_ESCAPE_NONASCII   |
14646                   PERL_PV_PRETTY_ELLIPSES   |
14647                   PERL_PV_PRETTY_LTGT       |
14648                   PERL_PV_PRETTY_NOCLEAR
14649                   );
14650     } else if (k == TRIE) {
14651         /* print the details of the trie in dumpuntil instead, as
14652          * progi->data isn't available here */
14653         const char op = OP(o);
14654         const U32 n = ARG(o);
14655         const reg_ac_data * const ac = IS_TRIE_AC(op) ?
14656                (reg_ac_data *)progi->data->data[n] :
14657                NULL;
14658         const reg_trie_data * const trie
14659             = (reg_trie_data*)progi->data->data[!IS_TRIE_AC(op) ? n : ac->trie];
14660         
14661         Perl_sv_catpvf(aTHX_ sv, "-%s",PL_reg_name[o->flags]);
14662         DEBUG_TRIE_COMPILE_r(
14663             Perl_sv_catpvf(aTHX_ sv,
14664                 "<S:%"UVuf"/%"IVdf" W:%"UVuf" L:%"UVuf"/%"UVuf" C:%"UVuf"/%"UVuf">",
14665                 (UV)trie->startstate,
14666                 (IV)trie->statecount-1, /* -1 because of the unused 0 element */
14667                 (UV)trie->wordcount,
14668                 (UV)trie->minlen,
14669                 (UV)trie->maxlen,
14670                 (UV)TRIE_CHARCOUNT(trie),
14671                 (UV)trie->uniquecharcount
14672             )
14673         );
14674         if ( IS_ANYOF_TRIE(op) || trie->bitmap ) {
14675             int i;
14676             int rangestart = -1;
14677             U8* bitmap = IS_ANYOF_TRIE(op) ? (U8*)ANYOF_BITMAP(o) : (U8*)TRIE_BITMAP(trie);
14678             sv_catpvs(sv, "[");
14679             for (i = 0; i <= 256; i++) {
14680                 if (i < 256 && BITMAP_TEST(bitmap,i)) {
14681                     if (rangestart == -1)
14682                         rangestart = i;
14683                 } else if (rangestart != -1) {
14684                     if (i <= rangestart + 3)
14685                         for (; rangestart < i; rangestart++)
14686                             put_byte(sv, rangestart);
14687                     else {
14688                         put_byte(sv, rangestart);
14689                         sv_catpvs(sv, "-");
14690                         put_byte(sv, i - 1);
14691                     }
14692                     rangestart = -1;
14693                 }
14694             }
14695             sv_catpvs(sv, "]");
14696         } 
14697          
14698     } else if (k == CURLY) {
14699         if (OP(o) == CURLYM || OP(o) == CURLYN || OP(o) == CURLYX)
14700             Perl_sv_catpvf(aTHX_ sv, "[%d]", o->flags); /* Parenth number */
14701         Perl_sv_catpvf(aTHX_ sv, " {%d,%d}", ARG1(o), ARG2(o));
14702     }
14703     else if (k == WHILEM && o->flags)                   /* Ordinal/of */
14704         Perl_sv_catpvf(aTHX_ sv, "[%d/%d]", o->flags & 0xf, o->flags>>4);
14705     else if (k == REF || k == OPEN || k == CLOSE || k == GROUPP || OP(o)==ACCEPT) {
14706         Perl_sv_catpvf(aTHX_ sv, "%d", (int)ARG(o));    /* Parenth number */
14707         if ( RXp_PAREN_NAMES(prog) ) {
14708             if ( k != REF || (OP(o) < NREF)) {
14709                 AV *list= MUTABLE_AV(progi->data->data[progi->name_list_idx]);
14710                 SV **name= av_fetch(list, ARG(o), 0 );
14711                 if (name)
14712                     Perl_sv_catpvf(aTHX_ sv, " '%"SVf"'", SVfARG(*name));
14713             }       
14714             else {
14715                 AV *list= MUTABLE_AV(progi->data->data[ progi->name_list_idx ]);
14716                 SV *sv_dat= MUTABLE_SV(progi->data->data[ ARG( o ) ]);
14717                 I32 *nums=(I32*)SvPVX(sv_dat);
14718                 SV **name= av_fetch(list, nums[0], 0 );
14719                 I32 n;
14720                 if (name) {
14721                     for ( n=0; n<SvIVX(sv_dat); n++ ) {
14722                         Perl_sv_catpvf(aTHX_ sv, "%s%"IVdf,
14723                                     (n ? "," : ""), (IV)nums[n]);
14724                     }
14725                     Perl_sv_catpvf(aTHX_ sv, " '%"SVf"'", SVfARG(*name));
14726                 }
14727             }
14728         }            
14729     } else if (k == GOSUB) 
14730         Perl_sv_catpvf(aTHX_ sv, "%d[%+d]", (int)ARG(o),(int)ARG2L(o)); /* Paren and offset */
14731     else if (k == VERB) {
14732         if (!o->flags) 
14733             Perl_sv_catpvf(aTHX_ sv, ":%"SVf, 
14734                            SVfARG((MUTABLE_SV(progi->data->data[ ARG( o ) ]))));
14735     } else if (k == LOGICAL)
14736         Perl_sv_catpvf(aTHX_ sv, "[%d]", o->flags);     /* 2: embedded, otherwise 1 */
14737     else if (k == ANYOF) {
14738         int i, rangestart = -1;
14739         const U8 flags = ANYOF_FLAGS(o);
14740         int do_sep = 0;
14741
14742
14743         if (flags & ANYOF_LOCALE)
14744             sv_catpvs(sv, "{loc}");
14745         if (flags & ANYOF_LOC_FOLD)
14746             sv_catpvs(sv, "{i}");
14747         Perl_sv_catpvf(aTHX_ sv, "[%s", PL_colors[0]);
14748         if (flags & ANYOF_INVERT)
14749             sv_catpvs(sv, "^");
14750
14751         /* output what the standard cp 0-255 bitmap matches */
14752         for (i = 0; i <= 256; i++) {
14753             if (i < 256 && ANYOF_BITMAP_TEST(o,i)) {
14754                 if (rangestart == -1)
14755                     rangestart = i;
14756             } else if (rangestart != -1) {
14757                 if (i <= rangestart + 3)
14758                     for (; rangestart < i; rangestart++)
14759                         put_byte(sv, rangestart);
14760                 else {
14761                     put_byte(sv, rangestart);
14762                     sv_catpvs(sv, "-");
14763                     put_byte(sv, i - 1);
14764                 }
14765                 do_sep = 1;
14766                 rangestart = -1;
14767             }
14768         }
14769         
14770         EMIT_ANYOF_TEST_SEPARATOR(do_sep,sv,flags);
14771         /* output any special charclass tests (used entirely under use locale) */
14772         if (ANYOF_CLASS_TEST_ANY_SET(o))
14773             for (i = 0; i < (int)(sizeof(anyofs)/sizeof(char*)); i++)
14774                 if (ANYOF_CLASS_TEST(o,i)) {
14775                     sv_catpv(sv, anyofs[i]);
14776                     do_sep = 1;
14777                 }
14778         
14779         EMIT_ANYOF_TEST_SEPARATOR(do_sep,sv,flags);
14780         
14781         if (flags & ANYOF_NON_UTF8_LATIN1_ALL) {
14782             sv_catpvs(sv, "{non-utf8-latin1-all}");
14783         }
14784
14785         /* output information about the unicode matching */
14786         if (flags & ANYOF_UNICODE_ALL)
14787             sv_catpvs(sv, "{unicode_all}");
14788         else if (ANYOF_NONBITMAP(o))
14789             sv_catpvs(sv, "{unicode}");
14790         if (flags & ANYOF_NONBITMAP_NON_UTF8)
14791             sv_catpvs(sv, "{outside bitmap}");
14792
14793         if (ANYOF_NONBITMAP(o)) {
14794             SV *lv; /* Set if there is something outside the bit map */
14795             SV * const sw = regclass_swash(prog, o, FALSE, &lv, NULL);
14796             bool byte_output = FALSE;   /* If something in the bitmap has been
14797                                            output */
14798
14799             if (lv && lv != &PL_sv_undef) {
14800                 if (sw) {
14801                     U8 s[UTF8_MAXBYTES_CASE+1];
14802
14803                     for (i = 0; i <= 256; i++) { /* Look at chars in bitmap */
14804                         uvchr_to_utf8(s, i);
14805
14806                         if (i < 256
14807                             && ! ANYOF_BITMAP_TEST(o, i)    /* Don't duplicate
14808                                                                things already
14809                                                                output as part
14810                                                                of the bitmap */
14811                             && swash_fetch(sw, s, TRUE))
14812                         {
14813                             if (rangestart == -1)
14814                                 rangestart = i;
14815                         } else if (rangestart != -1) {
14816                             byte_output = TRUE;
14817                             if (i <= rangestart + 3)
14818                                 for (; rangestart < i; rangestart++) {
14819                                     put_byte(sv, rangestart);
14820                                 }
14821                             else {
14822                                 put_byte(sv, rangestart);
14823                                 sv_catpvs(sv, "-");
14824                                 put_byte(sv, i-1);
14825                             }
14826                             rangestart = -1;
14827                         }
14828                     }
14829                 }
14830
14831                 {
14832                     char *s = savesvpv(lv);
14833                     char * const origs = s;
14834
14835                     while (*s && *s != '\n')
14836                         s++;
14837
14838                     if (*s == '\n') {
14839                         const char * const t = ++s;
14840
14841                         if (byte_output) {
14842                             sv_catpvs(sv, " ");
14843                         }
14844
14845                         while (*s) {
14846                             if (*s == '\n') {
14847
14848                                 /* Truncate very long output */
14849                                 if (s - origs > 256) {
14850                                     Perl_sv_catpvf(aTHX_ sv,
14851                                                    "%.*s...",
14852                                                    (int) (s - origs - 1),
14853                                                    t);
14854                                     goto out_dump;
14855                                 }
14856                                 *s = ' ';
14857                             }
14858                             else if (*s == '\t') {
14859                                 *s = '-';
14860                             }
14861                             s++;
14862                         }
14863                         if (s[-1] == ' ')
14864                             s[-1] = 0;
14865
14866                         sv_catpv(sv, t);
14867                     }
14868
14869                 out_dump:
14870
14871                     Safefree(origs);
14872                 }
14873                 SvREFCNT_dec_NN(lv);
14874             }
14875         }
14876
14877         Perl_sv_catpvf(aTHX_ sv, "%s]", PL_colors[1]);
14878     }
14879     else if (k == POSIXD || k == NPOSIXD) {
14880         U8 index = FLAGS(o) * 2;
14881         if (index > (sizeof(anyofs) / sizeof(anyofs[0]))) {
14882             Perl_sv_catpvf(aTHX_ sv, "[illegal type=%d])", index);
14883         }
14884         else {
14885             sv_catpv(sv, anyofs[index]);
14886         }
14887     }
14888     else if (k == BRANCHJ && (OP(o) == UNLESSM || OP(o) == IFMATCH))
14889         Perl_sv_catpvf(aTHX_ sv, "[%d]", -(o->flags));
14890 #else
14891     PERL_UNUSED_CONTEXT;
14892     PERL_UNUSED_ARG(sv);
14893     PERL_UNUSED_ARG(o);
14894     PERL_UNUSED_ARG(prog);
14895 #endif  /* DEBUGGING */
14896 }
14897
14898 SV *
14899 Perl_re_intuit_string(pTHX_ REGEXP * const r)
14900 {                               /* Assume that RE_INTUIT is set */
14901     dVAR;
14902     struct regexp *const prog = ReANY(r);
14903     GET_RE_DEBUG_FLAGS_DECL;
14904
14905     PERL_ARGS_ASSERT_RE_INTUIT_STRING;
14906     PERL_UNUSED_CONTEXT;
14907
14908     DEBUG_COMPILE_r(
14909         {
14910             const char * const s = SvPV_nolen_const(prog->check_substr
14911                       ? prog->check_substr : prog->check_utf8);
14912
14913             if (!PL_colorset) reginitcolors();
14914             PerlIO_printf(Perl_debug_log,
14915                       "%sUsing REx %ssubstr:%s \"%s%.60s%s%s\"\n",
14916                       PL_colors[4],
14917                       prog->check_substr ? "" : "utf8 ",
14918                       PL_colors[5],PL_colors[0],
14919                       s,
14920                       PL_colors[1],
14921                       (strlen(s) > 60 ? "..." : ""));
14922         } );
14923
14924     return prog->check_substr ? prog->check_substr : prog->check_utf8;
14925 }
14926
14927 /* 
14928    pregfree() 
14929    
14930    handles refcounting and freeing the perl core regexp structure. When 
14931    it is necessary to actually free the structure the first thing it 
14932    does is call the 'free' method of the regexp_engine associated to
14933    the regexp, allowing the handling of the void *pprivate; member 
14934    first. (This routine is not overridable by extensions, which is why 
14935    the extensions free is called first.)
14936    
14937    See regdupe and regdupe_internal if you change anything here. 
14938 */
14939 #ifndef PERL_IN_XSUB_RE
14940 void
14941 Perl_pregfree(pTHX_ REGEXP *r)
14942 {
14943     SvREFCNT_dec(r);
14944 }
14945
14946 void
14947 Perl_pregfree2(pTHX_ REGEXP *rx)
14948 {
14949     dVAR;
14950     struct regexp *const r = ReANY(rx);
14951     GET_RE_DEBUG_FLAGS_DECL;
14952
14953     PERL_ARGS_ASSERT_PREGFREE2;
14954
14955     if (r->mother_re) {
14956         ReREFCNT_dec(r->mother_re);
14957     } else {
14958         CALLREGFREE_PVT(rx); /* free the private data */
14959         SvREFCNT_dec(RXp_PAREN_NAMES(r));
14960         Safefree(r->xpv_len_u.xpvlenu_pv);
14961     }        
14962     if (r->substrs) {
14963         SvREFCNT_dec(r->anchored_substr);
14964         SvREFCNT_dec(r->anchored_utf8);
14965         SvREFCNT_dec(r->float_substr);
14966         SvREFCNT_dec(r->float_utf8);
14967         Safefree(r->substrs);
14968     }
14969     RX_MATCH_COPY_FREE(rx);
14970 #ifdef PERL_ANY_COW
14971     SvREFCNT_dec(r->saved_copy);
14972 #endif
14973     Safefree(r->offs);
14974     SvREFCNT_dec(r->qr_anoncv);
14975     rx->sv_u.svu_rx = 0;
14976 }
14977
14978 /*  reg_temp_copy()
14979     
14980     This is a hacky workaround to the structural issue of match results
14981     being stored in the regexp structure which is in turn stored in
14982     PL_curpm/PL_reg_curpm. The problem is that due to qr// the pattern
14983     could be PL_curpm in multiple contexts, and could require multiple
14984     result sets being associated with the pattern simultaneously, such
14985     as when doing a recursive match with (??{$qr})
14986     
14987     The solution is to make a lightweight copy of the regexp structure 
14988     when a qr// is returned from the code executed by (??{$qr}) this
14989     lightweight copy doesn't actually own any of its data except for
14990     the starp/end and the actual regexp structure itself. 
14991     
14992 */    
14993     
14994     
14995 REGEXP *
14996 Perl_reg_temp_copy (pTHX_ REGEXP *ret_x, REGEXP *rx)
14997 {
14998     struct regexp *ret;
14999     struct regexp *const r = ReANY(rx);
15000     const bool islv = ret_x && SvTYPE(ret_x) == SVt_PVLV;
15001
15002     PERL_ARGS_ASSERT_REG_TEMP_COPY;
15003
15004     if (!ret_x)
15005         ret_x = (REGEXP*) newSV_type(SVt_REGEXP);
15006     else {
15007         SvOK_off((SV *)ret_x);
15008         if (islv) {
15009             /* For PVLVs, SvANY points to the xpvlv body while sv_u points
15010                to the regexp.  (For SVt_REGEXPs, sv_upgrade has already
15011                made both spots point to the same regexp body.) */
15012             REGEXP *temp = (REGEXP *)newSV_type(SVt_REGEXP);
15013             assert(!SvPVX(ret_x));
15014             ret_x->sv_u.svu_rx = temp->sv_any;
15015             temp->sv_any = NULL;
15016             SvFLAGS(temp) = (SvFLAGS(temp) & ~SVTYPEMASK) | SVt_NULL;
15017             SvREFCNT_dec_NN(temp);
15018             /* SvCUR still resides in the xpvlv struct, so the regexp copy-
15019                ing below will not set it. */
15020             SvCUR_set(ret_x, SvCUR(rx));
15021         }
15022     }
15023     /* This ensures that SvTHINKFIRST(sv) is true, and hence that
15024        sv_force_normal(sv) is called.  */
15025     SvFAKE_on(ret_x);
15026     ret = ReANY(ret_x);
15027     
15028     SvFLAGS(ret_x) |= SvUTF8(rx);
15029     /* We share the same string buffer as the original regexp, on which we
15030        hold a reference count, incremented when mother_re is set below.
15031        The string pointer is copied here, being part of the regexp struct.
15032      */
15033     memcpy(&(ret->xpv_cur), &(r->xpv_cur),
15034            sizeof(regexp) - STRUCT_OFFSET(regexp, xpv_cur));
15035     if (r->offs) {
15036         const I32 npar = r->nparens+1;
15037         Newx(ret->offs, npar, regexp_paren_pair);
15038         Copy(r->offs, ret->offs, npar, regexp_paren_pair);
15039     }
15040     if (r->substrs) {
15041         Newx(ret->substrs, 1, struct reg_substr_data);
15042         StructCopy(r->substrs, ret->substrs, struct reg_substr_data);
15043
15044         SvREFCNT_inc_void(ret->anchored_substr);
15045         SvREFCNT_inc_void(ret->anchored_utf8);
15046         SvREFCNT_inc_void(ret->float_substr);
15047         SvREFCNT_inc_void(ret->float_utf8);
15048
15049         /* check_substr and check_utf8, if non-NULL, point to either their
15050            anchored or float namesakes, and don't hold a second reference.  */
15051     }
15052     RX_MATCH_COPIED_off(ret_x);
15053 #ifdef PERL_ANY_COW
15054     ret->saved_copy = NULL;
15055 #endif
15056     ret->mother_re = ReREFCNT_inc(r->mother_re ? r->mother_re : rx);
15057     SvREFCNT_inc_void(ret->qr_anoncv);
15058     
15059     return ret_x;
15060 }
15061 #endif
15062
15063 /* regfree_internal() 
15064
15065    Free the private data in a regexp. This is overloadable by 
15066    extensions. Perl takes care of the regexp structure in pregfree(), 
15067    this covers the *pprivate pointer which technically perl doesn't 
15068    know about, however of course we have to handle the 
15069    regexp_internal structure when no extension is in use. 
15070    
15071    Note this is called before freeing anything in the regexp 
15072    structure. 
15073  */
15074  
15075 void
15076 Perl_regfree_internal(pTHX_ REGEXP * const rx)
15077 {
15078     dVAR;
15079     struct regexp *const r = ReANY(rx);
15080     RXi_GET_DECL(r,ri);
15081     GET_RE_DEBUG_FLAGS_DECL;
15082
15083     PERL_ARGS_ASSERT_REGFREE_INTERNAL;
15084
15085     DEBUG_COMPILE_r({
15086         if (!PL_colorset)
15087             reginitcolors();
15088         {
15089             SV *dsv= sv_newmortal();
15090             RE_PV_QUOTED_DECL(s, RX_UTF8(rx),
15091                 dsv, RX_PRECOMP(rx), RX_PRELEN(rx), 60);
15092             PerlIO_printf(Perl_debug_log,"%sFreeing REx:%s %s\n", 
15093                 PL_colors[4],PL_colors[5],s);
15094         }
15095     });
15096 #ifdef RE_TRACK_PATTERN_OFFSETS
15097     if (ri->u.offsets)
15098         Safefree(ri->u.offsets);             /* 20010421 MJD */
15099 #endif
15100     if (ri->code_blocks) {
15101         int n;
15102         for (n = 0; n < ri->num_code_blocks; n++)
15103             SvREFCNT_dec(ri->code_blocks[n].src_regex);
15104         Safefree(ri->code_blocks);
15105     }
15106
15107     if (ri->data) {
15108         int n = ri->data->count;
15109
15110         while (--n >= 0) {
15111           /* If you add a ->what type here, update the comment in regcomp.h */
15112             switch (ri->data->what[n]) {
15113             case 'a':
15114             case 'r':
15115             case 's':
15116             case 'S':
15117             case 'u':
15118                 SvREFCNT_dec(MUTABLE_SV(ri->data->data[n]));
15119                 break;
15120             case 'f':
15121                 Safefree(ri->data->data[n]);
15122                 break;
15123             case 'l':
15124             case 'L':
15125                 break;
15126             case 'T':           
15127                 { /* Aho Corasick add-on structure for a trie node.
15128                      Used in stclass optimization only */
15129                     U32 refcount;
15130                     reg_ac_data *aho=(reg_ac_data*)ri->data->data[n];
15131                     OP_REFCNT_LOCK;
15132                     refcount = --aho->refcount;
15133                     OP_REFCNT_UNLOCK;
15134                     if ( !refcount ) {
15135                         PerlMemShared_free(aho->states);
15136                         PerlMemShared_free(aho->fail);
15137                          /* do this last!!!! */
15138                         PerlMemShared_free(ri->data->data[n]);
15139                         PerlMemShared_free(ri->regstclass);
15140                     }
15141                 }
15142                 break;
15143             case 't':
15144                 {
15145                     /* trie structure. */
15146                     U32 refcount;
15147                     reg_trie_data *trie=(reg_trie_data*)ri->data->data[n];
15148                     OP_REFCNT_LOCK;
15149                     refcount = --trie->refcount;
15150                     OP_REFCNT_UNLOCK;
15151                     if ( !refcount ) {
15152                         PerlMemShared_free(trie->charmap);
15153                         PerlMemShared_free(trie->states);
15154                         PerlMemShared_free(trie->trans);
15155                         if (trie->bitmap)
15156                             PerlMemShared_free(trie->bitmap);
15157                         if (trie->jump)
15158                             PerlMemShared_free(trie->jump);
15159                         PerlMemShared_free(trie->wordinfo);
15160                         /* do this last!!!! */
15161                         PerlMemShared_free(ri->data->data[n]);
15162                     }
15163                 }
15164                 break;
15165             default:
15166                 Perl_croak(aTHX_ "panic: regfree data code '%c'", ri->data->what[n]);
15167             }
15168         }
15169         Safefree(ri->data->what);
15170         Safefree(ri->data);
15171     }
15172
15173     Safefree(ri);
15174 }
15175
15176 #define av_dup_inc(s,t) MUTABLE_AV(sv_dup_inc((const SV *)s,t))
15177 #define hv_dup_inc(s,t) MUTABLE_HV(sv_dup_inc((const SV *)s,t))
15178 #define SAVEPVN(p,n)    ((p) ? savepvn(p,n) : NULL)
15179
15180 /* 
15181    re_dup - duplicate a regexp. 
15182    
15183    This routine is expected to clone a given regexp structure. It is only
15184    compiled under USE_ITHREADS.
15185
15186    After all of the core data stored in struct regexp is duplicated
15187    the regexp_engine.dupe method is used to copy any private data
15188    stored in the *pprivate pointer. This allows extensions to handle
15189    any duplication it needs to do.
15190
15191    See pregfree() and regfree_internal() if you change anything here. 
15192 */
15193 #if defined(USE_ITHREADS)
15194 #ifndef PERL_IN_XSUB_RE
15195 void
15196 Perl_re_dup_guts(pTHX_ const REGEXP *sstr, REGEXP *dstr, CLONE_PARAMS *param)
15197 {
15198     dVAR;
15199     I32 npar;
15200     const struct regexp *r = ReANY(sstr);
15201     struct regexp *ret = ReANY(dstr);
15202     
15203     PERL_ARGS_ASSERT_RE_DUP_GUTS;
15204
15205     npar = r->nparens+1;
15206     Newx(ret->offs, npar, regexp_paren_pair);
15207     Copy(r->offs, ret->offs, npar, regexp_paren_pair);
15208
15209     if (ret->substrs) {
15210         /* Do it this way to avoid reading from *r after the StructCopy().
15211            That way, if any of the sv_dup_inc()s dislodge *r from the L1
15212            cache, it doesn't matter.  */
15213         const bool anchored = r->check_substr
15214             ? r->check_substr == r->anchored_substr
15215             : r->check_utf8 == r->anchored_utf8;
15216         Newx(ret->substrs, 1, struct reg_substr_data);
15217         StructCopy(r->substrs, ret->substrs, struct reg_substr_data);
15218
15219         ret->anchored_substr = sv_dup_inc(ret->anchored_substr, param);
15220         ret->anchored_utf8 = sv_dup_inc(ret->anchored_utf8, param);
15221         ret->float_substr = sv_dup_inc(ret->float_substr, param);
15222         ret->float_utf8 = sv_dup_inc(ret->float_utf8, param);
15223
15224         /* check_substr and check_utf8, if non-NULL, point to either their
15225            anchored or float namesakes, and don't hold a second reference.  */
15226
15227         if (ret->check_substr) {
15228             if (anchored) {
15229                 assert(r->check_utf8 == r->anchored_utf8);
15230                 ret->check_substr = ret->anchored_substr;
15231                 ret->check_utf8 = ret->anchored_utf8;
15232             } else {
15233                 assert(r->check_substr == r->float_substr);
15234                 assert(r->check_utf8 == r->float_utf8);
15235                 ret->check_substr = ret->float_substr;
15236                 ret->check_utf8 = ret->float_utf8;
15237             }
15238         } else if (ret->check_utf8) {
15239             if (anchored) {
15240                 ret->check_utf8 = ret->anchored_utf8;
15241             } else {
15242                 ret->check_utf8 = ret->float_utf8;
15243             }
15244         }
15245     }
15246
15247     RXp_PAREN_NAMES(ret) = hv_dup_inc(RXp_PAREN_NAMES(ret), param);
15248     ret->qr_anoncv = MUTABLE_CV(sv_dup_inc((const SV *)ret->qr_anoncv, param));
15249
15250     if (ret->pprivate)
15251         RXi_SET(ret,CALLREGDUPE_PVT(dstr,param));
15252
15253     if (RX_MATCH_COPIED(dstr))
15254         ret->subbeg  = SAVEPVN(ret->subbeg, ret->sublen);
15255     else
15256         ret->subbeg = NULL;
15257 #ifdef PERL_ANY_COW
15258     ret->saved_copy = NULL;
15259 #endif
15260
15261     /* Whether mother_re be set or no, we need to copy the string.  We
15262        cannot refrain from copying it when the storage points directly to
15263        our mother regexp, because that's
15264                1: a buffer in a different thread
15265                2: something we no longer hold a reference on
15266                so we need to copy it locally.  */
15267     RX_WRAPPED(dstr) = SAVEPVN(RX_WRAPPED(sstr), SvCUR(sstr)+1);
15268     ret->mother_re   = NULL;
15269     ret->gofs = 0;
15270 }
15271 #endif /* PERL_IN_XSUB_RE */
15272
15273 /*
15274    regdupe_internal()
15275    
15276    This is the internal complement to regdupe() which is used to copy
15277    the structure pointed to by the *pprivate pointer in the regexp.
15278    This is the core version of the extension overridable cloning hook.
15279    The regexp structure being duplicated will be copied by perl prior
15280    to this and will be provided as the regexp *r argument, however 
15281    with the /old/ structures pprivate pointer value. Thus this routine
15282    may override any copying normally done by perl.
15283    
15284    It returns a pointer to the new regexp_internal structure.
15285 */
15286
15287 void *
15288 Perl_regdupe_internal(pTHX_ REGEXP * const rx, CLONE_PARAMS *param)
15289 {
15290     dVAR;
15291     struct regexp *const r = ReANY(rx);
15292     regexp_internal *reti;
15293     int len;
15294     RXi_GET_DECL(r,ri);
15295
15296     PERL_ARGS_ASSERT_REGDUPE_INTERNAL;
15297     
15298     len = ProgLen(ri);
15299     
15300     Newxc(reti, sizeof(regexp_internal) + len*sizeof(regnode), char, regexp_internal);
15301     Copy(ri->program, reti->program, len+1, regnode);
15302
15303     reti->num_code_blocks = ri->num_code_blocks;
15304     if (ri->code_blocks) {
15305         int n;
15306         Newxc(reti->code_blocks, ri->num_code_blocks, struct reg_code_block,
15307                 struct reg_code_block);
15308         Copy(ri->code_blocks, reti->code_blocks, ri->num_code_blocks,
15309                 struct reg_code_block);
15310         for (n = 0; n < ri->num_code_blocks; n++)
15311              reti->code_blocks[n].src_regex = (REGEXP*)
15312                     sv_dup_inc((SV*)(ri->code_blocks[n].src_regex), param);
15313     }
15314     else
15315         reti->code_blocks = NULL;
15316
15317     reti->regstclass = NULL;
15318
15319     if (ri->data) {
15320         struct reg_data *d;
15321         const int count = ri->data->count;
15322         int i;
15323
15324         Newxc(d, sizeof(struct reg_data) + count*sizeof(void *),
15325                 char, struct reg_data);
15326         Newx(d->what, count, U8);
15327
15328         d->count = count;
15329         for (i = 0; i < count; i++) {
15330             d->what[i] = ri->data->what[i];
15331             switch (d->what[i]) {
15332                 /* see also regcomp.h and regfree_internal() */
15333             case 'a': /* actually an AV, but the dup function is identical.  */
15334             case 'r':
15335             case 's':
15336             case 'S':
15337             case 'u': /* actually an HV, but the dup function is identical.  */
15338                 d->data[i] = sv_dup_inc((const SV *)ri->data->data[i], param);
15339                 break;
15340             case 'f':
15341                 /* This is cheating. */
15342                 Newx(d->data[i], 1, struct regnode_charclass_class);
15343                 StructCopy(ri->data->data[i], d->data[i],
15344                             struct regnode_charclass_class);
15345                 reti->regstclass = (regnode*)d->data[i];
15346                 break;
15347             case 'T':
15348                 /* Trie stclasses are readonly and can thus be shared
15349                  * without duplication. We free the stclass in pregfree
15350                  * when the corresponding reg_ac_data struct is freed.
15351                  */
15352                 reti->regstclass= ri->regstclass;
15353                 /* Fall through */
15354             case 't':
15355                 OP_REFCNT_LOCK;
15356                 ((reg_trie_data*)ri->data->data[i])->refcount++;
15357                 OP_REFCNT_UNLOCK;
15358                 /* Fall through */
15359             case 'l':
15360             case 'L':
15361                 d->data[i] = ri->data->data[i];
15362                 break;
15363             default:
15364                 Perl_croak(aTHX_ "panic: re_dup unknown data code '%c'", ri->data->what[i]);
15365             }
15366         }
15367
15368         reti->data = d;
15369     }
15370     else
15371         reti->data = NULL;
15372
15373     reti->name_list_idx = ri->name_list_idx;
15374
15375 #ifdef RE_TRACK_PATTERN_OFFSETS
15376     if (ri->u.offsets) {
15377         Newx(reti->u.offsets, 2*len+1, U32);
15378         Copy(ri->u.offsets, reti->u.offsets, 2*len+1, U32);
15379     }
15380 #else
15381     SetProgLen(reti,len);
15382 #endif
15383
15384     return (void*)reti;
15385 }
15386
15387 #endif    /* USE_ITHREADS */
15388
15389 #ifndef PERL_IN_XSUB_RE
15390
15391 /*
15392  - regnext - dig the "next" pointer out of a node
15393  */
15394 regnode *
15395 Perl_regnext(pTHX_ regnode *p)
15396 {
15397     dVAR;
15398     I32 offset;
15399
15400     if (!p)
15401         return(NULL);
15402
15403     if (OP(p) > REGNODE_MAX) {          /* regnode.type is unsigned */
15404         Perl_croak(aTHX_ "Corrupted regexp opcode %d > %d", (int)OP(p), (int)REGNODE_MAX);
15405     }
15406
15407     offset = (reg_off_by_arg[OP(p)] ? ARG(p) : NEXT_OFF(p));
15408     if (offset == 0)
15409         return(NULL);
15410
15411     return(p+offset);
15412 }
15413 #endif
15414
15415 STATIC void
15416 S_re_croak2(pTHX_ const char* pat1,const char* pat2,...)
15417 {
15418     va_list args;
15419     STRLEN l1 = strlen(pat1);
15420     STRLEN l2 = strlen(pat2);
15421     char buf[512];
15422     SV *msv;
15423     const char *message;
15424
15425     PERL_ARGS_ASSERT_RE_CROAK2;
15426
15427     if (l1 > 510)
15428         l1 = 510;
15429     if (l1 + l2 > 510)
15430         l2 = 510 - l1;
15431     Copy(pat1, buf, l1 , char);
15432     Copy(pat2, buf + l1, l2 , char);
15433     buf[l1 + l2] = '\n';
15434     buf[l1 + l2 + 1] = '\0';
15435 #ifdef I_STDARG
15436     /* ANSI variant takes additional second argument */
15437     va_start(args, pat2);
15438 #else
15439     va_start(args);
15440 #endif
15441     msv = vmess(buf, &args);
15442     va_end(args);
15443     message = SvPV_const(msv,l1);
15444     if (l1 > 512)
15445         l1 = 512;
15446     Copy(message, buf, l1 , char);
15447     buf[l1-1] = '\0';                   /* Overwrite \n */
15448     Perl_croak(aTHX_ "%s", buf);
15449 }
15450
15451 /* XXX Here's a total kludge.  But we need to re-enter for swash routines. */
15452
15453 #ifndef PERL_IN_XSUB_RE
15454 void
15455 Perl_save_re_context(pTHX)
15456 {
15457     dVAR;
15458
15459     struct re_save_state *state;
15460
15461     SAVEVPTR(PL_curcop);
15462     SSGROW(SAVESTACK_ALLOC_FOR_RE_SAVE_STATE + 1);
15463
15464     state = (struct re_save_state *)(PL_savestack + PL_savestack_ix);
15465     PL_savestack_ix += SAVESTACK_ALLOC_FOR_RE_SAVE_STATE;
15466     SSPUSHUV(SAVEt_RE_STATE);
15467
15468     Copy(&PL_reg_state, state, 1, struct re_save_state);
15469
15470     PL_reg_oldsaved = NULL;
15471     PL_reg_oldsavedlen = 0;
15472     PL_reg_oldsavedoffset = 0;
15473     PL_reg_oldsavedcoffset = 0;
15474     PL_reg_maxiter = 0;
15475     PL_reg_leftiter = 0;
15476     PL_reg_poscache = NULL;
15477     PL_reg_poscache_size = 0;
15478 #ifdef PERL_ANY_COW
15479     PL_nrs = NULL;
15480 #endif
15481
15482     /* Save $1..$n (#18107: UTF-8 s/(\w+)/uc($1)/e); AMS 20021106. */
15483     if (PL_curpm) {
15484         const REGEXP * const rx = PM_GETRE(PL_curpm);
15485         if (rx) {
15486             U32 i;
15487             for (i = 1; i <= RX_NPARENS(rx); i++) {
15488                 char digits[TYPE_CHARS(long)];
15489                 const STRLEN len = my_snprintf(digits, sizeof(digits), "%lu", (long)i);
15490                 GV *const *const gvp
15491                     = (GV**)hv_fetch(PL_defstash, digits, len, 0);
15492
15493                 if (gvp) {
15494                     GV * const gv = *gvp;
15495                     if (SvTYPE(gv) == SVt_PVGV && GvSV(gv))
15496                         save_scalar(gv);
15497                 }
15498             }
15499         }
15500     }
15501 }
15502 #endif
15503
15504 #ifdef DEBUGGING
15505
15506 STATIC void
15507 S_put_byte(pTHX_ SV *sv, int c)
15508 {
15509     PERL_ARGS_ASSERT_PUT_BYTE;
15510
15511     /* Our definition of isPRINT() ignores locales, so only bytes that are
15512        not part of UTF-8 are considered printable. I assume that the same
15513        holds for UTF-EBCDIC.
15514        Also, code point 255 is not printable in either (it's E0 in EBCDIC,
15515        which Wikipedia says:
15516
15517        EO, or Eight Ones, is an 8-bit EBCDIC character code represented as all
15518        ones (binary 1111 1111, hexadecimal FF). It is similar, but not
15519        identical, to the ASCII delete (DEL) or rubout control character. ...
15520        it is typically mapped to hexadecimal code 9F, in order to provide a
15521        unique character mapping in both directions)
15522
15523        So the old condition can be simplified to !isPRINT(c)  */
15524     if (!isPRINT(c)) {
15525         if (c < 256) {
15526             Perl_sv_catpvf(aTHX_ sv, "\\x%02x", c);
15527         }
15528         else {
15529             Perl_sv_catpvf(aTHX_ sv, "\\x{%x}", c);
15530         }
15531     }
15532     else {
15533         const char string = c;
15534         if (c == '-' || c == ']' || c == '\\' || c == '^')
15535             sv_catpvs(sv, "\\");
15536         sv_catpvn(sv, &string, 1);
15537     }
15538 }
15539
15540
15541 #define CLEAR_OPTSTART \
15542     if (optstart) STMT_START { \
15543             DEBUG_OPTIMISE_r(PerlIO_printf(Perl_debug_log, " (%"IVdf" nodes)\n", (IV)(node - optstart))); \
15544             optstart=NULL; \
15545     } STMT_END
15546
15547 #define DUMPUNTIL(b,e) CLEAR_OPTSTART; node=dumpuntil(r,start,(b),(e),last,sv,indent+1,depth+1);
15548
15549 STATIC const regnode *
15550 S_dumpuntil(pTHX_ const regexp *r, const regnode *start, const regnode *node,
15551             const regnode *last, const regnode *plast, 
15552             SV* sv, I32 indent, U32 depth)
15553 {
15554     dVAR;
15555     U8 op = PSEUDO;     /* Arbitrary non-END op. */
15556     const regnode *next;
15557     const regnode *optstart= NULL;
15558     
15559     RXi_GET_DECL(r,ri);
15560     GET_RE_DEBUG_FLAGS_DECL;
15561
15562     PERL_ARGS_ASSERT_DUMPUNTIL;
15563
15564 #ifdef DEBUG_DUMPUNTIL
15565     PerlIO_printf(Perl_debug_log, "--- %d : %d - %d - %d\n",indent,node-start,
15566         last ? last-start : 0,plast ? plast-start : 0);
15567 #endif
15568             
15569     if (plast && plast < last) 
15570         last= plast;
15571
15572     while (PL_regkind[op] != END && (!last || node < last)) {
15573         /* While that wasn't END last time... */
15574         NODE_ALIGN(node);
15575         op = OP(node);
15576         if (op == CLOSE || op == WHILEM)
15577             indent--;
15578         next = regnext((regnode *)node);
15579
15580         /* Where, what. */
15581         if (OP(node) == OPTIMIZED) {
15582             if (!optstart && RE_DEBUG_FLAG(RE_DEBUG_COMPILE_OPTIMISE))
15583                 optstart = node;
15584             else
15585                 goto after_print;
15586         } else
15587             CLEAR_OPTSTART;
15588
15589         regprop(r, sv, node);
15590         PerlIO_printf(Perl_debug_log, "%4"IVdf":%*s%s", (IV)(node - start),
15591                       (int)(2*indent + 1), "", SvPVX_const(sv));
15592         
15593         if (OP(node) != OPTIMIZED) {                  
15594             if (next == NULL)           /* Next ptr. */
15595                 PerlIO_printf(Perl_debug_log, " (0)");
15596             else if (PL_regkind[(U8)op] == BRANCH && PL_regkind[OP(next)] != BRANCH )
15597                 PerlIO_printf(Perl_debug_log, " (FAIL)");
15598             else 
15599                 PerlIO_printf(Perl_debug_log, " (%"IVdf")", (IV)(next - start));
15600             (void)PerlIO_putc(Perl_debug_log, '\n'); 
15601         }
15602         
15603       after_print:
15604         if (PL_regkind[(U8)op] == BRANCHJ) {
15605             assert(next);
15606             {
15607                 const regnode *nnode = (OP(next) == LONGJMP
15608                                        ? regnext((regnode *)next)
15609                                        : next);
15610                 if (last && nnode > last)
15611                     nnode = last;
15612                 DUMPUNTIL(NEXTOPER(NEXTOPER(node)), nnode);
15613             }
15614         }
15615         else if (PL_regkind[(U8)op] == BRANCH) {
15616             assert(next);
15617             DUMPUNTIL(NEXTOPER(node), next);
15618         }
15619         else if ( PL_regkind[(U8)op]  == TRIE ) {
15620             const regnode *this_trie = node;
15621             const char op = OP(node);
15622             const U32 n = ARG(node);
15623             const reg_ac_data * const ac = op>=AHOCORASICK ?
15624                (reg_ac_data *)ri->data->data[n] :
15625                NULL;
15626             const reg_trie_data * const trie =
15627                 (reg_trie_data*)ri->data->data[op<AHOCORASICK ? n : ac->trie];
15628 #ifdef DEBUGGING
15629             AV *const trie_words = MUTABLE_AV(ri->data->data[n + TRIE_WORDS_OFFSET]);
15630 #endif
15631             const regnode *nextbranch= NULL;
15632             I32 word_idx;
15633             sv_setpvs(sv, "");
15634             for (word_idx= 0; word_idx < (I32)trie->wordcount; word_idx++) {
15635                 SV ** const elem_ptr = av_fetch(trie_words,word_idx,0);
15636
15637                 PerlIO_printf(Perl_debug_log, "%*s%s ",
15638                    (int)(2*(indent+3)), "",
15639                     elem_ptr ? pv_pretty(sv, SvPV_nolen_const(*elem_ptr), SvCUR(*elem_ptr), 60,
15640                             PL_colors[0], PL_colors[1],
15641                             (SvUTF8(*elem_ptr) ? PERL_PV_ESCAPE_UNI : 0) |
15642                             PERL_PV_PRETTY_ELLIPSES    |
15643                             PERL_PV_PRETTY_LTGT
15644                             )
15645                             : "???"
15646                 );
15647                 if (trie->jump) {
15648                     U16 dist= trie->jump[word_idx+1];
15649                     PerlIO_printf(Perl_debug_log, "(%"UVuf")\n",
15650                                   (UV)((dist ? this_trie + dist : next) - start));
15651                     if (dist) {
15652                         if (!nextbranch)
15653                             nextbranch= this_trie + trie->jump[0];    
15654                         DUMPUNTIL(this_trie + dist, nextbranch);
15655                     }
15656                     if (nextbranch && PL_regkind[OP(nextbranch)]==BRANCH)
15657                         nextbranch= regnext((regnode *)nextbranch);
15658                 } else {
15659                     PerlIO_printf(Perl_debug_log, "\n");
15660                 }
15661             }
15662             if (last && next > last)
15663                 node= last;
15664             else
15665                 node= next;
15666         }
15667         else if ( op == CURLY ) {   /* "next" might be very big: optimizer */
15668             DUMPUNTIL(NEXTOPER(node) + EXTRA_STEP_2ARGS,
15669                     NEXTOPER(node) + EXTRA_STEP_2ARGS + 1);
15670         }
15671         else if (PL_regkind[(U8)op] == CURLY && op != CURLYX) {
15672             assert(next);
15673             DUMPUNTIL(NEXTOPER(node) + EXTRA_STEP_2ARGS, next);
15674         }
15675         else if ( op == PLUS || op == STAR) {
15676             DUMPUNTIL(NEXTOPER(node), NEXTOPER(node) + 1);
15677         }
15678         else if (PL_regkind[(U8)op] == ANYOF) {
15679             /* arglen 1 + class block */
15680             node += 1 + ((ANYOF_FLAGS(node) & ANYOF_CLASS)
15681                     ? ANYOF_CLASS_SKIP : ANYOF_SKIP);
15682             node = NEXTOPER(node);
15683         }
15684         else if (PL_regkind[(U8)op] == EXACT) {
15685             /* Literal string, where present. */
15686             node += NODE_SZ_STR(node) - 1;
15687             node = NEXTOPER(node);
15688         }
15689         else {
15690             node = NEXTOPER(node);
15691             node += regarglen[(U8)op];
15692         }
15693         if (op == CURLYX || op == OPEN)
15694             indent++;
15695     }
15696     CLEAR_OPTSTART;
15697 #ifdef DEBUG_DUMPUNTIL    
15698     PerlIO_printf(Perl_debug_log, "--- %d\n", (int)indent);
15699 #endif
15700     return node;
15701 }
15702
15703 #endif  /* DEBUGGING */
15704
15705 /*
15706  * Local variables:
15707  * c-indentation-style: bsd
15708  * c-basic-offset: 4
15709  * indent-tabs-mode: nil
15710  * End:
15711  *
15712  * ex: set ts=8 sts=4 sw=4 et:
15713  */