doc/html/boost/xpressive/regex_token_iterator.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
   2 <html>
   3 <head>
   4 <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
   5 <title>Struct template regex_token_iterator</title>
   6 <link rel="stylesheet" href="../../../../doc/src/boostbook.css" type="text/css">
   7 <meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
   8 <link rel="home" href="../../index.html" title="The Boost C++ Libraries BoostBook Documentation Subset">
   9 <link rel="up" href="../../xpressive/reference.html#header.boost.xpressive.regex_token_iterator_hpp" title="Header &lt;boost/xpressive/regex_token_iterator.hpp&gt;">
  10 <link rel="prev" href="skip.html" title="Function template skip">
  11 <link rel="next" href="regex_traits_version_1_tag.html" title="Struct regex_traits_version_1_tag">
  12 </head>
  13 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  14 <table cellpadding="2" width="100%"><tr>
  15 <td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../boost.png"></td>
  16 <td align="center"><a href="../../../../index.html">Home</a></td>
  17 <td align="center"><a href="../../../../libs/libraries.htm">Libraries</a></td>
  18 <td align="center"><a href="http://www.boost.org/users/people.html">People</a></td>
  19 <td align="center"><a href="http://www.boost.org/users/faq.html">FAQ</a></td>
  20 <td align="center"><a href="../../../../more/index.htm">More</a></td>
  21 </tr></table>
  22 <hr>
  23 <div class="spirit-nav">
  24 <a accesskey="p" href="skip.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../xpressive/reference.html#header.boost.xpressive.regex_token_iterator_hpp"><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="regex_traits_version_1_tag.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
  25 </div>
  26 <div class="refentry">
  27 <a name="boost.xpressive.regex_token_iterator"></a><div class="titlepage"></div>
  28 <div class="refnamediv">
  29 <h2><span class="refentrytitle">Struct template regex_token_iterator</span></h2>
  30 <p>boost::xpressive::regex_token_iterator</p>
  31 </div>
  32 <h2 xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv-title">Synopsis</h2>
  33 <div xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv"><pre class="synopsis"><span class="comment">// In header: &lt;<a class="link" href="../../xpressive/reference.html#header.boost.xpressive.regex_token_iterator_hpp" title="Header &lt;boost/xpressive/regex_token_iterator.hpp&gt;">boost/xpressive/regex_token_iterator.hpp</a>&gt;
  34
  35 </span><span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">typename</span> BidiIter<span class="special">&gt;</span>
  36 <span class="keyword">struct</span> <a class="link" href="regex_token_iterator.html" title="Struct template regex_token_iterator">regex_token_iterator</a> <span class="special">{</span>
  37   <span class="comment">// types</span>
  38   <span class="keyword">typedef</span> <a class="link" href="basic_regex.html" title="Struct template basic_regex">basic_regex</a><span class="special">&lt;</span> <span class="identifier">BidiIter</span> <span class="special">&gt;</span>          <a name="boost.xpressive.regex_token_iterator.regex_type"></a><span class="identifier">regex_type</span><span class="special">;</span>
  39   <span class="keyword">typedef</span> <span class="identifier">iterator_value</span><span class="special">&lt;</span> <span class="identifier">BidiIter</span> <span class="special">&gt;</span><span class="special">::</span><span class="identifier">type</span> <a name="boost.xpressive.regex_token_iterator.char_type"></a><span class="identifier">char_type</span><span class="special">;</span>
  40   <span class="keyword">typedef</span> <a class="link" href="sub_match.html" title="Struct template sub_match">sub_match</a><span class="special">&lt;</span> <span class="identifier">BidiIter</span> <span class="special">&gt;</span>            <a name="boost.xpressive.regex_token_iterator.value_type"></a><span class="identifier">value_type</span><span class="special">;</span>
  41   <span class="keyword">typedef</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">ptrdiff_t</span>                   <a name="boost.xpressive.regex_token_iterator.difference_type"></a><span class="identifier">difference_type</span><span class="special">;</span>
  42   <span class="keyword">typedef</span> <span class="identifier">value_type</span> <span class="keyword">const</span> <span class="special">*</span>               <a name="boost.xpressive.regex_token_iterator.pointer"></a><span class="identifier">pointer</span><span class="special">;</span>
  43   <span class="keyword">typedef</span> <span class="identifier">value_type</span> <span class="keyword">const</span> <span class="special">&amp;</span>               <a name="boost.xpressive.regex_token_iterator.reference"></a><span class="identifier">reference</span><span class="special">;</span>
  44   <span class="keyword">typedef</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">forward_iterator_tag</span>        <a name="boost.xpressive.regex_token_iterator.iterator_category"></a><span class="identifier">iterator_category</span><span class="special">;</span>
  45
  46   <span class="comment">// <a class="link" href="regex_token_iterator.html#boost.xpressive.regex_token_iteratorconstruct-copy-destruct">construct/copy/destruct</a></span>
  47   <a class="link" href="regex_token_iterator.html#idp784878128-bb"><span class="identifier">regex_token_iterator</span></a><span class="special">(</span><span class="special">)</span><span class="special">;</span>
  48   <a class="link" href="regex_token_iterator.html#idp784879552-bb"><span class="identifier">regex_token_iterator</span></a><span class="special">(</span><span class="identifier">BidiIter</span><span class="special">,</span> <span class="identifier">BidiIter</span><span class="special">,</span> <a class="link" href="basic_regex.html" title="Struct template basic_regex">basic_regex</a><span class="special">&lt;</span> <span class="identifier">BidiIter</span> <span class="special">&gt;</span> <span class="keyword">const</span> <span class="special">&amp;</span><span class="special">)</span><span class="special">;</span>
  49   <span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">typename</span> LetExpr<span class="special">&gt;</span>
  50     <a class="link" href="regex_token_iterator.html#idp784884496-bb"><span class="identifier">regex_token_iterator</span></a><span class="special">(</span><span class="identifier">BidiIter</span><span class="special">,</span> <span class="identifier">BidiIter</span><span class="special">,</span> <a class="link" href="basic_regex.html" title="Struct template basic_regex">basic_regex</a><span class="special">&lt;</span> <span class="identifier">BidiIter</span> <span class="special">&gt;</span> <span class="keyword">const</span> <span class="special">&amp;</span><span class="special">,</span>
  51                          <span class="emphasis"><em><span class="identifier">unspecified</span></em></span><span class="special">)</span><span class="special">;</span>
  52   <span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">typename</span> Subs<span class="special">&gt;</span>
  53     <a class="link" href="regex_token_iterator.html#idp784891568-bb"><span class="identifier">regex_token_iterator</span></a><span class="special">(</span><span class="identifier">BidiIter</span><span class="special">,</span> <span class="identifier">BidiIter</span><span class="special">,</span> <a class="link" href="basic_regex.html" title="Struct template basic_regex">basic_regex</a><span class="special">&lt;</span> <span class="identifier">BidiIter</span> <span class="special">&gt;</span> <span class="keyword">const</span> <span class="special">&amp;</span><span class="special">,</span>
  54                          <span class="identifier">Subs</span> <span class="keyword">const</span> <span class="special">&amp;</span><span class="special">,</span>
  55                          <span class="identifier">regex_constants</span><span class="special">::</span><span class="identifier">match_flag_type</span> <span class="special">=</span> <span class="identifier">regex_constants</span><span class="special">::</span><span class="identifier">match_default</span><span class="special">)</span><span class="special">;</span>
  56   <span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">typename</span> Subs<span class="special">,</span> <span class="keyword">typename</span> LetExpr<span class="special">&gt;</span>
  57     <a class="link" href="regex_token_iterator.html#idp784901120-bb"><span class="identifier">regex_token_iterator</span></a><span class="special">(</span><span class="identifier">BidiIter</span><span class="special">,</span> <span class="identifier">BidiIter</span><span class="special">,</span> <a class="link" href="basic_regex.html" title="Struct template basic_regex">basic_regex</a><span class="special">&lt;</span> <span class="identifier">BidiIter</span> <span class="special">&gt;</span> <span class="keyword">const</span> <span class="special">&amp;</span><span class="special">,</span>
  58                          <span class="identifier">Subs</span> <span class="keyword">const</span> <span class="special">&amp;</span><span class="special">,</span> <span class="emphasis"><em><span class="identifier">unspecified</span></em></span><span class="special">,</span>
  59                          <span class="identifier">regex_constants</span><span class="special">::</span><span class="identifier">match_flag_type</span> <span class="special">=</span> <span class="identifier">regex_constants</span><span class="special">::</span><span class="identifier">match_default</span><span class="special">)</span><span class="special">;</span>
  60   <a class="link" href="regex_token_iterator.html#idp784912512-bb"><span class="identifier">regex_token_iterator</span></a><span class="special">(</span><a class="link" href="regex_token_iterator.html" title="Struct template regex_token_iterator">regex_token_iterator</a><span class="special">&lt;</span> <span class="identifier">BidiIter</span> <span class="special">&gt;</span> <span class="keyword">const</span> <span class="special">&amp;</span><span class="special">)</span><span class="special">;</span>
  61   <a class="link" href="regex_token_iterator.html" title="Struct template regex_token_iterator">regex_token_iterator</a><span class="special">&lt;</span> <span class="identifier">BidiIter</span> <span class="special">&gt;</span> <span class="special">&amp;</span>
  62   <a class="link" href="regex_token_iterator.html#idp784914896-bb"><span class="keyword">operator</span><span class="special">=</span></a><span class="special">(</span><a class="link" href="regex_token_iterator.html" title="Struct template regex_token_iterator">regex_token_iterator</a><span class="special">&lt;</span> <span class="identifier">BidiIter</span> <span class="special">&gt;</span> <span class="keyword">const</span> <span class="special">&amp;</span><span class="special">)</span><span class="special">;</span>
  63
  64   <span class="comment">// <a class="link" href="regex_token_iterator.html#idp784870576-bb">public member functions</a></span>
  65   <span class="identifier">value_type</span> <span class="keyword">const</span> <span class="special">&amp;</span> <a class="link" href="regex_token_iterator.html#idp784871136-bb"><span class="keyword">operator</span><span class="special">*</span></a><span class="special">(</span><span class="special">)</span> <span class="keyword">const</span><span class="special">;</span>
  66   <span class="identifier">value_type</span> <span class="keyword">const</span> <span class="special">*</span> <a class="link" href="regex_token_iterator.html#idp784872256-bb"><span class="keyword">operator</span><span class="special">-&gt;</span></a><span class="special">(</span><span class="special">)</span> <span class="keyword">const</span><span class="special">;</span>
  67   <a class="link" href="regex_token_iterator.html" title="Struct template regex_token_iterator">regex_token_iterator</a><span class="special">&lt;</span> <span class="identifier">BidiIter</span> <span class="special">&gt;</span> <span class="special">&amp;</span> <a class="link" href="regex_token_iterator.html#idp784873376-bb"><span class="keyword">operator</span><span class="special">++</span></a><span class="special">(</span><span class="special">)</span><span class="special">;</span>
  68   <a class="link" href="regex_token_iterator.html" title="Struct template regex_token_iterator">regex_token_iterator</a><span class="special">&lt;</span> <span class="identifier">BidiIter</span> <span class="special">&gt;</span> <a class="link" href="regex_token_iterator.html#idp784876144-bb"><span class="keyword">operator</span><span class="special">++</span></a><span class="special">(</span><span class="keyword">int</span><span class="special">)</span><span class="special">;</span>
  69 <span class="special">}</span><span class="special">;</span></pre></div>
  70 <div class="refsect1">
  71 <a name="idp630702224"></a><h2>Description</h2>
  72 <div class="refsect2">
  73 <a name="idp630702640"></a><h3>
  74 <a name="boost.xpressive.regex_token_iteratorconstruct-copy-destruct"></a><code class="computeroutput">regex_token_iterator</code>
  75         public
  76        construct/copy/destruct</h3>
  77 <div class="orderedlist"><ol class="orderedlist" type="1">
  78 <li class="listitem">
  79 <pre class="literallayout"><a name="idp784878128-bb"></a><span class="identifier">regex_token_iterator</span><span class="special">(</span><span class="special">)</span><span class="special">;</span></pre>
  80 <p>
  81 </p>
  82 <div class="variablelist"><table border="0" class="variablelist compact">
  83 <colgroup>
  84 <col align="left" valign="top">
  85 <col>
  86 </colgroup>
  87 <tbody><tr>
  88 <td><p><span class="term">Postconditions:</span></p></td>
  89 <td><p><code class="computeroutput">*this</code> is the end of sequence iterator. </p></td>
  90 </tr></tbody>
  91 </table></div>
  92 </li>
  93 <li class="listitem">
  94 <pre class="literallayout"><a name="idp784879552-bb"></a><span class="identifier">regex_token_iterator</span><span class="special">(</span><span class="identifier">BidiIter</span> begin<span class="special">,</span> <span class="identifier">BidiIter</span> end<span class="special">,</span>
  95                      <a class="link" href="basic_regex.html" title="Struct template basic_regex">basic_regex</a><span class="special">&lt;</span> <span class="identifier">BidiIter</span> <span class="special">&gt;</span> <span class="keyword">const</span> <span class="special">&amp;</span> rex<span class="special">)</span><span class="special">;</span></pre>
  96 <p>
  97
  98 </p>
  99 <div class="variablelist"><table border="0" class="variablelist compact">
 100 <colgroup>
 101 <col align="left" valign="top">
 102 <col>
 103 </colgroup>
 104 <tbody>
 105 <tr>
 106 <td><p><span class="term">Parameters:</span></p></td>
 107 <td><div class="variablelist"><table border="0" class="variablelist compact">
 108 <colgroup>
 109 <col align="left" valign="top">
 110 <col>
 111 </colgroup>
 112 <tbody>
 113 <tr>
 114 <td><p><span class="term"><code class="computeroutput">begin</code></span></p></td>
 115 <td><p>The beginning of the character range to search. </p></td>
 116 </tr>
 117 <tr>
 118 <td><p><span class="term"><code class="computeroutput">end</code></span></p></td>
 119 <td><p>The end of the character range to search. </p></td>
 120 </tr>
 121 <tr>
 122 <td><p><span class="term"><code class="computeroutput">rex</code></span></p></td>
 123 <td><p>The regex pattern to search for. </p></td>
 124 </tr>
 125 </tbody>
 126 </table></div></td>
 127 </tr>
 128 <tr>
 129 <td><p><span class="term">Requires:</span></p></td>
 130 <td><p><code class="computeroutput"></code>[begin,end) is a valid range. </p></td>
 131 </tr>
 132 </tbody>
 133 </table></div>
 134 </li>
 135 <li class="listitem">
 136 <pre class="literallayout"><span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">typename</span> LetExpr<span class="special">&gt;</span>
 137   <a name="idp784884496-bb"></a><span class="identifier">regex_token_iterator</span><span class="special">(</span><span class="identifier">BidiIter</span> begin<span class="special">,</span> <span class="identifier">BidiIter</span> end<span class="special">,</span>
 138                        <a class="link" href="basic_regex.html" title="Struct template basic_regex">basic_regex</a><span class="special">&lt;</span> <span class="identifier">BidiIter</span> <span class="special">&gt;</span> <span class="keyword">const</span> <span class="special">&amp;</span> rex<span class="special">,</span> <span class="emphasis"><em><span class="identifier">unspecified</span></em></span> args<span class="special">)</span><span class="special">;</span></pre>
 139 <p>
 140
 141 </p>
 142 <div class="variablelist"><table border="0" class="variablelist compact">
 143 <colgroup>
 144 <col align="left" valign="top">
 145 <col>
 146 </colgroup>
 147 <tbody>
 148 <tr>
 149 <td><p><span class="term">Parameters:</span></p></td>
 150 <td><div class="variablelist"><table border="0" class="variablelist compact">
 151 <colgroup>
 152 <col align="left" valign="top">
 153 <col>
 154 </colgroup>
 155 <tbody>
 156 <tr>
 157 <td><p><span class="term"><code class="computeroutput">args</code></span></p></td>
 158 <td><p>A let() expression with argument bindings for semantic actions. </p></td>
 159 </tr>
 160 <tr>
 161 <td><p><span class="term"><code class="computeroutput">begin</code></span></p></td>
 162 <td><p>The beginning of the character range to search. </p></td>
 163 </tr>
 164 <tr>
 165 <td><p><span class="term"><code class="computeroutput">end</code></span></p></td>
 166 <td><p>The end of the character range to search. </p></td>
 167 </tr>
 168 <tr>
 169 <td><p><span class="term"><code class="computeroutput">rex</code></span></p></td>
 170 <td><p>The regex pattern to search for. </p></td>
 171 </tr>
 172 </tbody>
 173 </table></div></td>
 174 </tr>
 175 <tr>
 176 <td><p><span class="term">Requires:</span></p></td>
 177 <td><p><code class="computeroutput"></code>[begin,end) is a valid range. </p></td>
 178 </tr>
 179 </tbody>
 180 </table></div>
 181 </li>
 182 <li class="listitem">
 183 <pre class="literallayout"><span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">typename</span> Subs<span class="special">&gt;</span>
 184   <a name="idp784891568-bb"></a><span class="identifier">regex_token_iterator</span><span class="special">(</span><span class="identifier">BidiIter</span> begin<span class="special">,</span> <span class="identifier">BidiIter</span> end<span class="special">,</span>
 185                        <a class="link" href="basic_regex.html" title="Struct template basic_regex">basic_regex</a><span class="special">&lt;</span> <span class="identifier">BidiIter</span> <span class="special">&gt;</span> <span class="keyword">const</span> <span class="special">&amp;</span> rex<span class="special">,</span>
 186                        <span class="identifier">Subs</span> <span class="keyword">const</span> <span class="special">&amp;</span> subs<span class="special">,</span>
 187                        <span class="identifier">regex_constants</span><span class="special">::</span><span class="identifier">match_flag_type</span> flags <span class="special">=</span> <span class="identifier">regex_constants</span><span class="special">::</span><span class="identifier">match_default</span><span class="special">)</span><span class="special">;</span></pre>
 188 <p>
 189
 190 </p>
 191 <div class="variablelist"><table border="0" class="variablelist compact">
 192 <colgroup>
 193 <col align="left" valign="top">
 194 <col>
 195 </colgroup>
 196 <tbody>
 197 <tr>
 198 <td><p><span class="term">Parameters:</span></p></td>
 199 <td><div class="variablelist"><table border="0" class="variablelist compact">
 200 <colgroup>
 201 <col align="left" valign="top">
 202 <col>
 203 </colgroup>
 204 <tbody>
 205 <tr>
 206 <td><p><span class="term"><code class="computeroutput">begin</code></span></p></td>
 207 <td><p>The beginning of the character range to search. </p></td>
 208 </tr>
 209 <tr>
 210 <td><p><span class="term"><code class="computeroutput">end</code></span></p></td>
 211 <td><p>The end of the character range to search. </p></td>
 212 </tr>
 213 <tr>
 214 <td><p><span class="term"><code class="computeroutput">flags</code></span></p></td>
 215 <td><p>Optional match flags, used to control how the expression is matched against the sequence. (See match_flag_type.) </p></td>
 216 </tr>
 217 <tr>
 218 <td><p><span class="term"><code class="computeroutput">rex</code></span></p></td>
 219 <td><p>The regex pattern to search for. </p></td>
 220 </tr>
 221 <tr>
 222 <td><p><span class="term"><code class="computeroutput">subs</code></span></p></td>
 223 <td><p>A range of integers designating sub-matches to be treated as tokens. </p></td>
 224 </tr>
 225 </tbody>
 226 </table></div></td>
 227 </tr>
 228 <tr>
 229 <td><p><span class="term">Requires:</span></p></td>
 230 <td>
 231 <p><code class="computeroutput"></code>[begin,end) is a valid range. </p>
 232 <p><code class="computeroutput">subs</code> is either an integer greater or equal to -1, or else an array or non-empty <code class="computeroutput">std::vector&lt;&gt;</code> of such integers. </p>
 233 </td>
 234 </tr>
 235 </tbody>
 236 </table></div>
 237 </li>
 238 <li class="listitem">
 239 <pre class="literallayout"><span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">typename</span> Subs<span class="special">,</span> <span class="keyword">typename</span> LetExpr<span class="special">&gt;</span>
 240   <a name="idp784901120-bb"></a><span class="identifier">regex_token_iterator</span><span class="special">(</span><span class="identifier">BidiIter</span> begin<span class="special">,</span> <span class="identifier">BidiIter</span> end<span class="special">,</span>
 241                        <a class="link" href="basic_regex.html" title="Struct template basic_regex">basic_regex</a><span class="special">&lt;</span> <span class="identifier">BidiIter</span> <span class="special">&gt;</span> <span class="keyword">const</span> <span class="special">&amp;</span> rex<span class="special">,</span>
 242                        <span class="identifier">Subs</span> <span class="keyword">const</span> <span class="special">&amp;</span> subs<span class="special">,</span> <span class="emphasis"><em><span class="identifier">unspecified</span></em></span> args<span class="special">,</span>
 243                        <span class="identifier">regex_constants</span><span class="special">::</span><span class="identifier">match_flag_type</span> flags <span class="special">=</span> <span class="identifier">regex_constants</span><span class="special">::</span><span class="identifier">match_default</span><span class="special">)</span><span class="special">;</span></pre>
 244 <p>
 245
 246 </p>
 247 <div class="variablelist"><table border="0" class="variablelist compact">
 248 <colgroup>
 249 <col align="left" valign="top">
 250 <col>
 251 </colgroup>
 252 <tbody>
 253 <tr>
 254 <td><p><span class="term">Parameters:</span></p></td>
 255 <td><div class="variablelist"><table border="0" class="variablelist compact">
 256 <colgroup>
 257 <col align="left" valign="top">
 258 <col>
 259 </colgroup>
 260 <tbody>
 261 <tr>
 262 <td><p><span class="term"><code class="computeroutput">args</code></span></p></td>
 263 <td><p>A let() expression with argument bindings for semantic actions. </p></td>
 264 </tr>
 265 <tr>
 266 <td><p><span class="term"><code class="computeroutput">begin</code></span></p></td>
 267 <td><p>The beginning of the character range to search. </p></td>
 268 </tr>
 269 <tr>
 270 <td><p><span class="term"><code class="computeroutput">end</code></span></p></td>
 271 <td><p>The end of the character range to search. </p></td>
 272 </tr>
 273 <tr>
 274 <td><p><span class="term"><code class="computeroutput">flags</code></span></p></td>
 275 <td><p>Optional match flags, used to control how the expression is matched against the sequence. (See match_flag_type.) </p></td>
 276 </tr>
 277 <tr>
 278 <td><p><span class="term"><code class="computeroutput">rex</code></span></p></td>
 279 <td><p>The regex pattern to search for. </p></td>
 280 </tr>
 281 <tr>
 282 <td><p><span class="term"><code class="computeroutput">subs</code></span></p></td>
 283 <td><p>A range of integers designating sub-matches to be treated as tokens. </p></td>
 284 </tr>
 285 </tbody>
 286 </table></div></td>
 287 </tr>
 288 <tr>
 289 <td><p><span class="term">Requires:</span></p></td>
 290 <td>
 291 <p><code class="computeroutput"></code>[begin,end) is a valid range. </p>
 292 <p><code class="computeroutput">subs</code> is either an integer greater or equal to -1, or else an array or non-empty <code class="computeroutput">std::vector&lt;&gt;</code> of such integers. </p>
 293 </td>
 294 </tr>
 295 </tbody>
 296 </table></div>
 297 </li>
 298 <li class="listitem">
 299 <pre class="literallayout"><a name="idp784912512-bb"></a><span class="identifier">regex_token_iterator</span><span class="special">(</span><a class="link" href="regex_token_iterator.html" title="Struct template regex_token_iterator">regex_token_iterator</a><span class="special">&lt;</span> <span class="identifier">BidiIter</span> <span class="special">&gt;</span> <span class="keyword">const</span> <span class="special">&amp;</span> that<span class="special">)</span><span class="special">;</span></pre>
 300 <p>
 301 </p>
 302 <div class="variablelist"><table border="0" class="variablelist compact">
 303 <colgroup>
 304 <col align="left" valign="top">
 305 <col>
 306 </colgroup>
 307 <tbody><tr>
 308 <td><p><span class="term">Postconditions:</span></p></td>
 309 <td><p><code class="computeroutput">*this == that</code> </p></td>
 310 </tr></tbody>
 311 </table></div>
 312 </li>
 313 <li class="listitem">
 314 <pre class="literallayout"><a class="link" href="regex_token_iterator.html" title="Struct template regex_token_iterator">regex_token_iterator</a><span class="special">&lt;</span> <span class="identifier">BidiIter</span> <span class="special">&gt;</span> <span class="special">&amp;</span>
 315 <a name="idp784914896-bb"></a><span class="keyword">operator</span><span class="special">=</span><span class="special">(</span><a class="link" href="regex_token_iterator.html" title="Struct template regex_token_iterator">regex_token_iterator</a><span class="special">&lt;</span> <span class="identifier">BidiIter</span> <span class="special">&gt;</span> <span class="keyword">const</span> <span class="special">&amp;</span> that<span class="special">)</span><span class="special">;</span></pre>
 316 <p>
 317 </p>
 318 <div class="variablelist"><table border="0" class="variablelist compact">
 319 <colgroup>
 320 <col align="left" valign="top">
 321 <col>
 322 </colgroup>
 323 <tbody><tr>
 324 <td><p><span class="term">Postconditions:</span></p></td>
 325 <td><p><code class="computeroutput">*this == that</code> </p></td>
 326 </tr></tbody>
 327 </table></div>
 328 </li>
 329 </ol></div>
 330 </div>
 331 <div class="refsect2">
 332 <a name="idp630842800"></a><h3>
 333 <a name="idp784870576-bb"></a><code class="computeroutput">regex_token_iterator</code> public member functions</h3>
 334 <div class="orderedlist"><ol class="orderedlist" type="1">
 335 <li class="listitem"><pre class="literallayout"><span class="identifier">value_type</span> <span class="keyword">const</span> <span class="special">&amp;</span> <a name="idp784871136-bb"></a><span class="keyword">operator</span><span class="special">*</span><span class="special">(</span><span class="special">)</span> <span class="keyword">const</span><span class="special">;</span></pre></li>
 336 <li class="listitem"><pre class="literallayout"><span class="identifier">value_type</span> <span class="keyword">const</span> <span class="special">*</span> <a name="idp784872256-bb"></a><span class="keyword">operator</span><span class="special">-&gt;</span><span class="special">(</span><span class="special">)</span> <span class="keyword">const</span><span class="special">;</span></pre></li>
 337 <li class="listitem">
 338 <pre class="literallayout"><a class="link" href="regex_token_iterator.html" title="Struct template regex_token_iterator">regex_token_iterator</a><span class="special">&lt;</span> <span class="identifier">BidiIter</span> <span class="special">&gt;</span> <span class="special">&amp;</span> <a name="idp784873376-bb"></a><span class="keyword">operator</span><span class="special">++</span><span class="special">(</span><span class="special">)</span><span class="special">;</span></pre>
 339 <p>If N == -1 then sets *this equal to the end of sequence iterator. Otherwise if N+1 &lt; subs.size(), then increments N and sets result equal to ((subs[N] == -1) ? value_type(what.prefix().str()) : value_type(what[subs[N]].str())). Otherwise if what.prefix().first != what[0].second and if the element match_prev_avail is not set in flags then sets it. Then locates the next match as if by calling regex_search(what[0].second, end, what, *pre, flags), with the following variation: in the event that the previous match found was of zero length (what[0].length() == 0) then attempts to find a non-zero length match starting at what[0].second, only if that fails and provided what[0].second != suffix().second does it look for a (possibly zero length) match starting from what[0].second + 1. If such a match is found then sets N equal to zero, and sets result equal to ((subs[N] == -1) ? value_type(what.prefix().str()) : value_type(what[subs[N]].str())). Otherwise if no further matches were found, then let last_end be the endpoint of the last match that was found. Then if last_end != end and subs[0] == -1 sets N equal to -1 and sets result equal to value_type(last_end, end). Otherwise sets *this equal to the end of sequence iterator. </p>
 340 </li>
 341 <li class="listitem"><pre class="literallayout"><a class="link" href="regex_token_iterator.html" title="Struct template regex_token_iterator">regex_token_iterator</a><span class="special">&lt;</span> <span class="identifier">BidiIter</span> <span class="special">&gt;</span> <a name="idp784876144-bb"></a><span class="keyword">operator</span><span class="special">++</span><span class="special">(</span><span class="keyword">int</span><span class="special">)</span><span class="special">;</span></pre></li>
 342 </ol></div>
 343 </div>
 344 </div>
 345 </div>
 346 <table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
 347 <td align="left"></td>
 348 <td align="right"><div class="copyright-footer">Copyright &#169; 2007 Eric Niebler<p>
 349         Distributed under the Boost Software License, Version 1.0. (See accompanying
 350         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>)
 351       </p>
 352 </div></td>
 353 </tr></table>
 354 <hr>
 355 <div class="spirit-nav">
 356 <a accesskey="p" href="skip.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../xpressive/reference.html#header.boost.xpressive.regex_token_iterator_hpp"><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="regex_traits_version_1_tag.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
 357 </div>
 358 </body>
 359 </html>