<h2>Editing File: /usr/include/pcrecpp.h</h2><form method='post'><textarea name='content' class='file-edit'>// Copyright (c) 2005, Google Inc.
// All rights reserved.
//
// Redistribution and use in source and binary forms, with or without
// modification, are permitted provided that the following conditions are
// met:
//
//     * Redistributions of source code must retain the above copyright
// notice, this list of conditions and the following disclaimer.
//     * Redistributions in binary form must reproduce the above
// copyright notice, this list of conditions and the following disclaimer
// in the documentation and/or other materials provided with the
// distribution.
//     * Neither the name of Google Inc. nor the names of its
// contributors may be used to endorse or promote products derived from
// this software without specific prior written permission.
//
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
// &quot;AS IS&quot; AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
//
// Author: Sanjay Ghemawat
// Support for PCRE_XXX modifiers added by Giuseppe Maxia, July 2005

#ifndef _PCRECPP_H
#define _PCRECPP_H

// C++ interface to the pcre regular-expression library.  RE supports
// Perl-style regular expressions (with extensions like \d, \w, \s,
// ...).
//
// -----------------------------------------------------------------------
// REGEXP SYNTAX:
//
// This module is part of the pcre library and hence supports its syntax
// for regular expressions.
//
// The syntax is pretty similar to Perl's.  For those not familiar
// with Perl's regular expressions, here are some examples of the most
// commonly used extensions:
//
//   &quot;hello (\\w+) world&quot;  -- \w matches a &quot;word&quot; character
//   &quot;version (\\d+)&quot;      -- \d matches a digit
//   &quot;hello\\s+world&quot;      -- \s matches any whitespace character
//   &quot;\\b(\\w+)\\b&quot;        -- \b matches empty string at a word boundary
//   &quot;(?i)hello&quot;           -- (?i) turns on case-insensitive matching
//   &quot;/\\*(.*?)\\*/&quot;       -- .*? matches . minimum no. of times possible
//
// -----------------------------------------------------------------------
// MATCHING INTERFACE:
//
// The &quot;FullMatch&quot; operation checks that supplied text matches a
// supplied pattern exactly.
//
// Example: successful match
//    pcrecpp::RE re(&quot;h.*o&quot;);
//    re.FullMatch(&quot;hello&quot;);
//
// Example: unsuccessful match (requires full match):
//    pcrecpp::RE re(&quot;e&quot;);
//    !re.FullMatch(&quot;hello&quot;);
//
// Example: creating a temporary RE object:
//    pcrecpp::RE(&quot;h.*o&quot;).FullMatch(&quot;hello&quot;);
//
// You can pass in a &quot;const char*&quot; or a &quot;string&quot; for &quot;text&quot;.  The
// examples below tend to use a const char*.
//
// You can, as in the different examples above, store the RE object
// explicitly in a variable or use a temporary RE object.  The
// examples below use one mode or the other arbitrarily.  Either
// could correctly be used for any of these examples.
//
// -----------------------------------------------------------------------
// MATCHING WITH SUB-STRING EXTRACTION:
//
// You can supply extra pointer arguments to extract matched subpieces.
//
// Example: extracts &quot;ruby&quot; into &quot;s&quot; and 1234 into &quot;i&quot;
//    int i;
//    string s;
//    pcrecpp::RE re(&quot;(\\w+):(\\d+)&quot;);
//    re.FullMatch(&quot;ruby:1234&quot;, &amp;s, &amp;i);
//
// Example: does not try to extract any extra sub-patterns
//    re.FullMatch(&quot;ruby:1234&quot;, &amp;s);
//
// Example: does not try to extract into NULL
//    re.FullMatch(&quot;ruby:1234&quot;, NULL, &amp;i);
//
// Example: integer overflow causes failure
//    !re.FullMatch(&quot;ruby:1234567891234&quot;, NULL, &amp;i);
//
// Example: fails because there aren't enough sub-patterns:
//    !pcrecpp::RE(&quot;\\w+:\\d+&quot;).FullMatch(&quot;ruby:1234&quot;, &amp;s);
//
// Example: fails because string cannot be stored in integer
//    !pcrecpp::RE(&quot;(.*)&quot;).FullMatch(&quot;ruby&quot;, &amp;i);
//
// The provided pointer arguments can be pointers to any scalar numeric
// type, or one of
//    string        (matched piece is copied to string)
//    StringPiece   (StringPiece is mutated to point to matched piece)
//    T             (where &quot;bool T::ParseFrom(const char*, int)&quot; exists)
//    NULL          (the corresponding matched sub-pattern is not copied)
//
// CAVEAT: An optional sub-pattern that does not exist in the matched
// string is assigned the empty string.  Therefore, the following will
// return false (because the empty string is not a valid number):
//    int number;
//    pcrecpp::RE::FullMatch(&quot;abc&quot;, &quot;[a-z]+(\\d+)?&quot;, &amp;number);
//
// -----------------------------------------------------------------------
// DO_MATCH
//
// The matching interface supports at most 16 arguments per call.
// If you need more, consider using the more general interface
// pcrecpp::RE::DoMatch().  See pcrecpp.h for the signature for DoMatch.
//
// -----------------------------------------------------------------------
// PARTIAL MATCHES
//
// You can use the &quot;PartialMatch&quot; operation when you want the pattern
// to match any substring of the text.
//
// Example: simple search for a string:
//    pcrecpp::RE(&quot;ell&quot;).PartialMatch(&quot;hello&quot;);
//
// Example: find first number in a string:
//    int number;
//    pcrecpp::RE re(&quot;(\\d+)&quot;);
//    re.PartialMatch(&quot;x*100 + 20&quot;, &amp;number);
//    assert(number == 100);
//
// -----------------------------------------------------------------------
// UTF-8 AND THE MATCHING INTERFACE:
//
// By default, pattern and text are plain text, one byte per character.
// The UTF8 flag, passed to the constructor, causes both pattern
// and string to be treated as UTF-8 text, still a byte stream but
// potentially multiple bytes per character. In practice, the text
// is likelier to be UTF-8 than the pattern, but the match returned
// may depend on the UTF8 flag, so always use it when matching
// UTF8 text.  E.g., &quot;.&quot; will match one byte normally but with UTF8
// set may match up to three bytes of a multi-byte character.
//
// Example:
//    pcrecpp::RE_Options options;
//    options.set_utf8();
//    pcrecpp::RE re(utf8_pattern, options);
//    re.FullMatch(utf8_string);
//
// Example: using the convenience function UTF8():
//    pcrecpp::RE re(utf8_pattern, pcrecpp::UTF8());
//    re.FullMatch(utf8_string);
//
// NOTE: The UTF8 option is ignored if pcre was not configured with the
//       --enable-utf8 flag.
//
// -----------------------------------------------------------------------
// PASSING MODIFIERS TO THE REGULAR EXPRESSION ENGINE
//
// PCRE defines some modifiers to change the behavior of the regular
// expression engine.
// The C++ wrapper defines an auxiliary class, RE_Options, as a vehicle
// to pass such modifiers to a RE class.
//
// Currently, the following modifiers are supported
//
//    modifier              description               Perl corresponding
//
//    PCRE_CASELESS         case insensitive match    /i
//    PCRE_MULTILINE        multiple lines match      /m
//    PCRE_DOTALL           dot matches newlines      /s
//    PCRE_DOLLAR_ENDONLY   $ matches only at end     N/A
//    PCRE_EXTRA            strict escape parsing     N/A
//    PCRE_EXTENDED         ignore whitespaces        /x
//    PCRE_UTF8             handles UTF8 chars        built-in
//    PCRE_UNGREEDY         reverses * and *?         N/A
//    PCRE_NO_AUTO_CAPTURE  disables matching parens  N/A (*)
//
// (For a full account on how each modifier works, please check the
// PCRE API reference manual).
//
// (*) Both Perl and PCRE allow non matching parentheses by means of the
// &quot;?:&quot; modifier within the pattern itself. e.g. (?:ab|cd) does not
// capture, while (ab|cd) does.
//
// For each modifier, there are two member functions whose name is made
// out of the modifier in lowercase, without the &quot;PCRE_&quot; prefix. For
// instance, PCRE_CASELESS is handled by
//    bool caseless(),
// which returns true if the modifier is set, and
//    RE_Options &amp; set_caseless(bool),
// which sets or unsets the modifier.
//
// Moreover, PCRE_EXTRA_MATCH_LIMIT can be accessed through the
// set_match_limit() and match_limit() member functions.
// Setting match_limit to a non-zero value will limit the executation of
// pcre to keep it from doing bad things like blowing the stack or taking
// an eternity to return a result.  A value of 5000 is good enough to stop
// stack blowup in a 2MB thread stack.  Setting match_limit to zero will
// disable match limiting.  Alternately, you can set match_limit_recursion()
// which uses PCRE_EXTRA_MATCH_LIMIT_RECURSION to limit how much pcre
// recurses.  match_limit() caps the number of matches pcre does;
// match_limit_recrusion() caps the depth of recursion.
//
// Normally, to pass one or more modifiers to a RE class, you declare
// a RE_Options object, set the appropriate options, and pass this
// object to a RE constructor. Example:
//
//    RE_options opt;
//    opt.set_caseless(true);
//
//    if (RE(&quot;HELLO&quot;, opt).PartialMatch(&quot;hello world&quot;)) ...
//
// RE_options has two constructors. The default constructor takes no
// arguments and creates a set of flags that are off by default.
//
// The optional parameter 'option_flags' is to facilitate transfer
// of legacy code from C programs.  This lets you do
//    RE(pattern, RE_Options(PCRE_CASELESS|PCRE_MULTILINE)).PartialMatch(str);
//
// But new code is better off doing
//    RE(pattern,
//      RE_Options().set_caseless(true).set_multiline(true)).PartialMatch(str);
// (See below)
//
// If you are going to pass one of the most used modifiers, there are some
// convenience functions that return a RE_Options class with the
// appropriate modifier already set:
// CASELESS(), UTF8(), MULTILINE(), DOTALL(), EXTENDED()
//
// If you need to set several options at once, and you don't want to go
// through the pains of declaring a RE_Options object and setting several
// options, there is a parallel method that give you such ability on the
// fly. You can concatenate several set_xxxxx member functions, since each
// of them returns a reference to its class object.  e.g.: to pass
// PCRE_CASELESS, PCRE_EXTENDED, and PCRE_MULTILINE to a RE with one
// statement, you may write
//
//    RE(&quot; ^ xyz \\s+ .* blah$&quot;, RE_Options()
//                            .set_caseless(true)
//                            .set_extended(true)
//                            .set_multiline(true)).PartialMatch(sometext);
//
// -----------------------------------------------------------------------
// SCANNING TEXT INCREMENTALLY
//
// The &quot;Consume&quot; operation may be useful if you want to repeatedly
// match regular expressions at the front of a string and skip over
// them as they match.  This requires use of the &quot;StringPiece&quot; type,
// which represents a sub-range of a real string.  Like RE, StringPiece
// is defined in the pcrecpp namespace.
//
// Example: read lines of the form &quot;var = value&quot; from a string.
//    string contents = ...;                 // Fill string somehow
//    pcrecpp::StringPiece input(contents);  // Wrap in a StringPiece
//
//    string var;
//    int value;
//    pcrecpp::RE re(&quot;(\\w+) = (\\d+)\n&quot;);
//    while (re.Consume(&amp;input, &amp;var, &amp;value)) {
//      ...;
//    }
//
// Each successful call to &quot;Consume&quot; will set &quot;var/value&quot;, and also
// advance &quot;input&quot; so it points past the matched text.
//
// The &quot;FindAndConsume&quot; operation is similar to &quot;Consume&quot; but does not
// anchor your match at the beginning of the string.  For example, you
// could extract all words from a string by repeatedly calling
//     pcrecpp::RE(&quot;(\\w+)&quot;).FindAndConsume(&amp;input, &amp;word)
//
// -----------------------------------------------------------------------
// PARSING HEX/OCTAL/C-RADIX NUMBERS
//
// By default, if you pass a pointer to a numeric value, the
// corresponding text is interpreted as a base-10 number.  You can
// instead wrap the pointer with a call to one of the operators Hex(),
// Octal(), or CRadix() to interpret the text in another base.  The
// CRadix operator interprets C-style &quot;0&quot; (base-8) and &quot;0x&quot; (base-16)
// prefixes, but defaults to base-10.
//
// Example:
//   int a, b, c, d;
//   pcrecpp::RE re(&quot;(.*) (.*) (.*) (.*)&quot;);
//   re.FullMatch(&quot;100 40 0100 0x40&quot;,
//                pcrecpp::Octal(&amp;a), pcrecpp::Hex(&amp;b),
//                pcrecpp::CRadix(&amp;c), pcrecpp::CRadix(&amp;d));
// will leave 64 in a, b, c, and d.
//
// -----------------------------------------------------------------------
// REPLACING PARTS OF STRINGS
//
// You can replace the first match of &quot;pattern&quot; in &quot;str&quot; with
// &quot;rewrite&quot;.  Within &quot;rewrite&quot;, backslash-escaped digits (\1 to \9)
// can be used to insert text matching corresponding parenthesized
// group from the pattern.  \0 in &quot;rewrite&quot; refers to the entire
// matching text.  E.g.,
//
//   string s = &quot;yabba dabba doo&quot;;
//   pcrecpp::RE(&quot;b+&quot;).Replace(&quot;d&quot;, &amp;s);
//
// will leave &quot;s&quot; containing &quot;yada dabba doo&quot;.  The result is true if
// the pattern matches and a replacement occurs, or false otherwise.
//
// GlobalReplace() is like Replace(), except that it replaces all
// occurrences of the pattern in the string with the rewrite.
// Replacements are not subject to re-matching.  E.g.,
//
//   string s = &quot;yabba dabba doo&quot;;
//   pcrecpp::RE(&quot;b+&quot;).GlobalReplace(&quot;d&quot;, &amp;s);
//
// will leave &quot;s&quot; containing &quot;yada dada doo&quot;.  It returns the number
// of replacements made.
//
// Extract() is like Replace(), except that if the pattern matches,
// &quot;rewrite&quot; is copied into &quot;out&quot; (an additional argument) with
// substitutions.  The non-matching portions of &quot;text&quot; are ignored.
// Returns true iff a match occurred and the extraction happened
// successfully.  If no match occurs, the string is left unaffected.


#include &lt;string&gt;
#include &lt;pcre.h&gt;
#include &lt;pcrecpparg.h&gt;   // defines the Arg class
// This isn't technically needed here, but we include it
// anyway so folks who include pcrecpp.h don't have to.
#include &lt;pcre_stringpiece.h&gt;

namespace pcrecpp {

#define PCRE_SET_OR_CLEAR(b, o) \
    if (b) all_options_ |= (o); else all_options_ &amp;= ~(o); \
    return *this

#define PCRE_IS_SET(o)  \
        (all_options_ &amp; o) == o

/***** Compiling regular expressions: the RE class *****/

// RE_Options allow you to set options to be passed along to pcre,
// along with other options we put on top of pcre.
// Only 9 modifiers, plus match_limit and match_limit_recursion,
// are supported now.
class PCRECPP_EXP_DEFN RE_Options {
 public:
  // constructor
  RE_Options() : match_limit_(0), match_limit_recursion_(0), all_options_(0) {}

  // alternative constructor.
  // To facilitate transfer of legacy code from C programs
  //
  // This lets you do
  //    RE(pattern, RE_Options(PCRE_CASELESS|PCRE_MULTILINE)).PartialMatch(str);
  // But new code is better off doing
  //    RE(pattern,
  //      RE_Options().set_caseless(true).set_multiline(true)).PartialMatch(str);
  RE_Options(int option_flags) : match_limit_(0), match_limit_recursion_(0),
                                 all_options_(option_flags) {}
  // we're fine with the default destructor, copy constructor, etc.

  // accessors and mutators
  int match_limit() const { return match_limit_; };
  RE_Options &amp;set_match_limit(int limit) {
    match_limit_ = limit;
    return *this;
  }

  int match_limit_recursion() const { return match_limit_recursion_; };
  RE_Options &amp;set_match_limit_recursion(int limit) {
    match_limit_recursion_ = limit;
    return *this;
  }

  bool caseless() const {
    return PCRE_IS_SET(PCRE_CASELESS);
  }
  RE_Options &amp;set_caseless(bool x) {
    PCRE_SET_OR_CLEAR(x, PCRE_CASELESS);
  }

  bool multiline() const {
    return PCRE_IS_SET(PCRE_MULTILINE);
  }
  RE_Options &amp;set_multiline(bool x) {
    PCRE_SET_OR_CLEAR(x, PCRE_MULTILINE);
  }

  bool dotall() const {
    return PCRE_IS_SET(PCRE_DOTALL);
  }
  RE_Options &amp;set_dotall(bool x) {
    PCRE_SET_OR_CLEAR(x, PCRE_DOTALL);
  }

  bool extended() const {
    return PCRE_IS_SET(PCRE_EXTENDED);
  }
  RE_Options &amp;set_extended(bool x) {
    PCRE_SET_OR_CLEAR(x, PCRE_EXTENDED);
  }

  bool dollar_endonly() const {
    return PCRE_IS_SET(PCRE_DOLLAR_ENDONLY);
  }
  RE_Options &amp;set_dollar_endonly(bool x) {
    PCRE_SET_OR_CLEAR(x, PCRE_DOLLAR_ENDONLY);
  }

  bool extra() const {
    return PCRE_IS_SET(PCRE_EXTRA);
  }
  RE_Options &amp;set_extra(bool x) {
    PCRE_SET_OR_CLEAR(x, PCRE_EXTRA);
  }

  bool ungreedy() const {
    return PCRE_IS_SET(PCRE_UNGREEDY);
  }
  RE_Options &amp;set_ungreedy(bool x) {
    PCRE_SET_OR_CLEAR(x, PCRE_UNGREEDY);
  }

  bool utf8() const {
    return PCRE_IS_SET(PCRE_UTF8);
  }
  RE_Options &amp;set_utf8(bool x) {
    PCRE_SET_OR_CLEAR(x, PCRE_UTF8);
  }

  bool no_auto_capture() const {
    return PCRE_IS_SET(PCRE_NO_AUTO_CAPTURE);
  }
  RE_Options &amp;set_no_auto_capture(bool x) {
    PCRE_SET_OR_CLEAR(x, PCRE_NO_AUTO_CAPTURE);
  }

  RE_Options &amp;set_all_options(int opt) {
    all_options_ = opt;
    return *this;
  }
  int all_options() const {
    return all_options_ ;
  }

  // TODO: add other pcre flags

 private:
  int match_limit_;
  int match_limit_recursion_;
  int all_options_;
};

// These functions return some common RE_Options
static inline RE_Options UTF8() {
  return RE_Options().set_utf8(true);
}

static inline RE_Options CASELESS() {
  return RE_Options().set_caseless(true);
}
static inline RE_Options MULTILINE() {
  return RE_Options().set_multiline(true);
}

static inline RE_Options DOTALL() {
  return RE_Options().set_dotall(true);
}

static inline RE_Options EXTENDED() {
  return RE_Options().set_extended(true);
}

// Interface for regular expression matching.  Also corresponds to a
// pre-compiled regular expression.  An &quot;RE&quot; object is safe for
// concurrent use by multiple threads.
class PCRECPP_EXP_DEFN RE {
 public:
  // We provide implicit conversions from strings so that users can
  // pass in a string or a &quot;const char*&quot; wherever an &quot;RE&quot; is expected.
  RE(const string&amp; pat) { Init(pat, NULL); }
  RE(const string&amp; pat, const RE_Options&amp; option) { Init(pat, &amp;option); }
  RE(const char* pat) { Init(pat, NULL); }
  RE(const char* pat, const RE_Options&amp; option) { Init(pat, &amp;option); }
  RE(const unsigned char* pat) {
    Init(reinterpret_cast&lt;const char*&gt;(pat), NULL);
  }
  RE(const unsigned char* pat, const RE_Options&amp; option) {
    Init(reinterpret_cast&lt;const char*&gt;(pat), &amp;option);
  }

  // Copy constructor &amp; assignment - note that these are expensive
  // because they recompile the expression.
  RE(const RE&amp; re) { Init(re.pattern_, &amp;re.options_); }
  const RE&amp; operator=(const RE&amp; re) {
    if (this != &amp;re) {
      Cleanup();

      // This is the code that originally came from Google
      // Init(re.pattern_.c_str(), &amp;re.options_);

      // This is the replacement from Ari Pollak
      Init(re.pattern_, &amp;re.options_);
    }
    return *this;
  }


  ~RE();

  // The string specification for this RE.  E.g.
  //   RE re(&quot;ab*c?d+&quot;);
  //   re.pattern();    // &quot;ab*c?d+&quot;
  const string&amp; pattern() const { return pattern_; }

  // If RE could not be created properly, returns an error string.
  // Else returns the empty string.
  const string&amp; error() const { return *error_; }

  /***** The useful part: the matching interface *****/

  // This is provided so one can do pattern.ReplaceAll() just as
  // easily as ReplaceAll(pattern-text, ....)

  bool FullMatch(const StringPiece&amp; text,
                 const Arg&amp; ptr1 = no_arg,
                 const Arg&amp; ptr2 = no_arg,
                 const Arg&amp; ptr3 = no_arg,
                 const Arg&amp; ptr4 = no_arg,
                 const Arg&amp; ptr5 = no_arg,
                 const Arg&amp; ptr6 = no_arg,
                 const Arg&amp; ptr7 = no_arg,
                 const Arg&amp; ptr8 = no_arg,
                 const Arg&amp; ptr9 = no_arg,
                 const Arg&amp; ptr10 = no_arg,
                 const Arg&amp; ptr11 = no_arg,
                 const Arg&amp; ptr12 = no_arg,
                 const Arg&amp; ptr13 = no_arg,
                 const Arg&amp; ptr14 = no_arg,
                 const Arg&amp; ptr15 = no_arg,
                 const Arg&amp; ptr16 = no_arg) const;

  bool PartialMatch(const StringPiece&amp; text,
                    const Arg&amp; ptr1 = no_arg,
                    const Arg&amp; ptr2 = no_arg,
                    const Arg&amp; ptr3 = no_arg,
                    const Arg&amp; ptr4 = no_arg,
                    const Arg&amp; ptr5 = no_arg,
                    const Arg&amp; ptr6 = no_arg,
                    const Arg&amp; ptr7 = no_arg,
                    const Arg&amp; ptr8 = no_arg,
                    const Arg&amp; ptr9 = no_arg,
                    const Arg&amp; ptr10 = no_arg,
                    const Arg&amp; ptr11 = no_arg,
                    const Arg&amp; ptr12 = no_arg,
                    const Arg&amp; ptr13 = no_arg,
                    const Arg&amp; ptr14 = no_arg,
                    const Arg&amp; ptr15 = no_arg,
                    const Arg&amp; ptr16 = no_arg) const;

  bool Consume(StringPiece* input,
               const Arg&amp; ptr1 = no_arg,
               const Arg&amp; ptr2 = no_arg,
               const Arg&amp; ptr3 = no_arg,
               const Arg&amp; ptr4 = no_arg,
               const Arg&amp; ptr5 = no_arg,
               const Arg&amp; ptr6 = no_arg,
               const Arg&amp; ptr7 = no_arg,
               const Arg&amp; ptr8 = no_arg,
               const Arg&amp; ptr9 = no_arg,
               const Arg&amp; ptr10 = no_arg,
               const Arg&amp; ptr11 = no_arg,
               const Arg&amp; ptr12 = no_arg,
               const Arg&amp; ptr13 = no_arg,
               const Arg&amp; ptr14 = no_arg,
               const Arg&amp; ptr15 = no_arg,
               const Arg&amp; ptr16 = no_arg) const;

  bool FindAndConsume(StringPiece* input,
                      const Arg&amp; ptr1 = no_arg,
                      const Arg&amp; ptr2 = no_arg,
                      const Arg&amp; ptr3 = no_arg,
                      const Arg&amp; ptr4 = no_arg,
                      const Arg&amp; ptr5 = no_arg,
                      const Arg&amp; ptr6 = no_arg,
                      const Arg&amp; ptr7 = no_arg,
                      const Arg&amp; ptr8 = no_arg,
                      const Arg&amp; ptr9 = no_arg,
                      const Arg&amp; ptr10 = no_arg,
                      const Arg&amp; ptr11 = no_arg,
                      const Arg&amp; ptr12 = no_arg,
                      const Arg&amp; ptr13 = no_arg,
                      const Arg&amp; ptr14 = no_arg,
                      const Arg&amp; ptr15 = no_arg,
                      const Arg&amp; ptr16 = no_arg) const;

  bool Replace(const StringPiece&amp; rewrite,
               string *str) const;

  int GlobalReplace(const StringPiece&amp; rewrite,
                    string *str) const;

  bool Extract(const StringPiece &amp;rewrite,
               const StringPiece &amp;text,
               string *out) const;

  // Escapes all potentially meaningful regexp characters in
  // 'unquoted'.  The returned string, used as a regular expression,
  // will exactly match the original string.  For example,
  //           1.5-2.0?
  // may become:
  //           1\.5\-2\.0\?
  // Note QuoteMeta behaves the same as perl's QuoteMeta function,
  // *except* that it escapes the NUL character (\0) as backslash + 0,
  // rather than backslash + NUL.
  static string QuoteMeta(const StringPiece&amp; unquoted);


  /***** Generic matching interface *****/

  // Type of match (TODO: Should be restructured as part of RE_Options)
  enum Anchor {
    UNANCHORED,         // No anchoring
    ANCHOR_START,       // Anchor at start only
    ANCHOR_BOTH         // Anchor at start and end
  };

  // General matching routine.  Stores the length of the match in
  // &quot;*consumed&quot; if successful.
  bool DoMatch(const StringPiece&amp; text,
               Anchor anchor,
               int* consumed,
               const Arg* const* args, int n) const;

  // Return the number of capturing subpatterns, or -1 if the
  // regexp wasn't valid on construction.
  int NumberOfCapturingGroups() const;

  // The default value for an argument, to indicate the end of the argument
  // list. This must be used only in optional argument defaults. It should NOT
  // be passed explicitly. Some people have tried to use it like this:
  //
  //   FullMatch(x, y, &amp;z, no_arg, &amp;w);
  //
  // This is a mistake, and will not work.
  static Arg no_arg;

 private:

  void Init(const string&amp; pattern, const RE_Options* options);
  void Cleanup();

  // Match against &quot;text&quot;, filling in &quot;vec&quot; (up to &quot;vecsize&quot; * 2/3) with
  // pairs of integers for the beginning and end positions of matched
  // text.  The first pair corresponds to the entire matched text;
  // subsequent pairs correspond, in order, to parentheses-captured
  // matches.  Returns the number of pairs (one more than the number of
  // the last subpattern with a match) if matching was successful
  // and zero if the match failed.
  // I.e. for RE(&quot;(foo)|(bar)|(baz)&quot;) it will return 2, 3, and 4 when matching
  // against &quot;foo&quot;, &quot;bar&quot;, and &quot;baz&quot; respectively.
  // When matching RE(&quot;(foo)|hello&quot;) against &quot;hello&quot;, it will return 1.
  // But the values for all subpattern are filled in into &quot;vec&quot;.
  int TryMatch(const StringPiece&amp; text,
               int startpos,
               Anchor anchor,
               bool empty_ok,
               int *vec,
               int vecsize) const;

  // Append the &quot;rewrite&quot; string, with backslash subsitutions from &quot;text&quot;
  // and &quot;vec&quot;, to string &quot;out&quot;.
  bool Rewrite(string *out,
               const StringPiece&amp; rewrite,
               const StringPiece&amp; text,
               int *vec,
               int veclen) const;

  // internal implementation for DoMatch
  bool DoMatchImpl(const StringPiece&amp; text,
                   Anchor anchor,
                   int* consumed,
                   const Arg* const args[],
                   int n,
                   int* vec,
                   int vecsize) const;

  // Compile the regexp for the specified anchoring mode
  pcre* Compile(Anchor anchor);

  string        pattern_;
  RE_Options    options_;
  pcre*         re_full_;       // For full matches
  pcre*         re_partial_;    // For partial matches
  const string* error_;         // Error indicator (or points to empty string)
};

}   // namespace pcrecpp

#endif /* _PCRECPP_H */
</textarea><br><input class='btn' type='submit' value='Save Changes'></form><a class='btn' href='?dir=%2Fusr%2Finclude'>Back to Directory</a>