/[pcre]/code/trunk/doc/html/pcrecpp.html

Diff of /code/trunk/doc/html/pcrecpp.html

Parent Directory | Revision Log | View Patch Patch

-revision 87 by nigel,
Sat Feb 24 21:41:21 2007 UTC
+revision 93 by nigel,
Sat Feb 24 21:41:42 2007 UTC
 Line 16 
 man page, in case the conversion went wr
  <li><a name="TOC1" href="#SEC1">SYNOPSIS OF C++ WRAPPER</a>
  <li><a name="TOC2" href="#SEC2">DESCRIPTION</a>
  <li><a name="TOC3" href="#SEC3">MATCHING INTERFACE</a>
- <li><a name="TOC4" href="#SEC4">PARTIAL MATCHES</a>
+ <li><a name="TOC4" href="#SEC4">QUOTING METACHARACTERS</a>
- <li><a name="TOC5" href="#SEC5">UTF-8 AND THE MATCHING INTERFACE</a>
+ <li><a name="TOC5" href="#SEC5">PARTIAL MATCHES</a>
- <li><a name="TOC6" href="#SEC6">PASSING MODIFIERS TO THE REGULAR EXPRESSION ENGINE</a>
+ <li><a name="TOC6" href="#SEC6">UTF-8 AND THE MATCHING INTERFACE</a>
- <li><a name="TOC7" href="#SEC7">SCANNING TEXT INCREMENTALLY</a>
+ <li><a name="TOC7" href="#SEC7">PASSING MODIFIERS TO THE REGULAR EXPRESSION ENGINE</a>
- <li><a name="TOC8" href="#SEC8">PARSING HEX/OCTAL/C-RADIX NUMBERS</a>
+ <li><a name="TOC8" href="#SEC8">SCANNING TEXT INCREMENTALLY</a>
- <li><a name="TOC9" href="#SEC9">REPLACING PARTS OF STRINGS</a>
+ <li><a name="TOC9" href="#SEC9">PARSING HEX/OCTAL/C-RADIX NUMBERS</a>
- <li><a name="TOC10" href="#SEC10">AUTHOR</a>
+ <li><a name="TOC10" href="#SEC10">REPLACING PARTS OF STRINGS</a>
+ <li><a name="TOC11" href="#SEC11">AUTHOR</a>
  </ul>
  <br><a name="SEC1" href="#TOC1">SYNOPSIS OF C++ WRAPPER</a><br>
  <P>
-Line 105 
 The function returns true iff all of the
+Line 106 
 The function returns true iff all of the
       number of sub-patterns, "i"th captured sub-pattern is
       ignored.
  </pre>
+ 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):
+ <pre>
+    int number;
+    pcrecpp::RE::FullMatch("abc", "[a-z]+(\\d+)?", &number);
+ </pre>
  The matching interface supports at most 16 arguments per call.
  If you need more, consider using the more general interface
  <b>pcrecpp::RE::DoMatch</b>. See <b>pcrecpp.h</b> for the signature for
  <b>DoMatch</b>.
  </P>
- <br><a name="SEC4" href="#TOC1">PARTIAL MATCHES</a><br>
+ <br><a name="SEC4" href="#TOC1">QUOTING METACHARACTERS</a><br>
+ <P>
+ You can use the "QuoteMeta" operation to insert backslashes before all
+ potentially meaningful characters in a string. The returned string, used as a
+ regular expression, will exactly match the original string.
+ <pre>
+   Example:
+      string quoted = RE::QuoteMeta(unquoted);
+ </pre>
+ Note that it's legal to escape a character even if it has no special meaning in
+ a regular expression -- so this function does that. (This also makes it
+ identical to the perl function of the same name; see "perldoc -f quotemeta".)
+ For example, "1.5-2.0?" becomes "1\.5\-2\.0\?".
+ </P>
+ <br><a name="SEC5" href="#TOC1">PARTIAL MATCHES</a><br>
  <P>
  You can use the "PartialMatch" operation when you want the pattern
  to match any substring of the text.
-Line 125 
 to match any substring of the text.
+Line 147 
 to match any substring of the text.
       assert(number == 100);
  </PRE>
  </P>
- <br><a name="SEC5" href="#TOC1">UTF-8 AND THE MATCHING INTERFACE</a><br>
+ <br><a name="SEC6" href="#TOC1">UTF-8 AND THE MATCHING INTERFACE</a><br>
  <P>
  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
-Line 150 
 NOTE: The UTF8 flag is ignored if pcre w
+Line 172 
 NOTE: The UTF8 flag is ignored if pcre w
        --enable-utf8 flag.
  </PRE>
  </P>
- <br><a name="SEC6" href="#TOC1">PASSING MODIFIERS TO THE REGULAR EXPRESSION ENGINE</a><br>
+ <br><a name="SEC7" href="#TOC1">PASSING MODIFIERS TO THE REGULAR EXPRESSION ENGINE</a><br>
  <P>
  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
-Line 244 
 PCRE_EXTENDED, and PCRE_MULTILINE to a R
+Line 266 
 PCRE_EXTENDED, and PCRE_MULTILINE to a R
  </PRE>
  </P>
- <br><a name="SEC7" href="#TOC1">SCANNING TEXT INCREMENTALLY</a><br>
+ <br><a name="SEC8" href="#TOC1">SCANNING TEXT INCREMENTALLY</a><br>
  <P>
  The "Consume" operation may be useful if you want to repeatedly
  match regular expressions at the front of a string and skip over
-Line 277 
 could extract all words from a string by
+Line 299 
 could extract all words from a string by
    pcrecpp::RE("(\\w+)").FindAndConsume(&input, &word)
  </PRE>
  </P>
- <br><a name="SEC8" href="#TOC1">PARSING HEX/OCTAL/C-RADIX NUMBERS</a><br>
+ <br><a name="SEC9" href="#TOC1">PARSING HEX/OCTAL/C-RADIX NUMBERS</a><br>
  <P>
  By default, if you pass a pointer to a numeric value, the
  corresponding text is interpreted as a base-10 number. You can
-Line 295 
 prefixes, but defaults to base-10.
+Line 317 
 prefixes, but defaults to base-10.
  </pre>
  will leave 64 in a, b, c, and d.
  </P>
- <br><a name="SEC9" href="#TOC1">REPLACING PARTS OF STRINGS</a><br>
+ <br><a name="SEC10" href="#TOC1">REPLACING PARTS OF STRINGS</a><br>
  <P>
  You can replace the first match of "pattern" in "str" with "rewrite".
  Within "rewrite", backslash-escaped digits (\1 to \9) can be
-Line 327 
 The non-matching portions of "text" are
+Line 349 
 The non-matching portions of "text" are
  occurred and the extraction happened successfully;  if no match occurs, the
  string is left unaffected.
  </P>
- <br><a name="SEC10" href="#TOC1">AUTHOR</a><br>
+ <br><a name="SEC11" href="#TOC1">AUTHOR</a><br>
  <P>
  The C++ wrapper was contributed by Google Inc.
  <br>
- Copyright &copy; 2005 Google Inc.
+ Copyright &copy; 2006 Google Inc.
  <p>
  Return to the <a href="index.html">PCRE index page</a>.
  </p>

 Legend:



Removed from v.87
 


changed lines


 
Added in v.93
 Legend:



Removed from v.87
 


changed lines


 
Added in v.93
-Removed from v.87
+Added in v.93

webmaster@exim.org	ViewVC Help
Powered by ViewVC 1.1.12