1 // Copyright 2003-2010 Google Inc. All Rights Reserved.
2 // Use of this source code is governed by a BSD-style
3 // license that can be found in the LICENSE file.
4
5 #ifndef UTIL_PCRE_H_
6 #define UTIL_PCRE_H_
7
8 // This is a variant of PCRE's pcrecpp.h, originally written at Google.
9 // The main changes are the addition of the HitLimit method and
10 // compilation as PCRE in namespace re2.
11
12 // C++ interface to the pcre regular-expression library. PCRE supports
13 // Perl-style regular expressions (with extensions like \d, \w, \s,
14 // ...).
15 //
16 // -----------------------------------------------------------------------
17 // REGEXP SYNTAX:
18 //
19 // This module uses the pcre library and hence supports its syntax
20 // for regular expressions:
21 //
22 // http://www.google.com/search?q=pcre
23 //
24 // The syntax is pretty similar to Perl's. For those not familiar
25 // with Perl's regular expressions, here are some examples of the most
26 // commonly used extensions:
27 //
28 // "hello (\\w+) world" -- \w matches a "word" character
29 // "version (\\d+)" -- \d matches a digit
30 // "hello\\s+world" -- \s matches any whitespace character
31 // "\\b(\\w+)\\b" -- \b matches empty string at a word boundary
32 // "(?i)hello" -- (?i) turns on case-insensitive matching
33 // "/\\*(.*?)\\*/" -- .*? matches . minimum no. of times possible
34 //
35 // -----------------------------------------------------------------------
36 // MATCHING INTERFACE:
37 //
38 // The "FullMatch" operation checks that supplied text matches a
39 // supplied pattern exactly.
40 //
41 // Example: successful match
42 // CHECK(PCRE::FullMatch("hello", "h.*o"));
43 //
44 // Example: unsuccessful match (requires full match):
45 // CHECK(!PCRE::FullMatch("hello", "e"));
46 //
47 // -----------------------------------------------------------------------
48 // UTF-8 AND THE MATCHING INTERFACE:
49 //
50 // By default, pattern and text are plain text, one byte per character.
51 // The UTF8 flag, passed to the constructor, causes both pattern
52 // and string to be treated as UTF-8 text, still a byte stream but
53 // potentially multiple bytes per character. In practice, the text
54 // is likelier to be UTF-8 than the pattern, but the match returned
55 // may depend on the UTF8 flag, so always use it when matching
56 // UTF8 text. E.g., "." will match one byte normally but with UTF8
57 // set may match up to three bytes of a multi-byte character.
58 //
59 // Example:
60 // PCRE re(utf8_pattern, PCRE::UTF8);
61 // CHECK(PCRE::FullMatch(utf8_string, re));
62 //
63 // -----------------------------------------------------------------------
64 // MATCHING WITH SUBSTRING EXTRACTION:
65 //
66 // You can supply extra pointer arguments to extract matched substrings.
67 //
68 // Example: extracts "ruby" into "s" and 1234 into "i"
69 // int i;
70 // std::string s;
71 // CHECK(PCRE::FullMatch("ruby:1234", "(\\w+):(\\d+)", &s, &i));
72 //
73 // Example: fails because string cannot be stored in integer
74 // CHECK(!PCRE::FullMatch("ruby", "(.*)", &i));
75 //
76 // Example: fails because there aren't enough sub-patterns:
77 // CHECK(!PCRE::FullMatch("ruby:1234", "\\w+:\\d+", &s));
78 //
79 // Example: does not try to extract any extra sub-patterns
80 // CHECK(PCRE::FullMatch("ruby:1234", "(\\w+):(\\d+)", &s));
81 //
82 // Example: does not try to extract into NULL
83 // CHECK(PCRE::FullMatch("ruby:1234", "(\\w+):(\\d+)", NULL, &i));
84 //
85 // Example: integer overflow causes failure
86 // CHECK(!PCRE::FullMatch("ruby:1234567891234", "\\w+:(\\d+)", &i));
87 //
88 // -----------------------------------------------------------------------
89 // PARTIAL MATCHES
90 //
91 // You can use the "PartialMatch" operation when you want the pattern
92 // to match any substring of the text.
93 //
94 // Example: simple search for a string:
95 // CHECK(PCRE::PartialMatch("hello", "ell"));
96 //
97 // Example: find first number in a string
98 // int number;
99 // CHECK(PCRE::PartialMatch("x*100 + 20", "(\\d+)", &number));
100 // CHECK_EQ(number, 100);
101 //
102 // -----------------------------------------------------------------------
103 // PPCRE-COMPILED PCREGULAR EXPPCRESSIONS
104 //
105 // PCRE makes it easy to use any string as a regular expression, without
106 // requiring a separate compilation step.
107 //
108 // If speed is of the essence, you can create a pre-compiled "PCRE"
109 // object from the pattern and use it multiple times. If you do so,
110 // you can typically parse text faster than with sscanf.
111 //
112 // Example: precompile pattern for faster matching:
113 // PCRE pattern("h.*o");
114 // while (ReadLine(&str)) {
115 // if (PCRE::FullMatch(str, pattern)) ...;
116 // }
117 //
118 // -----------------------------------------------------------------------
119 // SCANNING TEXT INCPCREMENTALLY
120 //
121 // The "Consume" operation may be useful if you want to repeatedly
122 // match regular expressions at the front of a string and skip over
123 // them as they match. This requires use of the string_view type,
124 // which represents a sub-range of a real string.
125 //
126 // Example: read lines of the form "var = value" from a string.
127 // std::string contents = ...; // Fill string somehow
128 // absl::string_view input(contents); // Wrap a string_view around it
129 //
130 // std::string var;
131 // int value;
132 // while (PCRE::Consume(&input, "(\\w+) = (\\d+)\n", &var, &value)) {
133 // ...;
134 // }
135 //
136 // Each successful call to "Consume" will set "var/value", and also
137 // advance "input" so it points past the matched text. Note that if the
138 // regular expression matches an empty string, input will advance
139 // by 0 bytes. If the regular expression being used might match
140 // an empty string, the loop body must check for this case and either
141 // advance the string or break out of the loop.
142 //
143 // The "FindAndConsume" operation is similar to "Consume" but does not
144 // anchor your match at the beginning of the string. For example, you
145 // could extract all words from a string by repeatedly calling
146 // PCRE::FindAndConsume(&input, "(\\w+)", &word)
147 //
148 // -----------------------------------------------------------------------
149 // PARSING HEX/OCTAL/C-RADIX NUMBERS
150 //
151 // By default, if you pass a pointer to a numeric value, the
152 // corresponding text is interpreted as a base-10 number. You can
153 // instead wrap the pointer with a call to one of the operators Hex(),
154 // Octal(), or CRadix() to interpret the text in another base. The
155 // CRadix operator interprets C-style "0" (base-8) and "0x" (base-16)
156 // prefixes, but defaults to base-10.
157 //
158 // Example:
159 // int a, b, c, d;
160 // CHECK(PCRE::FullMatch("100 40 0100 0x40", "(.*) (.*) (.*) (.*)",
161 // Octal(&a), Hex(&b), CRadix(&c), CRadix(&d));
162 // will leave 64 in a, b, c, and d.
163
164 #include "absl/strings/string_view.h"
165
166 #ifdef USEPCRE
167 #include <pcre.h>
168 namespace re2 {
169 const bool UsingPCRE = true;
170 } // namespace re2
171 #else
172 struct pcre; // opaque
173 namespace re2 {
174 const bool UsingPCRE = false;
175 } // namespace re2
176 #endif
177
178 // To produce a DLL, CMake can automatically export code symbols,
179 // but not data symbols, so we have to annotate those manually...
180 #if defined(RE2_BUILD_TESTING_DLL)
181 #define RE2_TESTING_DLL __declspec(dllexport)
182 #elif defined(RE2_CONSUME_TESTING_DLL)
183 #define RE2_TESTING_DLL __declspec(dllimport)
184 #else
185 #define RE2_TESTING_DLL
186 #endif
187
188 namespace re2 {
189
190 class PCRE_Options;
191
192 // Interface for regular expression matching. Also corresponds to a
193 // pre-compiled regular expression. An "PCRE" object is safe for
194 // concurrent use by multiple threads.
195 class PCRE {
196 public:
197 // We convert user-passed pointers into special Arg objects
198 class Arg;
199
200 // Marks end of arg list.
201 // ONLY USE IN OPTIONAL ARG DEFAULTS.
202 // DO NOT PASS EXPLICITLY.
203 RE2_TESTING_DLL static Arg no_more_args;
204
205 // Options are same value as those in pcre. We provide them here
206 // to avoid users needing to include pcre.h and also to isolate
207 // users from pcre should we change the underlying library.
208 // Only those needed by Google programs are exposed here to
209 // avoid collision with options employed internally by regexp.cc
210 // Note that some options have equivalents that can be specified in
211 // the regexp itself. For example, prefixing your regexp with
212 // "(?s)" has the same effect as the PCRE_DOTALL option.
213 enum Option {
214 None = 0x0000,
215 UTF8 = 0x0800, // == PCRE_UTF8
216 EnabledCompileOptions = UTF8,
217 EnabledExecOptions = 0x0000, // TODO: use to replace anchor flag
218 };
219
220 // We provide implicit conversions from strings so that users can
221 // pass in a string or a "const char*" wherever an "PCRE" is expected.
222 PCRE(const char* pattern);
223 PCRE(const char* pattern, Option option);
224 PCRE(const std::string& pattern);
225 PCRE(const std::string& pattern, Option option);
226 PCRE(const char *pattern, const PCRE_Options& re_option);
227 PCRE(const std::string& pattern, const PCRE_Options& re_option);
228
229 ~PCRE();
230
231 // The string specification for this PCRE. E.g.
232 // PCRE re("ab*c?d+");
233 // re.pattern(); // "ab*c?d+"
pattern()234 const std::string& pattern() const { return pattern_; }
235
236 // If PCRE could not be created properly, returns an error string.
237 // Else returns the empty string.
error()238 const std::string& error() const { return *error_; }
239
240 // Whether the PCRE has hit a match limit during execution.
241 // Not thread safe. Intended only for testing.
242 // If hitting match limits is a problem,
243 // you should be using PCRE2 (re2/re2.h)
244 // instead of checking this flag.
245 bool HitLimit();
246 void ClearHitLimit();
247
248 /***** The useful part: the matching interface *****/
249
250 // Matches "text" against "pattern". If pointer arguments are
251 // supplied, copies matched sub-patterns into them.
252 //
253 // You can pass in a "const char*" or a "std::string" for "text".
254 // You can pass in a "const char*" or a "std::string" or a "PCRE" for "pattern".
255 //
256 // The provided pointer arguments can be pointers to any scalar numeric
257 // type, or one of:
258 // std::string (matched piece is copied to string)
259 // absl::string_view (string_view is mutated to point to matched piece)
260 // T ("bool T::ParseFrom(const char*, size_t)" must exist)
261 // (void*)NULL (the corresponding matched sub-pattern is not copied)
262 //
263 // Returns true iff all of the following conditions are satisfied:
264 // a. "text" matches "pattern" exactly
265 // b. The number of matched sub-patterns is >= number of supplied pointers
266 // c. The "i"th argument has a suitable type for holding the
267 // string captured as the "i"th sub-pattern. If you pass in
268 // NULL for the "i"th argument, or pass fewer arguments than
269 // number of sub-patterns, "i"th captured sub-pattern is
270 // ignored.
271 //
272 // CAVEAT: An optional sub-pattern that does not exist in the
273 // matched string is assigned the empty string. Therefore, the
274 // following will return false (because the empty string is not a
275 // valid number):
276 // int number;
277 // PCRE::FullMatch("abc", "[a-z]+(\\d+)?", &number);
278 struct FullMatchFunctor {
279 bool operator ()(absl::string_view text, const PCRE& re, // 3..16 args
280 const Arg& ptr1 = no_more_args,
281 const Arg& ptr2 = no_more_args,
282 const Arg& ptr3 = no_more_args,
283 const Arg& ptr4 = no_more_args,
284 const Arg& ptr5 = no_more_args,
285 const Arg& ptr6 = no_more_args,
286 const Arg& ptr7 = no_more_args,
287 const Arg& ptr8 = no_more_args,
288 const Arg& ptr9 = no_more_args,
289 const Arg& ptr10 = no_more_args,
290 const Arg& ptr11 = no_more_args,
291 const Arg& ptr12 = no_more_args,
292 const Arg& ptr13 = no_more_args,
293 const Arg& ptr14 = no_more_args,
294 const Arg& ptr15 = no_more_args,
295 const Arg& ptr16 = no_more_args) const;
296 };
297
298 RE2_TESTING_DLL static const FullMatchFunctor FullMatch;
299
300 // Exactly like FullMatch(), except that "pattern" is allowed to match
301 // a substring of "text".
302 struct PartialMatchFunctor {
303 bool operator ()(absl::string_view text, const PCRE& re, // 3..16 args
304 const Arg& ptr1 = no_more_args,
305 const Arg& ptr2 = no_more_args,
306 const Arg& ptr3 = no_more_args,
307 const Arg& ptr4 = no_more_args,
308 const Arg& ptr5 = no_more_args,
309 const Arg& ptr6 = no_more_args,
310 const Arg& ptr7 = no_more_args,
311 const Arg& ptr8 = no_more_args,
312 const Arg& ptr9 = no_more_args,
313 const Arg& ptr10 = no_more_args,
314 const Arg& ptr11 = no_more_args,
315 const Arg& ptr12 = no_more_args,
316 const Arg& ptr13 = no_more_args,
317 const Arg& ptr14 = no_more_args,
318 const Arg& ptr15 = no_more_args,
319 const Arg& ptr16 = no_more_args) const;
320 };
321
322 RE2_TESTING_DLL static const PartialMatchFunctor PartialMatch;
323
324 // Like FullMatch() and PartialMatch(), except that pattern has to
325 // match a prefix of "text", and "input" is advanced past the matched
326 // text. Note: "input" is modified iff this routine returns true.
327 struct ConsumeFunctor {
328 bool operator ()(absl::string_view* input, const PCRE& pattern, // 3..16 args
329 const Arg& ptr1 = no_more_args,
330 const Arg& ptr2 = no_more_args,
331 const Arg& ptr3 = no_more_args,
332 const Arg& ptr4 = no_more_args,
333 const Arg& ptr5 = no_more_args,
334 const Arg& ptr6 = no_more_args,
335 const Arg& ptr7 = no_more_args,
336 const Arg& ptr8 = no_more_args,
337 const Arg& ptr9 = no_more_args,
338 const Arg& ptr10 = no_more_args,
339 const Arg& ptr11 = no_more_args,
340 const Arg& ptr12 = no_more_args,
341 const Arg& ptr13 = no_more_args,
342 const Arg& ptr14 = no_more_args,
343 const Arg& ptr15 = no_more_args,
344 const Arg& ptr16 = no_more_args) const;
345 };
346
347 RE2_TESTING_DLL static const ConsumeFunctor Consume;
348
349 // Like Consume(..), but does not anchor the match at the beginning of the
350 // string. That is, "pattern" need not start its match at the beginning of
351 // "input". For example, "FindAndConsume(s, "(\\w+)", &word)" finds the next
352 // word in "s" and stores it in "word".
353 struct FindAndConsumeFunctor {
354 bool operator ()(absl::string_view* input, const PCRE& pattern, // 3..16 args
355 const Arg& ptr1 = no_more_args,
356 const Arg& ptr2 = no_more_args,
357 const Arg& ptr3 = no_more_args,
358 const Arg& ptr4 = no_more_args,
359 const Arg& ptr5 = no_more_args,
360 const Arg& ptr6 = no_more_args,
361 const Arg& ptr7 = no_more_args,
362 const Arg& ptr8 = no_more_args,
363 const Arg& ptr9 = no_more_args,
364 const Arg& ptr10 = no_more_args,
365 const Arg& ptr11 = no_more_args,
366 const Arg& ptr12 = no_more_args,
367 const Arg& ptr13 = no_more_args,
368 const Arg& ptr14 = no_more_args,
369 const Arg& ptr15 = no_more_args,
370 const Arg& ptr16 = no_more_args) const;
371 };
372
373 RE2_TESTING_DLL static const FindAndConsumeFunctor FindAndConsume;
374
375 // Replace the first match of "pattern" in "str" with "rewrite".
376 // Within "rewrite", backslash-escaped digits (\1 to \9) can be
377 // used to insert text matching corresponding parenthesized group
378 // from the pattern. \0 in "rewrite" refers to the entire matching
379 // text. E.g.,
380 //
381 // std::string s = "yabba dabba doo";
382 // CHECK(PCRE::Replace(&s, "b+", "d"));
383 //
384 // will leave "s" containing "yada dabba doo"
385 //
386 // Returns true if the pattern matches and a replacement occurs,
387 // false otherwise.
388 static bool Replace(std::string* str, const PCRE& pattern,
389 absl::string_view rewrite);
390
391 // Like Replace(), except replaces all occurrences of the pattern in
392 // the string with the rewrite. Replacements are not subject to
393 // re-matching. E.g.,
394 //
395 // std::string s = "yabba dabba doo";
396 // CHECK(PCRE::GlobalReplace(&s, "b+", "d"));
397 //
398 // will leave "s" containing "yada dada doo"
399 //
400 // Returns the number of replacements made.
401 static int GlobalReplace(std::string* str, const PCRE& pattern,
402 absl::string_view rewrite);
403
404 // Like Replace, except that if the pattern matches, "rewrite"
405 // is copied into "out" with substitutions. The non-matching
406 // portions of "text" are ignored.
407 //
408 // Returns true iff a match occurred and the extraction happened
409 // successfully; if no match occurs, the string is left unaffected.
410 static bool Extract(absl::string_view text, const PCRE& pattern,
411 absl::string_view rewrite, std::string* out);
412
413 // Check that the given @p rewrite string is suitable for use with
414 // this PCRE. It checks that:
415 // * The PCRE has enough parenthesized subexpressions to satisfy all
416 // of the \N tokens in @p rewrite, and
417 // * The @p rewrite string doesn't have any syntax errors
418 // ('\' followed by anything besides [0-9] and '\').
419 // Making this test will guarantee that "replace" and "extract"
420 // operations won't LOG(ERROR) or fail because of a bad rewrite
421 // string.
422 // @param rewrite The proposed rewrite string.
423 // @param error An error message is recorded here, iff we return false.
424 // Otherwise, it is unchanged.
425 // @return true, iff @p rewrite is suitable for use with the PCRE.
426 bool CheckRewriteString(absl::string_view rewrite, std::string* error) const;
427
428 // Returns a copy of 'unquoted' with all potentially meaningful
429 // regexp characters backslash-escaped. The returned string, used
430 // as a regular expression, will exactly match the original string.
431 // For example,
432 // 1.5-2.0?
433 // becomes:
434 // 1\.5\-2\.0\?
435 static std::string QuoteMeta(absl::string_view unquoted);
436
437 /***** Generic matching interface (not so nice to use) *****/
438
439 // Type of match (TODO: Should be restructured as an Option)
440 enum Anchor {
441 UNANCHORED, // No anchoring
442 ANCHOR_START, // Anchor at start only
443 ANCHOR_BOTH, // Anchor at start and end
444 };
445
446 // General matching routine. Stores the length of the match in
447 // "*consumed" if successful.
448 bool DoMatch(absl::string_view text, Anchor anchor, size_t* consumed,
449 const Arg* const* args, int n) const;
450
451 // Return the number of capturing subpatterns, or -1 if the
452 // regexp wasn't valid on construction.
453 int NumberOfCapturingGroups() const;
454
455 private:
456 void Init(const char* pattern, Option option, int match_limit,
457 int stack_limit, bool report_errors);
458
459 // Match against "text", filling in "vec" (up to "vecsize" * 2/3) with
460 // pairs of integers for the beginning and end positions of matched
461 // text. The first pair corresponds to the entire matched text;
462 // subsequent pairs correspond, in order, to parentheses-captured
463 // matches. Returns the number of pairs (one more than the number of
464 // the last subpattern with a match) if matching was successful
465 // and zero if the match failed.
466 // I.e. for PCRE("(foo)|(bar)|(baz)") it will return 2, 3, and 4 when matching
467 // against "foo", "bar", and "baz" respectively.
468 // When matching PCRE("(foo)|hello") against "hello", it will return 1.
469 // But the values for all subpattern are filled in into "vec".
470 int TryMatch(absl::string_view text, size_t startpos, Anchor anchor,
471 bool empty_ok, int* vec, int vecsize) const;
472
473 // Append the "rewrite" string, with backslash substitutions from "text"
474 // and "vec", to string "out".
475 bool Rewrite(std::string* out, absl::string_view rewrite,
476 absl::string_view text, int* vec, int veclen) const;
477
478 // internal implementation for DoMatch
479 bool DoMatchImpl(absl::string_view text, Anchor anchor, size_t* consumed,
480 const Arg* const args[], int n, int* vec, int vecsize) const;
481
482 // Compile the regexp for the specified anchoring mode
483 pcre* Compile(Anchor anchor);
484
485 std::string pattern_;
486 Option options_;
487 pcre* re_full_; // For full matches
488 pcre* re_partial_; // For partial matches
489 const std::string* error_; // Error indicator (or empty string)
490 bool report_errors_; // Silences error logging if false
491 int match_limit_; // Limit on execution resources
492 int stack_limit_; // Limit on stack resources (bytes)
493 mutable int hit_limit_; // Hit limit during execution (bool)
494
495 PCRE(const PCRE&) = delete;
496 PCRE& operator=(const PCRE&) = delete;
497 };
498
499 // PCRE_Options allow you to set the PCRE::Options, plus any pcre
500 // "extra" options. The only extras are match_limit, which limits
501 // the CPU time of a match, and stack_limit, which limits the
502 // stack usage. Setting a limit to <= 0 lets PCRE pick a sensible default
503 // that should not cause too many problems in production code.
504 // If PCRE hits a limit during a match, it may return a false negative,
505 // but (hopefully) it won't crash.
506 //
507 // NOTE: If you are handling regular expressions specified by
508 // (external or internal) users, rather than hard-coded ones,
509 // you should be using PCRE2, which uses an alternate implementation
510 // that avoids these issues. See http://go/re2quick.
511 class PCRE_Options {
512 public:
513 // constructor
PCRE_Options()514 PCRE_Options() : option_(PCRE::None), match_limit_(0), stack_limit_(0), report_errors_(true) {}
515 // accessors
option()516 PCRE::Option option() const { return option_; }
set_option(PCRE::Option option)517 void set_option(PCRE::Option option) {
518 option_ = option;
519 }
match_limit()520 int match_limit() const { return match_limit_; }
set_match_limit(int match_limit)521 void set_match_limit(int match_limit) {
522 match_limit_ = match_limit;
523 }
stack_limit()524 int stack_limit() const { return stack_limit_; }
set_stack_limit(int stack_limit)525 void set_stack_limit(int stack_limit) {
526 stack_limit_ = stack_limit;
527 }
528
529 // If the regular expression is malformed, an error message will be printed
530 // iff report_errors() is true. Default: true.
report_errors()531 bool report_errors() const { return report_errors_; }
set_report_errors(bool report_errors)532 void set_report_errors(bool report_errors) {
533 report_errors_ = report_errors;
534 }
535 private:
536 PCRE::Option option_;
537 int match_limit_;
538 int stack_limit_;
539 bool report_errors_;
540 };
541
542
543 /***** Implementation details *****/
544
545 // Hex/Octal/Binary?
546
547 // Special class for parsing into objects that define a ParseFrom() method
548 template <typename T>
549 class _PCRE_MatchObject {
550 public:
Parse(const char * str,size_t n,void * dest)551 static inline bool Parse(const char* str, size_t n, void* dest) {
552 if (dest == NULL) return true;
553 T* object = reinterpret_cast<T*>(dest);
554 return object->ParseFrom(str, n);
555 }
556 };
557
558 class PCRE::Arg {
559 public:
560 // Empty constructor so we can declare arrays of PCRE::Arg
561 Arg();
562
563 // Constructor specially designed for NULL arguments
564 Arg(void*);
565
566 typedef bool (*Parser)(const char* str, size_t n, void* dest);
567
568 // Type-specific parsers
569 #define MAKE_PARSER(type, name) \
570 Arg(type* p) : arg_(p), parser_(name) {} \
571 Arg(type* p, Parser parser) : arg_(p), parser_(parser) {}
572
573 MAKE_PARSER(char, parse_char);
574 MAKE_PARSER(signed char, parse_schar);
575 MAKE_PARSER(unsigned char, parse_uchar);
576 MAKE_PARSER(float, parse_float);
577 MAKE_PARSER(double, parse_double);
578 MAKE_PARSER(std::string, parse_string);
579 MAKE_PARSER(absl::string_view, parse_string_view);
580
581 MAKE_PARSER(short, parse_short);
582 MAKE_PARSER(unsigned short, parse_ushort);
583 MAKE_PARSER(int, parse_int);
584 MAKE_PARSER(unsigned int, parse_uint);
585 MAKE_PARSER(long, parse_long);
586 MAKE_PARSER(unsigned long, parse_ulong);
587 MAKE_PARSER(long long, parse_longlong);
588 MAKE_PARSER(unsigned long long, parse_ulonglong);
589
590 #undef MAKE_PARSER
591
592 // Generic constructor
593 template <typename T> Arg(T*, Parser parser);
594 // Generic constructor template
Arg(T * p)595 template <typename T> Arg(T* p)
596 : arg_(p), parser_(_PCRE_MatchObject<T>::Parse) {
597 }
598
599 // Parse the data
600 bool Parse(const char* str, size_t n) const;
601
602 private:
603 void* arg_;
604 Parser parser_;
605
606 static bool parse_null (const char* str, size_t n, void* dest);
607 static bool parse_char (const char* str, size_t n, void* dest);
608 static bool parse_schar (const char* str, size_t n, void* dest);
609 static bool parse_uchar (const char* str, size_t n, void* dest);
610 static bool parse_float (const char* str, size_t n, void* dest);
611 static bool parse_double (const char* str, size_t n, void* dest);
612 static bool parse_string (const char* str, size_t n, void* dest);
613 static bool parse_string_view (const char* str, size_t n, void* dest);
614
615 #define DECLARE_INTEGER_PARSER(name) \
616 private: \
617 static bool parse_##name(const char* str, size_t n, void* dest); \
618 static bool parse_##name##_radix(const char* str, size_t n, void* dest, \
619 int radix); \
620 \
621 public: \
622 static bool parse_##name##_hex(const char* str, size_t n, void* dest); \
623 static bool parse_##name##_octal(const char* str, size_t n, void* dest); \
624 static bool parse_##name##_cradix(const char* str, size_t n, void* dest)
625
626 DECLARE_INTEGER_PARSER(short);
627 DECLARE_INTEGER_PARSER(ushort);
628 DECLARE_INTEGER_PARSER(int);
629 DECLARE_INTEGER_PARSER(uint);
630 DECLARE_INTEGER_PARSER(long);
631 DECLARE_INTEGER_PARSER(ulong);
632 DECLARE_INTEGER_PARSER(longlong);
633 DECLARE_INTEGER_PARSER(ulonglong);
634
635 #undef DECLARE_INTEGER_PARSER
636
637 };
638
Arg()639 inline PCRE::Arg::Arg() : arg_(NULL), parser_(parse_null) { }
Arg(void * p)640 inline PCRE::Arg::Arg(void* p) : arg_(p), parser_(parse_null) { }
641
Parse(const char * str,size_t n)642 inline bool PCRE::Arg::Parse(const char* str, size_t n) const {
643 return (*parser_)(str, n, arg_);
644 }
645
646 // This part of the parser, appropriate only for ints, deals with bases
647 #define MAKE_INTEGER_PARSER(type, name) \
648 inline PCRE::Arg Hex(type* ptr) { \
649 return PCRE::Arg(ptr, PCRE::Arg::parse_##name##_hex); \
650 } \
651 inline PCRE::Arg Octal(type* ptr) { \
652 return PCRE::Arg(ptr, PCRE::Arg::parse_##name##_octal); \
653 } \
654 inline PCRE::Arg CRadix(type* ptr) { \
655 return PCRE::Arg(ptr, PCRE::Arg::parse_##name##_cradix); \
656 }
657
658 MAKE_INTEGER_PARSER(short, short);
659 MAKE_INTEGER_PARSER(unsigned short, ushort);
660 MAKE_INTEGER_PARSER(int, int);
661 MAKE_INTEGER_PARSER(unsigned int, uint);
662 MAKE_INTEGER_PARSER(long, long);
663 MAKE_INTEGER_PARSER(unsigned long, ulong);
664 MAKE_INTEGER_PARSER(long long, longlong);
665 MAKE_INTEGER_PARSER(unsigned long long, ulonglong);
666
667 #undef MAKE_INTEGER_PARSER
668
669 } // namespace re2
670
671 #endif // UTIL_PCRE_H_
672