ceph/src/boost/libs/regex/doc/html/boost_regex/ref/deprecated_interfaces/old_regex.html

   1 <html>
   2 <head>
   3 <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
   4 <title>High Level Class RegEx (Deprecated)</title>
   5 <link rel="stylesheet" href="../../../../../../../doc/src/boostbook.css" type="text/css">
   6 <meta name="generator" content="DocBook XSL Stylesheets V1.77.1">
   7 <link rel="home" href="../../../index.html" title="Boost.Regex 5.1.2">
   8 <link rel="up" href="../deprecated_interfaces.html" title="Deprecated Interfaces">
   9 <link rel="prev" href="regex_split.html" title="regex_split (deprecated)">
  10 <link rel="next" href="../internal_details.html" title="Internal Details">
  11 </head>
  12 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  13 <table cellpadding="2" width="100%"><tr>
  14 <td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
  15 <td align="center"><a href="../../../../../../../index.html">Home</a></td>
  16 <td align="center"><a href="../../../../../../../libs/libraries.htm">Libraries</a></td>
  17 <td align="center"><a href="http://www.boost.org/users/people.html">People</a></td>
  18 <td align="center"><a href="http://www.boost.org/users/faq.html">FAQ</a></td>
  19 <td align="center"><a href="../../../../../../../more/index.htm">More</a></td>
  20 </tr></table>
  21 <hr>
  22 <div class="spirit-nav">
  23 <a accesskey="p" href="regex_split.html"><img src="../../../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../deprecated_interfaces.html"><img src="../../../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="../internal_details.html"><img src="../../../../../../../doc/src/images/next.png" alt="Next"></a>
  24 </div>
  25 <div class="section">
  26 <div class="titlepage"><div><div><h4 class="title">
  27 <a name="boost_regex.ref.deprecated_interfaces.old_regex"></a><a class="link" href="old_regex.html" title="High Level Class RegEx (Deprecated)">High
  28         Level Class RegEx (Deprecated)</a>
  29 </h4></div></div></div>
  30 <p>
  31           The high level wrapper class RegEx is now deprecated and does not form
  32           part of the regular expression standardization proposal. This type still
  33           exists, and existing code will continue to compile, however the following
  34           documentation is unlikely to be further updated.
  35         </p>
  36 <pre class="programlisting"><span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">cregex</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
  37 </pre>
  38 <p>
  39           The class RegEx provides a high level simplified interface to the regular
  40           expression library, this class only handles narrow character strings, and
  41           regular expressions always follow the "normal" syntax - that
  42           is the same as the perl / ECMAScript syntax.
  43         </p>
  44 <pre class="programlisting"><span class="keyword">typedef</span> <span class="keyword">bool</span> <span class="special">(*</span><span class="identifier">GrepCallback</span><span class="special">)(</span><span class="keyword">const</span> <span class="identifier">RegEx</span><span class="special">&amp;</span> <span class="identifier">expression</span><span class="special">);</span>
  45 <span class="keyword">typedef</span> <span class="keyword">bool</span> <span class="special">(*</span><span class="identifier">GrepFileCallback</span><span class="special">)(</span><span class="keyword">const</span> <span class="keyword">char</span><span class="special">*</span> <span class="identifier">file</span><span class="special">,</span> <span class="keyword">const</span> <span class="identifier">RegEx</span><span class="special">&amp;</span> <span class="identifier">expression</span><span class="special">);</span>
  46 <span class="keyword">typedef</span> <span class="keyword">bool</span> <span class="special">(*</span><span class="identifier">FindFilesCallback</span><span class="special">)(</span><span class="keyword">const</span> <span class="keyword">char</span><span class="special">*</span> <span class="identifier">file</span><span class="special">);</span>
  47
  48 <span class="keyword">class</span>  <span class="identifier">RegEx</span>
  49 <span class="special">{</span>
  50 <span class="keyword">public</span><span class="special">:</span>
  51    <span class="identifier">RegEx</span><span class="special">();</span>
  52    <span class="identifier">RegEx</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">RegEx</span><span class="special">&amp;</span> <span class="identifier">o</span><span class="special">);</span>
  53    <span class="special">~</span><span class="identifier">RegEx</span><span class="special">();</span>
  54    <span class="identifier">RegEx</span><span class="special">(</span><span class="keyword">const</span> <span class="keyword">char</span><span class="special">*</span> <span class="identifier">c</span><span class="special">,</span> <span class="keyword">bool</span> <span class="identifier">icase</span> <span class="special">=</span> <span class="keyword">false</span><span class="special">);</span>
  55    <span class="keyword">explicit</span> <span class="identifier">RegEx</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&amp;</span> <span class="identifier">s</span><span class="special">,</span> <span class="keyword">bool</span> <span class="identifier">icase</span> <span class="special">=</span> <span class="keyword">false</span><span class="special">);</span>
  56    <span class="identifier">RegEx</span><span class="special">&amp;</span> <span class="keyword">operator</span><span class="special">=(</span><span class="keyword">const</span> <span class="identifier">RegEx</span><span class="special">&amp;</span> <span class="identifier">o</span><span class="special">);</span>
  57    <span class="identifier">RegEx</span><span class="special">&amp;</span> <span class="keyword">operator</span><span class="special">=(</span><span class="keyword">const</span> <span class="keyword">char</span><span class="special">*</span> <span class="identifier">p</span><span class="special">);</span>
  58    <span class="identifier">RegEx</span><span class="special">&amp;</span> <span class="keyword">operator</span><span class="special">=(</span><span class="keyword">const</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&amp;</span> <span class="identifier">s</span><span class="special">);</span>
  59    <span class="keyword">unsigned</span> <span class="keyword">int</span> <span class="identifier">SetExpression</span><span class="special">(</span><span class="keyword">const</span> <span class="keyword">char</span><span class="special">*</span> <span class="identifier">p</span><span class="special">,</span> <span class="keyword">bool</span> <span class="identifier">icase</span> <span class="special">=</span> <span class="keyword">false</span><span class="special">);</span>
  60    <span class="keyword">unsigned</span> <span class="keyword">int</span> <span class="identifier">SetExpression</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&amp;</span> <span class="identifier">s</span><span class="special">,</span> <span class="keyword">bool</span> <span class="identifier">icase</span> <span class="special">=</span> <span class="keyword">false</span><span class="special">);</span>
  61    <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span> <span class="identifier">Expression</span><span class="special">()</span><span class="keyword">const</span><span class="special">;</span>
  62    <span class="comment">//</span>
  63    <span class="comment">// now matching operators: </span>
  64    <span class="comment">// </span>
  65    <span class="keyword">bool</span> <span class="identifier">Match</span><span class="special">(</span><span class="keyword">const</span> <span class="keyword">char</span><span class="special">*</span> <span class="identifier">p</span><span class="special">,</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">match_flag_type</span> <span class="identifier">flags</span> <span class="special">=</span> <span class="identifier">match_default</span><span class="special">);</span>
  66    <span class="keyword">bool</span> <span class="identifier">Match</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&amp;</span> <span class="identifier">s</span><span class="special">,</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">match_flag_type</span> <span class="identifier">flags</span> <span class="special">=</span> <span class="identifier">match_default</span><span class="special">);</span>
  67    <span class="keyword">bool</span> <span class="identifier">Search</span><span class="special">(</span><span class="keyword">const</span> <span class="keyword">char</span><span class="special">*</span> <span class="identifier">p</span><span class="special">,</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">match_flag_type</span> <span class="identifier">flags</span> <span class="special">=</span> <span class="identifier">match_default</span><span class="special">);</span>
  68    <span class="keyword">bool</span> <span class="identifier">Search</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&amp;</span> <span class="identifier">s</span><span class="special">,</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">match_flag_type</span> <span class="identifier">flags</span> <span class="special">=</span> <span class="identifier">match_default</span><span class="special">);</span>
  69    <span class="keyword">unsigned</span> <span class="keyword">int</span> <span class="identifier">Grep</span><span class="special">(</span><span class="identifier">GrepCallback</span> <span class="identifier">cb</span><span class="special">,</span> <span class="keyword">const</span> <span class="keyword">char</span><span class="special">*</span> <span class="identifier">p</span><span class="special">,</span>
  70                      <span class="identifier">boost</span><span class="special">::</span><span class="identifier">match_flag_type</span> <span class="identifier">flags</span> <span class="special">=</span> <span class="identifier">match_default</span><span class="special">);</span>
  71    <span class="keyword">unsigned</span> <span class="keyword">int</span> <span class="identifier">Grep</span><span class="special">(</span><span class="identifier">GrepCallback</span> <span class="identifier">cb</span><span class="special">,</span> <span class="keyword">const</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&amp;</span> <span class="identifier">s</span><span class="special">,</span>
  72                      <span class="identifier">boost</span><span class="special">::</span><span class="identifier">match_flag_type</span> <span class="identifier">flags</span> <span class="special">=</span> <span class="identifier">match_default</span><span class="special">);</span>
  73    <span class="keyword">unsigned</span> <span class="keyword">int</span> <span class="identifier">Grep</span><span class="special">(</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&gt;&amp;</span> <span class="identifier">v</span><span class="special">,</span> <span class="keyword">const</span> <span class="keyword">char</span><span class="special">*</span> <span class="identifier">p</span><span class="special">,</span>
  74                      <span class="identifier">boost</span><span class="special">::</span><span class="identifier">match_flag_type</span> <span class="identifier">flags</span> <span class="special">=</span> <span class="identifier">match_default</span><span class="special">);</span>
  75    <span class="keyword">unsigned</span> <span class="keyword">int</span> <span class="identifier">Grep</span><span class="special">(</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&gt;&amp;</span> <span class="identifier">v</span><span class="special">,</span> <span class="keyword">const</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&amp;</span> <span class="identifier">s</span><span class="special">,</span>
  76                      <span class="identifier">boost</span><span class="special">::</span><span class="identifier">match_flag_type</span> <span class="identifier">flags</span> <span class="special">=</span> <span class="identifier">match_default</span><span class="special">);</span>
  77    <span class="keyword">unsigned</span> <span class="keyword">int</span> <span class="identifier">Grep</span><span class="special">(</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="keyword">unsigned</span> <span class="keyword">int</span><span class="special">&gt;&amp;</span> <span class="identifier">v</span><span class="special">,</span> <span class="keyword">const</span> <span class="keyword">char</span><span class="special">*</span> <span class="identifier">p</span><span class="special">,</span>
  78                      <span class="identifier">boost</span><span class="special">::</span><span class="identifier">match_flag_type</span> <span class="identifier">flags</span> <span class="special">=</span> <span class="identifier">match_default</span><span class="special">);</span>
  79    <span class="keyword">unsigned</span> <span class="keyword">int</span> <span class="identifier">Grep</span><span class="special">(</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="keyword">unsigned</span> <span class="keyword">int</span><span class="special">&gt;&amp;</span> <span class="identifier">v</span><span class="special">,</span> <span class="keyword">const</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&amp;</span> <span class="identifier">s</span><span class="special">,</span>
  80                      <span class="identifier">boost</span><span class="special">::</span><span class="identifier">match_flag_type</span> <span class="identifier">flags</span> <span class="special">=</span> <span class="identifier">match_default</span><span class="special">);</span>
  81    <span class="keyword">unsigned</span> <span class="keyword">int</span> <span class="identifier">GrepFiles</span><span class="special">(</span><span class="identifier">GrepFileCallback</span> <span class="identifier">cb</span><span class="special">,</span> <span class="keyword">const</span> <span class="keyword">char</span><span class="special">*</span> <span class="identifier">files</span><span class="special">,</span> <span class="keyword">bool</span> <span class="identifier">recurse</span> <span class="special">=</span> <span class="keyword">false</span><span class="special">,</span>
  82                           <span class="identifier">boost</span><span class="special">::</span><span class="identifier">match_flag_type</span> <span class="identifier">flags</span> <span class="special">=</span> <span class="identifier">match_default</span><span class="special">);</span>
  83    <span class="keyword">unsigned</span> <span class="keyword">int</span> <span class="identifier">GrepFiles</span><span class="special">(</span><span class="identifier">GrepFileCallback</span> <span class="identifier">cb</span><span class="special">,</span> <span class="keyword">const</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&amp;</span> <span class="identifier">files</span><span class="special">,</span>
  84                           <span class="keyword">bool</span> <span class="identifier">recurse</span> <span class="special">=</span> <span class="keyword">false</span><span class="special">,</span>
  85                           <span class="identifier">boost</span><span class="special">::</span><span class="identifier">match_flag_type</span> <span class="identifier">flags</span> <span class="special">=</span> <span class="identifier">match_default</span><span class="special">);</span>
  86    <span class="keyword">unsigned</span> <span class="keyword">int</span> <span class="identifier">FindFiles</span><span class="special">(</span><span class="identifier">FindFilesCallback</span> <span class="identifier">cb</span><span class="special">,</span> <span class="keyword">const</span> <span class="keyword">char</span><span class="special">*</span> <span class="identifier">files</span><span class="special">,</span>
  87                           <span class="keyword">bool</span> <span class="identifier">recurse</span> <span class="special">=</span> <span class="keyword">false</span><span class="special">,</span>
  88                           <span class="identifier">boost</span><span class="special">::</span><span class="identifier">match_flag_type</span> <span class="identifier">flags</span> <span class="special">=</span> <span class="identifier">match_default</span><span class="special">);</span>
  89    <span class="keyword">unsigned</span> <span class="keyword">int</span> <span class="identifier">FindFiles</span><span class="special">(</span><span class="identifier">FindFilesCallback</span> <span class="identifier">cb</span><span class="special">,</span> <span class="keyword">const</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&amp;</span> <span class="identifier">files</span><span class="special">,</span>
  90                           <span class="keyword">bool</span> <span class="identifier">recurse</span> <span class="special">=</span> <span class="keyword">false</span><span class="special">,</span>
  91                           <span class="identifier">boost</span><span class="special">::</span><span class="identifier">match_flag_type</span> <span class="identifier">flags</span> <span class="special">=</span> <span class="identifier">match_default</span><span class="special">);</span>
  92    <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span> <span class="identifier">Merge</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&amp;</span> <span class="identifier">in</span><span class="special">,</span> <span class="keyword">const</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&amp;</span> <span class="identifier">fmt</span><span class="special">,</span>
  93                      <span class="keyword">bool</span> <span class="identifier">copy</span> <span class="special">=</span> <span class="keyword">true</span><span class="special">,</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">match_flag_type</span> <span class="identifier">flags</span> <span class="special">=</span> <span class="identifier">match_default</span><span class="special">);</span>
  94    <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span> <span class="identifier">Merge</span><span class="special">(</span><span class="keyword">const</span> <span class="keyword">char</span><span class="special">*</span> <span class="identifier">in</span><span class="special">,</span> <span class="keyword">const</span> <span class="keyword">char</span><span class="special">*</span> <span class="identifier">fmt</span><span class="special">,</span> <span class="keyword">bool</span> <span class="identifier">copy</span> <span class="special">=</span> <span class="keyword">true</span><span class="special">,</span>
  95                      <span class="identifier">boost</span><span class="special">::</span><span class="identifier">match_flag_type</span> <span class="identifier">flags</span> <span class="special">=</span> <span class="identifier">match_default</span><span class="special">);</span>
  96    <span class="keyword">unsigned</span> <span class="identifier">Split</span><span class="special">(</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&gt;&amp;</span> <span class="identifier">v</span><span class="special">,</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&amp;</span> <span class="identifier">s</span><span class="special">,</span>
  97                   <span class="identifier">boost</span><span class="special">::</span><span class="identifier">match_flag_type</span> <span class="identifier">flags</span> <span class="special">=</span> <span class="identifier">match_default</span><span class="special">,</span>
  98                   <span class="keyword">unsigned</span> <span class="identifier">max_count</span> <span class="special">=</span> <span class="special">~</span><span class="number">0</span><span class="special">);</span>
  99    <span class="comment">// </span>
 100    <span class="comment">// now operators for returning what matched in more detail: </span>
 101    <span class="comment">// </span>
 102    <span class="keyword">unsigned</span> <span class="keyword">int</span> <span class="identifier">Position</span><span class="special">(</span><span class="keyword">int</span> <span class="identifier">i</span> <span class="special">=</span> <span class="number">0</span><span class="special">)</span><span class="keyword">const</span><span class="special">;</span>
 103    <span class="keyword">unsigned</span> <span class="keyword">int</span> <span class="identifier">Length</span><span class="special">(</span><span class="keyword">int</span> <span class="identifier">i</span> <span class="special">=</span> <span class="number">0</span><span class="special">)</span><span class="keyword">const</span><span class="special">;</span>
 104    <span class="keyword">bool</span> <span class="identifier">Matched</span><span class="special">(</span><span class="keyword">int</span> <span class="identifier">i</span> <span class="special">=</span> <span class="number">0</span><span class="special">)</span><span class="keyword">const</span><span class="special">;</span>
 105    <span class="keyword">unsigned</span> <span class="keyword">int</span> <span class="identifier">Line</span><span class="special">()</span><span class="keyword">const</span><span class="special">;</span>
 106    <span class="keyword">unsigned</span> <span class="keyword">int</span> <span class="identifier">Marks</span><span class="special">()</span> <span class="keyword">const</span><span class="special">;</span>
 107    <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span> <span class="identifier">What</span><span class="special">(</span><span class="keyword">int</span> <span class="identifier">i</span><span class="special">)</span><span class="keyword">const</span><span class="special">;</span>
 108    <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span> <span class="keyword">operator</span><span class="special">[](</span><span class="keyword">int</span> <span class="identifier">i</span><span class="special">)</span><span class="keyword">const</span> <span class="special">;</span>
 109
 110    <span class="keyword">static</span> <span class="keyword">const</span> <span class="keyword">unsigned</span> <span class="keyword">int</span> <span class="identifier">npos</span><span class="special">;</span>
 111 <span class="special">};</span>
 112 </pre>
 113 <p>
 114           Member functions for class RegEx are defined as follows:
 115         </p>
 116 <div class="informaltable"><table class="table">
 117 <colgroup>
 118 <col>
 119 <col>
 120 </colgroup>
 121 <thead><tr>
 122 <th>
 123                   <p>
 124                     Member
 125                   </p>
 126                 </th>
 127 <th>
 128                   <p>
 129                     Description
 130                   </p>
 131                 </th>
 132 </tr></thead>
 133 <tbody>
 134 <tr>
 135 <td>
 136                   <p>
 137                     <code class="computeroutput"><span class="identifier">RegEx</span><span class="special">();</span></code>
 138                   </p>
 139                 </td>
 140 <td>
 141                   <p>
 142                     Default constructor, constructs an instance of RegEx without
 143                     any valid expression.
 144                   </p>
 145                 </td>
 146 </tr>
 147 <tr>
 148 <td>
 149                   <p>
 150                     <code class="computeroutput"><span class="identifier">RegEx</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">RegEx</span><span class="special">&amp;</span> <span class="identifier">o</span><span class="special">);</span></code>
 151                   </p>
 152                 </td>
 153 <td>
 154                   <p>
 155                     Copy constructor, all the properties of parameter <span class="emphasis"><em>o</em></span>
 156                     are copied.
 157                   </p>
 158                 </td>
 159 </tr>
 160 <tr>
 161 <td>
 162                   <p>
 163                     <code class="computeroutput"><span class="identifier">RegEx</span><span class="special">(</span><span class="keyword">const</span> <span class="keyword">char</span><span class="special">*</span> <span class="identifier">c</span><span class="special">,</span> <span class="keyword">bool</span>
 164                     <span class="identifier">icase</span> <span class="special">=</span>
 165                     <span class="keyword">false</span><span class="special">);</span></code>
 166                   </p>
 167                 </td>
 168 <td>
 169                   <p>
 170                     Constructs an instance of RegEx, setting the expression to <span class="emphasis"><em>c</em></span>,
 171                     if <span class="emphasis"><em>icase</em></span> is true then matching is insensitive
 172                     to case, otherwise it is sensitive to case. Throws <a class="link" href="../bad_expression.html" title="bad_expression"><code class="computeroutput"><span class="identifier">bad_expression</span></code></a> on failure.
 173                   </p>
 174                 </td>
 175 </tr>
 176 <tr>
 177 <td>
 178                   <p>
 179                     <code class="computeroutput"><span class="identifier">RegEx</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&amp;</span> <span class="identifier">s</span><span class="special">,</span> <span class="keyword">bool</span>
 180                     <span class="identifier">icase</span> <span class="special">=</span>
 181                     <span class="keyword">false</span><span class="special">);</span></code>
 182                   </p>
 183                 </td>
 184 <td>
 185                   <p>
 186                     Constructs an instance of RegEx, setting the expression to <span class="emphasis"><em>s</em></span>,
 187                     if <span class="emphasis"><em>icase</em></span> is true then matching is insensitive
 188                     to case, otherwise it is sensitive to case. Throws <a class="link" href="../bad_expression.html" title="bad_expression"><code class="computeroutput"><span class="identifier">bad_expression</span></code></a> on failure.
 189                   </p>
 190                 </td>
 191 </tr>
 192 <tr>
 193 <td>
 194                   <p>
 195                     <code class="computeroutput"><span class="identifier">RegEx</span><span class="special">&amp;</span>
 196                     <span class="keyword">operator</span><span class="special">=(</span><span class="keyword">const</span> <span class="identifier">RegEx</span><span class="special">&amp;</span> <span class="identifier">o</span><span class="special">);</span></code>
 197                   </p>
 198                 </td>
 199 <td>
 200                   <p>
 201                     Default assignment operator.
 202                   </p>
 203                 </td>
 204 </tr>
 205 <tr>
 206 <td>
 207                   <p>
 208                     <code class="computeroutput"><span class="identifier">RegEx</span><span class="special">&amp;</span>
 209                     <span class="keyword">operator</span><span class="special">=(</span><span class="keyword">const</span> <span class="keyword">char</span><span class="special">*</span> <span class="identifier">p</span><span class="special">);</span></code>
 210                   </p>
 211                 </td>
 212 <td>
 213                   <p>
 214                     Assignment operator, equivalent to calling <code class="computeroutput"><span class="identifier">SetExpression</span><span class="special">(</span><span class="identifier">p</span><span class="special">,</span> <span class="keyword">false</span><span class="special">)</span></code>. Throws <a class="link" href="../bad_expression.html" title="bad_expression"><code class="computeroutput"><span class="identifier">bad_expression</span></code></a> on failure.
 215                   </p>
 216                 </td>
 217 </tr>
 218 <tr>
 219 <td>
 220                   <p>
 221                     <code class="computeroutput"><span class="identifier">RegEx</span><span class="special">&amp;</span>
 222                     <span class="keyword">operator</span><span class="special">=(</span><span class="keyword">const</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&amp;</span> <span class="identifier">s</span><span class="special">);</span></code>
 223                   </p>
 224                 </td>
 225 <td>
 226                   <p>
 227                     Assignment operator, equivalent to calling <code class="computeroutput"><span class="identifier">SetExpression</span><span class="special">(</span><span class="identifier">s</span><span class="special">,</span> <span class="keyword">false</span><span class="special">)</span></code>. Throws <a class="link" href="../bad_expression.html" title="bad_expression"><code class="computeroutput"><span class="identifier">bad_expression</span></code></a> on failure.
 228                   </p>
 229                 </td>
 230 </tr>
 231 <tr>
 232 <td>
 233                   <p>
 234                     <code class="computeroutput"><span class="keyword">unsigned</span> <span class="keyword">int</span>
 235                     <span class="identifier">SetExpression</span><span class="special">(</span><span class="keyword">const</span> <span class="keyword">char</span><span class="special">*</span> <span class="identifier">p</span><span class="special">,</span> <span class="keyword">bool</span>
 236                     <span class="identifier">icase</span> <span class="special">=</span>
 237                     <span class="keyword">false</span><span class="special">);</span></code>
 238                   </p>
 239                 </td>
 240 <td>
 241                   <p>
 242                     Sets the current expression to <span class="emphasis"><em>p</em></span>, if <span class="emphasis"><em>icase</em></span>
 243                     is true then matching is insensitive to case, otherwise it is
 244                     sensitive to case. Throws <a class="link" href="../bad_expression.html" title="bad_expression"><code class="computeroutput"><span class="identifier">bad_expression</span></code></a> on failure.
 245                   </p>
 246                 </td>
 247 </tr>
 248 <tr>
 249 <td>
 250                   <p>
 251                     <code class="computeroutput"><span class="keyword">unsigned</span> <span class="keyword">int</span>
 252                     <span class="identifier">SetExpression</span><span class="special">(</span><span class="keyword">const</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&amp;</span> <span class="identifier">s</span><span class="special">,</span> <span class="keyword">bool</span>
 253                     <span class="identifier">icase</span> <span class="special">=</span>
 254                     <span class="keyword">false</span><span class="special">);</span></code>
 255                   </p>
 256                 </td>
 257 <td>
 258                   <p>
 259                     Sets the current expression to <span class="emphasis"><em>s</em></span>, if <span class="emphasis"><em>icase</em></span>
 260                     is true then matching is insensitive to case, otherwise it is
 261                     sensitive to case. Throws <a class="link" href="../bad_expression.html" title="bad_expression"><code class="computeroutput"><span class="identifier">bad_expression</span></code></a> on failure.
 262                   </p>
 263                 </td>
 264 </tr>
 265 <tr>
 266 <td>
 267                   <p>
 268                     <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span> <span class="identifier">Expression</span><span class="special">()</span><span class="keyword">const</span><span class="special">;</span></code>
 269                   </p>
 270                 </td>
 271 <td>
 272                   <p>
 273                     Returns a copy of the current regular expression.
 274                   </p>
 275                 </td>
 276 </tr>
 277 <tr>
 278 <td>
 279                   <p>
 280                     <code class="computeroutput"><span class="keyword">bool</span> <span class="identifier">Match</span><span class="special">(</span><span class="keyword">const</span>
 281                     <span class="keyword">char</span><span class="special">*</span>
 282                     <span class="identifier">p</span><span class="special">,</span>
 283                     <span class="identifier">boost</span><span class="special">::</span><span class="identifier">match_flag_type</span> <span class="identifier">flags</span>
 284                     <span class="special">=</span> <span class="identifier">match_default</span><span class="special">);</span></code>
 285                   </p>
 286                 </td>
 287 <td>
 288                   <p>
 289                     Attempts to match the current expression against the text <span class="emphasis"><em>p</em></span>
 290                     using the match flags <span class="emphasis"><em>flags</em></span> - see <a class="link" href="../match_flag_type.html" title="match_flag_type"><code class="computeroutput"><span class="identifier">match_flag_type</span></code></a>.
 291                     Returns <span class="emphasis"><em>true</em></span> if the expression matches the
 292                     whole of the input string.
 293                   </p>
 294                 </td>
 295 </tr>
 296 <tr>
 297 <td>
 298                   <p>
 299                     <code class="computeroutput"><span class="keyword">bool</span> <span class="identifier">Match</span><span class="special">(</span><span class="keyword">const</span>
 300                     <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&amp;</span>
 301                     <span class="identifier">s</span><span class="special">,</span>
 302                     <span class="identifier">boost</span><span class="special">::</span><span class="identifier">match_flag_type</span> <span class="identifier">flags</span>
 303                     <span class="special">=</span> <span class="identifier">match_default</span><span class="special">);</span></code>
 304                   </p>
 305                 </td>
 306 <td>
 307                   <p>
 308                     Attempts to match the current expression against the text <span class="emphasis"><em>s</em></span>
 309                     using the <a class="link" href="../match_flag_type.html" title="match_flag_type"><code class="computeroutput"><span class="identifier">match_flag_type</span></code></a> <span class="emphasis"><em>flags</em></span>.
 310                     Returns <span class="emphasis"><em>true</em></span> if the expression matches the
 311                     whole of the input string.
 312                   </p>
 313                 </td>
 314 </tr>
 315 <tr>
 316 <td>
 317                   <p>
 318                     <code class="computeroutput"><span class="keyword">bool</span> <span class="identifier">Search</span><span class="special">(</span><span class="keyword">const</span>
 319                     <span class="keyword">char</span><span class="special">*</span>
 320                     <span class="identifier">p</span><span class="special">,</span>
 321                     <span class="identifier">boost</span><span class="special">::</span><span class="identifier">match_flag_type</span> <span class="identifier">flags</span>
 322                     <span class="special">=</span> <span class="identifier">match_default</span><span class="special">);</span></code>
 323                   </p>
 324                 </td>
 325 <td>
 326                   <p>
 327                     Attempts to find a match for the current expression somewhere
 328                     in the text <span class="emphasis"><em>p</em></span> using the <a class="link" href="../match_flag_type.html" title="match_flag_type"><code class="computeroutput"><span class="identifier">match_flag_type</span></code></a> <span class="emphasis"><em>flags</em></span>.
 329                     Returns <span class="emphasis"><em>true</em></span> if the match succeeds.
 330                   </p>
 331                 </td>
 332 </tr>
 333 <tr>
 334 <td>
 335                   <p>
 336                     <code class="computeroutput"><span class="keyword">bool</span> <span class="identifier">Search</span><span class="special">(</span><span class="keyword">const</span>
 337                     <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&amp;</span>
 338                     <span class="identifier">s</span><span class="special">,</span>
 339                     <span class="identifier">boost</span><span class="special">::</span><span class="identifier">match_flag_type</span> <span class="identifier">flags</span>
 340                     <span class="special">=</span> <span class="identifier">match_default</span><span class="special">);</span></code>
 341                   </p>
 342                 </td>
 343 <td>
 344                   <p>
 345                     Attempts to find a match for the current expression somewhere
 346                     in the text <span class="emphasis"><em>s</em></span> using the <a class="link" href="../match_flag_type.html" title="match_flag_type"><code class="computeroutput"><span class="identifier">match_flag_type</span></code></a> flags.
 347                     Returns <span class="emphasis"><em>true</em></span> if the match succeeds.
 348                   </p>
 349                 </td>
 350 </tr>
 351 <tr>
 352 <td>
 353                   <p>
 354                     <code class="computeroutput"><span class="keyword">unsigned</span> <span class="keyword">int</span>
 355                     <span class="identifier">Grep</span><span class="special">(</span><span class="identifier">GrepCallback</span> <span class="identifier">cb</span><span class="special">,</span> <span class="keyword">const</span>
 356                     <span class="keyword">char</span><span class="special">*</span>
 357                     <span class="identifier">p</span><span class="special">,</span>
 358                     <span class="identifier">boost</span><span class="special">::</span><span class="identifier">match_flag_type</span> <span class="identifier">flags</span>
 359                     <span class="special">=</span> <span class="identifier">match_default</span><span class="special">);</span></code>
 360                   </p>
 361                 </td>
 362 <td>
 363                   <p>
 364                     Finds all matches of the current expression in the text <span class="emphasis"><em>p</em></span>
 365                     using the <a class="link" href="../match_flag_type.html" title="match_flag_type"><code class="computeroutput"><span class="identifier">match_flag_type</span></code></a> <span class="emphasis"><em>flags</em></span>.
 366                     For each match found calls the call-back function cb as: <code class="computeroutput"><span class="identifier">cb</span><span class="special">(*</span><span class="keyword">this</span><span class="special">);</span></code>
 367                     If at any stage the call-back function returns <span class="emphasis"><em>false</em></span>
 368                     then the grep operation terminates, otherwise continues until
 369                     no further matches are found. Returns the number of matches found.
 370                   </p>
 371                 </td>
 372 </tr>
 373 <tr>
 374 <td>
 375                   <p>
 376                     <code class="computeroutput"><span class="keyword">unsigned</span> <span class="keyword">int</span>
 377                     <span class="identifier">Grep</span><span class="special">(</span><span class="identifier">GrepCallback</span> <span class="identifier">cb</span><span class="special">,</span> <span class="keyword">const</span>
 378                     <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&amp;</span>
 379                     <span class="identifier">s</span><span class="special">,</span>
 380                     <span class="identifier">boost</span><span class="special">::</span><span class="identifier">match_flag_type</span> <span class="identifier">flags</span>
 381                     <span class="special">=</span> <span class="identifier">match_default</span><span class="special">);</span></code>
 382                   </p>
 383                 </td>
 384 <td>
 385                   <p>
 386                     Finds all matches of the current expression in the text <span class="emphasis"><em>s</em></span>
 387                     using the <a class="link" href="../match_flag_type.html" title="match_flag_type"><code class="computeroutput"><span class="identifier">match_flag_type</span></code></a> flags.
 388                     For each match found calls the call-back function cb as: <code class="computeroutput"><span class="identifier">cb</span><span class="special">(*</span><span class="keyword">this</span><span class="special">);</span></code>
 389                     If at any stage the call-back function returns false then the
 390                     grep operation terminates, otherwise continues until no further
 391                     matches are found. Returns the number of matches found.
 392                   </p>
 393                 </td>
 394 </tr>
 395 <tr>
 396 <td>
 397                   <p>
 398                     <code class="computeroutput"><span class="keyword">unsigned</span> <span class="keyword">int</span>
 399                     <span class="identifier">Grep</span><span class="special">(</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&gt;&amp;</span>
 400                     <span class="identifier">v</span><span class="special">,</span>
 401                     <span class="keyword">const</span> <span class="keyword">char</span><span class="special">*</span> <span class="identifier">p</span><span class="special">,</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">match_flag_type</span>
 402                     <span class="identifier">flags</span> <span class="special">=</span>
 403                     <span class="identifier">match_default</span><span class="special">);</span></code>
 404                   </p>
 405                 </td>
 406 <td>
 407                   <p>
 408                     Finds all matches of the current expression in the text <span class="emphasis"><em>p</em></span>
 409                     using the <a class="link" href="../match_flag_type.html" title="match_flag_type"><code class="computeroutput"><span class="identifier">match_flag_type</span></code></a> flags.
 410                     For each match pushes a copy of what matched onto <span class="emphasis"><em>v</em></span>.
 411                     Returns the number of matches found.
 412                   </p>
 413                 </td>
 414 </tr>
 415 <tr>
 416 <td>
 417                   <p>
 418                     <code class="computeroutput"><span class="keyword">unsigned</span> <span class="keyword">int</span>
 419                     <span class="identifier">Grep</span><span class="special">(</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&gt;&amp;</span>
 420                     <span class="identifier">v</span><span class="special">,</span>
 421                     <span class="keyword">const</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&amp;</span> <span class="identifier">s</span><span class="special">,</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">match_flag_type</span>
 422                     <span class="identifier">flags</span> <span class="special">=</span>
 423                     <span class="identifier">match_default</span><span class="special">);</span></code>
 424                   </p>
 425                 </td>
 426 <td>
 427                   <p>
 428                     Finds all matches of the current expression in the text <span class="emphasis"><em>s</em></span>
 429                     using the <a class="link" href="../match_flag_type.html" title="match_flag_type"><code class="computeroutput"><span class="identifier">match_flag_type</span></code></a> <span class="emphasis"><em>flags</em></span>.
 430                     For each match pushes a copy of what matched onto <span class="emphasis"><em>v</em></span>.
 431                     Returns the number of matches found.
 432                   </p>
 433                 </td>
 434 </tr>
 435 <tr>
 436 <td>
 437                   <p>
 438                     <code class="computeroutput"><span class="keyword">unsigned</span> <span class="keyword">int</span>
 439                     <span class="identifier">Grep</span><span class="special">(</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="keyword">unsigned</span> <span class="keyword">int</span><span class="special">&gt;&amp;</span> <span class="identifier">v</span><span class="special">,</span> <span class="keyword">const</span>
 440                     <span class="keyword">char</span><span class="special">*</span>
 441                     <span class="identifier">p</span><span class="special">,</span>
 442                     <span class="identifier">boost</span><span class="special">::</span><span class="identifier">match_flag_type</span> <span class="identifier">flags</span>
 443                     <span class="special">=</span> <span class="identifier">match_default</span><span class="special">);</span></code>
 444                   </p>
 445                 </td>
 446 <td>
 447                   <p>
 448                     Finds all matches of the current expression in the text <span class="emphasis"><em>p</em></span>
 449                     using the <a class="link" href="../match_flag_type.html" title="match_flag_type"><code class="computeroutput"><span class="identifier">match_flag_type</span></code></a> <span class="emphasis"><em>flags</em></span>.
 450                     For each match pushes the starting index of what matched onto
 451                     <span class="emphasis"><em>v</em></span>. Returns the number of matches found.
 452                   </p>
 453                 </td>
 454 </tr>
 455 <tr>
 456 <td>
 457                   <p>
 458                     <code class="computeroutput"><span class="keyword">unsigned</span> <span class="keyword">int</span>
 459                     <span class="identifier">Grep</span><span class="special">(</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="keyword">unsigned</span> <span class="keyword">int</span><span class="special">&gt;&amp;</span> <span class="identifier">v</span><span class="special">,</span> <span class="keyword">const</span>
 460                     <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&amp;</span>
 461                     <span class="identifier">s</span><span class="special">,</span>
 462                     <span class="identifier">boost</span><span class="special">::</span><span class="identifier">match_flag_type</span> <span class="identifier">flags</span>
 463                     <span class="special">=</span> <span class="identifier">match_default</span><span class="special">);</span></code>
 464                   </p>
 465                 </td>
 466 <td>
 467                   <p>
 468                     Finds all matches of the current expression in the text <span class="emphasis"><em>s</em></span>
 469                     using the <a class="link" href="../match_flag_type.html" title="match_flag_type"><code class="computeroutput"><span class="identifier">match_flag_type</span></code></a> <span class="emphasis"><em>flags</em></span>.
 470                     For each match pushes the starting index of what matched onto
 471                     <span class="emphasis"><em>v</em></span>. Returns the number of matches found.
 472                   </p>
 473                 </td>
 474 </tr>
 475 <tr>
 476 <td>
 477                   <p>
 478                     <code class="computeroutput"><span class="keyword">unsigned</span> <span class="keyword">int</span>
 479                     <span class="identifier">GrepFiles</span><span class="special">(</span><span class="identifier">GrepFileCallback</span> <span class="identifier">cb</span><span class="special">,</span> <span class="keyword">const</span>
 480                     <span class="keyword">char</span><span class="special">*</span>
 481                     <span class="identifier">files</span><span class="special">,</span>
 482                     <span class="keyword">bool</span> <span class="identifier">recurse</span>
 483                     <span class="special">=</span> <span class="keyword">false</span><span class="special">,</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">match_flag_type</span>
 484                     <span class="identifier">flags</span> <span class="special">=</span>
 485                     <span class="identifier">match_default</span><span class="special">);</span></code>
 486                   </p>
 487                 </td>
 488 <td>
 489                   <p>
 490                     Finds all matches of the current expression in the files <span class="emphasis"><em>files</em></span>
 491                     using the <a class="link" href="../match_flag_type.html" title="match_flag_type"><code class="computeroutput"><span class="identifier">match_flag_type</span></code></a> <span class="emphasis"><em>flags</em></span>.
 492                     For each match calls the call-back function cb. If the call-back
 493                     returns false then the algorithm returns without considering
 494                     further matches in the current file, or any further files.
 495                   </p>
 496                   <p>
 497                     The parameter <span class="emphasis"><em>files</em></span> can include wild card
 498                     characters '*' and '?', if the parameter recurse is true then
 499                     searches sub-directories for matching file names.
 500                   </p>
 501                   <p>
 502                     Returns the total number of matches found.
 503                   </p>
 504                   <p>
 505                     May throw an exception derived from <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">runtime_error</span></code>
 506                     if file io fails.
 507                   </p>
 508                 </td>
 509 </tr>
 510 <tr>
 511 <td>
 512                   <p>
 513                     <code class="computeroutput"><span class="keyword">unsigned</span> <span class="keyword">int</span>
 514                     <span class="identifier">GrepFiles</span><span class="special">(</span><span class="identifier">GrepFileCallback</span> <span class="identifier">cb</span><span class="special">,</span> <span class="keyword">const</span>
 515                     <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&amp;</span>
 516                     <span class="identifier">files</span><span class="special">,</span>
 517                     <span class="keyword">bool</span> <span class="identifier">recurse</span>
 518                     <span class="special">=</span> <span class="keyword">false</span><span class="special">,</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">match_flag_type</span>
 519                     <span class="identifier">flags</span> <span class="special">=</span>
 520                     <span class="identifier">match_default</span><span class="special">);</span></code>
 521                   </p>
 522                 </td>
 523 <td>
 524                   <p>
 525                     Finds all matches of the current expression in the files <span class="emphasis"><em>files</em></span>
 526                     using the <a class="link" href="../match_flag_type.html" title="match_flag_type"><code class="computeroutput"><span class="identifier">match_flag_type</span></code></a> <span class="emphasis"><em>flags</em></span>.
 527                     For each match calls the call-back function cb.
 528                   </p>
 529                   <p>
 530                     If the call-back returns false then the algorithm returns without
 531                     considering further matches in the current file, or any further
 532                     files.
 533                   </p>
 534                   <p>
 535                     The parameter <span class="emphasis"><em>files</em></span> can include wild card
 536                     characters '*' and '?', if the parameter recurse is true then
 537                     searches sub-directories for matching file names.
 538                   </p>
 539                   <p>
 540                     Returns the total number of matches found.
 541                   </p>
 542                   <p>
 543                     May throw an exception derived from <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">runtime_error</span></code>
 544                     if file io fails.
 545                   </p>
 546                 </td>
 547 </tr>
 548 <tr>
 549 <td>
 550                   <p>
 551                     <code class="computeroutput"><span class="keyword">unsigned</span> <span class="keyword">int</span>
 552                     <span class="identifier">FindFiles</span><span class="special">(</span><span class="identifier">FindFilesCallback</span> <span class="identifier">cb</span><span class="special">,</span> <span class="keyword">const</span>
 553                     <span class="keyword">char</span><span class="special">*</span>
 554                     <span class="identifier">files</span><span class="special">,</span>
 555                     <span class="keyword">bool</span> <span class="identifier">recurse</span>
 556                     <span class="special">=</span> <span class="keyword">false</span><span class="special">,</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">match_flag_type</span>
 557                     <span class="identifier">flags</span> <span class="special">=</span>
 558                     <span class="identifier">match_default</span><span class="special">);</span></code>
 559                   </p>
 560                 </td>
 561 <td>
 562                   <p>
 563                     Searches files to find all those which contain at least one match
 564                     of the current expression using the <a class="link" href="../match_flag_type.html" title="match_flag_type"><code class="computeroutput"><span class="identifier">match_flag_type</span></code></a> <span class="emphasis"><em>flags</em></span>.
 565                     For each matching file calls the call-back function cb. If the
 566                     call-back returns false then the algorithm returns without considering
 567                     any further files.
 568                   </p>
 569                   <p>
 570                     The parameter <span class="emphasis"><em>files</em></span> can include wild card
 571                     characters '*' and '?', if the parameter <span class="emphasis"><em>recurse</em></span>
 572                     is true then searches sub-directories for matching file names.
 573                   </p>
 574                   <p>
 575                     Returns the total number of files found.
 576                   </p>
 577                   <p>
 578                     May throw an exception derived from <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">runtime_error</span></code>
 579                     if file io fails.
 580                   </p>
 581                 </td>
 582 </tr>
 583 <tr>
 584 <td>
 585                   <p>
 586                     <code class="computeroutput"><span class="keyword">unsigned</span> <span class="keyword">int</span>
 587                     <span class="identifier">FindFiles</span><span class="special">(</span><span class="identifier">FindFilesCallback</span> <span class="identifier">cb</span><span class="special">,</span> <span class="keyword">const</span>
 588                     <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&amp;</span>
 589                     <span class="identifier">files</span><span class="special">,</span>
 590                     <span class="keyword">bool</span> <span class="identifier">recurse</span>
 591                     <span class="special">=</span> <span class="keyword">false</span><span class="special">,</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">match_flag_type</span>
 592                     <span class="identifier">flags</span> <span class="special">=</span>
 593                     <span class="identifier">match_default</span><span class="special">);</span></code>
 594                   </p>
 595                 </td>
 596 <td>
 597                   <p>
 598                     Searches files to find all those which contain at least one match
 599                     of the current expression using the <a class="link" href="../match_flag_type.html" title="match_flag_type"><code class="computeroutput"><span class="identifier">match_flag_type</span></code></a> <span class="emphasis"><em>flags</em></span>.
 600                     For each matching file calls the call-back function cb.
 601                   </p>
 602                   <p>
 603                     If the call-back returns false then the algorithm returns without
 604                     considering any further files.
 605                   </p>
 606                   <p>
 607                     The parameter <span class="emphasis"><em>files</em></span> can include wild card
 608                     characters '*' and '?', if the parameter <span class="emphasis"><em>recurse</em></span>
 609                     is true then searches sub-directories for matching file names.
 610                   </p>
 611                   <p>
 612                     Returns the total number of files found.
 613                   </p>
 614                   <p>
 615                     May throw an exception derived from <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">runtime_error</span></code>
 616                     if file io fails.
 617                   </p>
 618                 </td>
 619 </tr>
 620 <tr>
 621 <td>
 622                   <p>
 623                     <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span> <span class="identifier">Merge</span><span class="special">(</span><span class="keyword">const</span>
 624                     <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&amp;</span>
 625                     <span class="identifier">in</span><span class="special">,</span>
 626                     <span class="keyword">const</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&amp;</span> <span class="identifier">fmt</span><span class="special">,</span> <span class="keyword">bool</span>
 627                     <span class="identifier">copy</span> <span class="special">=</span>
 628                     <span class="keyword">true</span><span class="special">,</span>
 629                     <span class="identifier">boost</span><span class="special">::</span><span class="identifier">match_flag_type</span> <span class="identifier">flags</span>
 630                     <span class="special">=</span> <span class="identifier">match_default</span><span class="special">);</span></code>
 631                   </p>
 632                 </td>
 633 <td>
 634                   <p>
 635                     Performs a search and replace operation: searches through the
 636                     string <span class="emphasis"><em>in</em></span> for all occurrences of the current
 637                     expression, for each occurrence replaces the match with the format
 638                     string <span class="emphasis"><em>fmt</em></span>. Uses <span class="emphasis"><em>flags</em></span>
 639                     to determine what gets matched, and how the format string should
 640                     be treated. If <span class="emphasis"><em>copy</em></span> is true then all unmatched
 641                     sections of input are copied unchanged to output, if the flag
 642                     <span class="emphasis"><em>format_first_only</em></span> is set then only the first
 643                     occurrence of the pattern found is replaced. Returns the new
 644                     string. See also <a class="link" href="../../format.html" title="Search and Replace Format String Syntax">format string
 645                     syntax</a>, and <a class="link" href="../match_flag_type.html" title="match_flag_type"><code class="computeroutput"><span class="identifier">match_flag_type</span></code></a>.
 646                   </p>
 647                 </td>
 648 </tr>
 649 <tr>
 650 <td>
 651                   <p>
 652                     <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span> <span class="identifier">Merge</span><span class="special">(</span><span class="keyword">const</span>
 653                     <span class="keyword">char</span><span class="special">*</span>
 654                     <span class="identifier">in</span><span class="special">,</span>
 655                     <span class="keyword">const</span> <span class="keyword">char</span><span class="special">*</span> <span class="identifier">fmt</span><span class="special">,</span> <span class="keyword">bool</span>
 656                     <span class="identifier">copy</span> <span class="special">=</span>
 657                     <span class="keyword">true</span><span class="special">,</span>
 658                     <span class="identifier">boost</span><span class="special">::</span><span class="identifier">match_flag_type</span> <span class="identifier">flags</span>
 659                     <span class="special">=</span> <span class="identifier">match_default</span><span class="special">);</span></code>
 660                   </p>
 661                 </td>
 662 <td>
 663                   <p>
 664                     Performs a search and replace operation: searches through the
 665                     string <span class="emphasis"><em>in</em></span> for all occurrences of the current
 666                     expression, for each occurrence replaces the match with the format
 667                     string <span class="emphasis"><em>fmt</em></span>. Uses <span class="emphasis"><em>flags</em></span>
 668                     to determine what gets matched, and how the format string should
 669                     be treated. If <span class="emphasis"><em>copy</em></span> is true then all unmatched
 670                     sections of input are copied unchanged to output, if the flag
 671                     <span class="emphasis"><em>format_first_only</em></span> is set then only the first
 672                     occurrence of the pattern found is replaced. Returns the new
 673                     string. See also <a class="link" href="../../format.html" title="Search and Replace Format String Syntax">format string
 674                     syntax</a>, and <a class="link" href="../match_flag_type.html" title="match_flag_type"><code class="computeroutput"><span class="identifier">match_flag_type</span></code></a>.
 675                   </p>
 676                 </td>
 677 </tr>
 678 <tr>
 679 <td>
 680                   <p>
 681                     <code class="computeroutput"><span class="keyword">unsigned</span> <span class="identifier">Split</span><span class="special">(</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&gt;&amp;</span> <span class="identifier">v</span><span class="special">,</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&amp;</span> <span class="identifier">s</span><span class="special">,</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">match_flag_type</span>
 682                     <span class="identifier">flags</span> <span class="special">=</span>
 683                     <span class="identifier">match_default</span><span class="special">,</span>
 684                     <span class="keyword">unsigned</span> <span class="identifier">max_count</span>
 685                     <span class="special">=</span> <span class="special">~</span><span class="number">0</span><span class="special">);</span></code>
 686                   </p>
 687                 </td>
 688 <td>
 689                   <p>
 690                     Splits the input string and pushes each one onto the vector.
 691                     If the expression contains no marked sub-expressions, then one
 692                     string is outputted for each section of the input that does not
 693                     match the expression. If the expression does contain marked sub-expressions,
 694                     then outputs one string for each marked sub-expression each time
 695                     a match occurs. Outputs no more than <span class="emphasis"><em>max_count</em></span>
 696                     strings. Before returning, deletes from the input string <span class="emphasis"><em>s</em></span>
 697                     all of the input that has been processed (all of the string if
 698                     <span class="emphasis"><em>max_count</em></span> was not reached). Returns the
 699                     number of strings pushed onto the vector.
 700                   </p>
 701                 </td>
 702 </tr>
 703 <tr>
 704 <td>
 705                   <p>
 706                     <code class="computeroutput"><span class="keyword">unsigned</span> <span class="keyword">int</span>
 707                     <span class="identifier">Position</span><span class="special">(</span><span class="keyword">int</span> <span class="identifier">i</span>
 708                     <span class="special">=</span> <span class="number">0</span><span class="special">)</span><span class="keyword">const</span><span class="special">;</span></code>
 709                   </p>
 710                 </td>
 711 <td>
 712                   <p>
 713                     Returns the position of what matched sub-expression <span class="emphasis"><em>i</em></span>.
 714                     If <code class="computeroutput"><span class="identifier">i</span> <span class="special">=</span>
 715                     <span class="number">0</span></code> then returns the position
 716                     of the whole match. Returns <code class="computeroutput"><span class="identifier">RegEx</span><span class="special">::</span><span class="identifier">npos</span></code>
 717                     if the supplied index is invalid, or if the specified sub-expression
 718                     did not participate in the match.
 719                   </p>
 720                 </td>
 721 </tr>
 722 <tr>
 723 <td>
 724                   <p>
 725                     <code class="computeroutput"><span class="keyword">unsigned</span> <span class="keyword">int</span>
 726                     <span class="identifier">Length</span><span class="special">(</span><span class="keyword">int</span> <span class="identifier">i</span>
 727                     <span class="special">=</span> <span class="number">0</span><span class="special">)</span><span class="keyword">const</span><span class="special">;</span></code>
 728                   </p>
 729                 </td>
 730 <td>
 731                   <p>
 732                     Returns the length of what matched sub-expression i. If <code class="computeroutput"><span class="identifier">i</span> <span class="special">=</span>
 733                     <span class="number">0</span></code> then returns the length
 734                     of the whole match. Returns <code class="computeroutput"><span class="identifier">RegEx</span><span class="special">::</span><span class="identifier">npos</span></code>
 735                     if the supplied index is invalid, or if the specified sub-expression
 736                     did not participate in the match.
 737                   </p>
 738                 </td>
 739 </tr>
 740 <tr>
 741 <td>
 742                   <p>
 743                     <code class="computeroutput"><span class="keyword">bool</span> <span class="identifier">Matched</span><span class="special">(</span><span class="keyword">int</span>
 744                     <span class="identifier">i</span> <span class="special">=</span>
 745                     <span class="number">0</span><span class="special">)</span><span class="keyword">const</span><span class="special">;</span></code>
 746                   </p>
 747                 </td>
 748 <td>
 749                   <p>
 750                     Returns true if sub-expression <span class="emphasis"><em>i</em></span> was matched,
 751                     false otherwise.
 752                   </p>
 753                 </td>
 754 </tr>
 755 <tr>
 756 <td>
 757                   <p>
 758                     <code class="computeroutput"><span class="keyword">unsigned</span> <span class="keyword">int</span>
 759                     <span class="identifier">Line</span><span class="special">()</span><span class="keyword">const</span><span class="special">;</span></code>
 760                   </p>
 761                 </td>
 762 <td>
 763                   <p>
 764                     Returns the line on which the match occurred, indexes start from
 765                     1 not zero, if no match occurred then returns <code class="computeroutput"><span class="identifier">RegEx</span><span class="special">::</span><span class="identifier">npos</span></code>.
 766                   </p>
 767                 </td>
 768 </tr>
 769 <tr>
 770 <td>
 771                   <p>
 772                     <code class="computeroutput"><span class="keyword">unsigned</span> <span class="keyword">int</span>
 773                     <span class="identifier">Marks</span><span class="special">()</span>
 774                     <span class="keyword">const</span><span class="special">;</span></code>
 775                   </p>
 776                 </td>
 777 <td>
 778                   <p>
 779                     Returns the number of marked sub-expressions contained in the
 780                     expression. Note that this includes the whole match (sub-expression
 781                     zero), so the value returned is always &gt;= 1.
 782                   </p>
 783                 </td>
 784 </tr>
 785 <tr>
 786 <td>
 787                   <p>
 788                     <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span> <span class="identifier">What</span><span class="special">(</span><span class="keyword">int</span>
 789                     <span class="identifier">i</span><span class="special">)</span><span class="keyword">const</span><span class="special">;</span></code>
 790                   </p>
 791                 </td>
 792 <td>
 793                   <p>
 794                     Returns a copy of what matched sub-expression <span class="emphasis"><em>i</em></span>.
 795                     If <code class="computeroutput"><span class="identifier">i</span> <span class="special">=</span>
 796                     <span class="number">0</span></code> then returns a copy of
 797                     the whole match. Returns a null string if the index is invalid
 798                     or if the specified sub-expression did not participate in a match.
 799                   </p>
 800                 </td>
 801 </tr>
 802 <tr>
 803 <td>
 804                   <p>
 805                     <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span> <span class="keyword">operator</span><span class="special">[](</span><span class="keyword">int</span>
 806                     <span class="identifier">i</span><span class="special">)</span><span class="keyword">const</span> <span class="special">;</span></code>
 807                   </p>
 808                 </td>
 809 <td>
 810                   <p>
 811                     Returns <code class="computeroutput"><span class="identifier">what</span><span class="special">(</span><span class="identifier">i</span><span class="special">);</span></code> Can be used to simplify access
 812                     to sub-expression matches, and make usage more perl-like.
 813                   </p>
 814                 </td>
 815 </tr>
 816 </tbody>
 817 </table></div>
 818 </div>
 819 <table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
 820 <td align="left"></td>
 821 <td align="right"><div class="copyright-footer">Copyright &#169; 1998-2013 John Maddock<p>
 822         Distributed under the Boost Software License, Version 1.0. (See accompanying
 823         file LICENSE_1_0.txt or copy at <a href="http://www.boost.org/LICENSE_1_0.txt" target="_top">http://www.boost.org/LICENSE_1_0.txt</a>)
 824       </p>
 825 </div></td>
 826 </tr></table>
 827 <hr>
 828 <div class="spirit-nav">
 829 <a accesskey="p" href="regex_split.html"><img src="../../../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../deprecated_interfaces.html"><img src="../../../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="../internal_details.html"><img src="../../../../../../../doc/src/images/next.png" alt="Next"></a>
 830 </div>
 831 </body>
 832 </html>