<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
<title>GNU CommonC++: ost::StringTokenizer::iterator Class Reference</title>
<link href="doxygen.css" rel="stylesheet" type="text/css">
<link href="tabs.css" rel="stylesheet" type="text/css">
</head><body>
<!-- Generated by Doxygen 1.4.6 -->
<div class="tabs">
<ul>
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li id="current"><a href="classes.html"><span>Classes</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="examples.html"><span>Examples</span></a></li>
</ul></div>
<div class="tabs">
<ul>
<li><a href="classes.html"><span>Alphabetical List</span></a></li>
<li><a href="annotated.html"><span>Class List</span></a></li>
<li><a href="hierarchy.html"><span>Class Hierarchy</span></a></li>
<li><a href="functions.html"><span>Class Members</span></a></li>
</ul></div>
<div class="nav">
<a class="el" href="namespaceost.html">ost</a>::<a class="el" href="classost_1_1_string_tokenizer.html">StringTokenizer</a>::<a class="el" href="classost_1_1_string_tokenizer_1_1iterator.html">iterator</a></div>
<h1>ost::StringTokenizer::iterator Class Reference</h1><!-- doxytag: class="ost::StringTokenizer::iterator" -->The input forward iterator for tokens.
<a href="#_details">More...</a>
<p>
<code>#include <<a class="el" href="tokenizer_8h-source.html">tokenizer.h</a>></code>
<p>
<a href="classost_1_1_string_tokenizer_1_1iterator-members.html">List of all members.</a><table border="0" cellpadding="0" cellspacing="0">
<tr><td></td></tr>
<tr><td colspan="2"><br><h2>Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_string_tokenizer_1_1iterator.html#e6300cd59e2f0026319f5f8860d086d3">iterator</a> ()</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_string_tokenizer_1_1iterator.html#365b92953a6e7b19287a12cb9fe61904">~iterator</a> ()</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_string_tokenizer_1_1iterator.html#1c99b3999e0c08589666c22830c54b62">iterator</a> (const <a class="el" href="classost_1_1_string_tokenizer_1_1iterator.html">iterator</a> &i)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">copy constructor. <a href="#1c99b3999e0c08589666c22830c54b62"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classost_1_1_string_tokenizer_1_1iterator.html">iterator</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_string_tokenizer_1_1iterator.html#8cfac0a3036d1a1a41f8bc0e0c837515">operator=</a> (const <a class="el" href="classost_1_1_string_tokenizer_1_1iterator.html">iterator</a> &i)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">assignment operator. <a href="#8cfac0a3036d1a1a41f8bc0e0c837515"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classost_1_1_string_tokenizer_1_1iterator.html">iterator</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_string_tokenizer_1_1iterator.html#5da247325e2d1ace75f4f772438f0419">operator++</a> () THROWS(<a class="el" href="classost_1_1_string_tokenizer_1_1_no_such_element_exception.html">NoSuchElementException</a>)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">shifts this iterator to the next token in the string. <a href="#5da247325e2d1ace75f4f772438f0419"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_string_tokenizer_1_1iterator.html#acd7b122f9cd760297a2ce0d31be6c3d">operator *</a> () THROWS(<a class="el" href="classost_1_1_string_tokenizer_1_1_no_such_element_exception.html">NoSuchElementException</a>)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">returns the immutable string this iterator points to or '0' if no token is available (i.e. <a href="#acd7b122f9cd760297a2ce0d31be6c3d"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">char </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_string_tokenizer_1_1iterator.html#3aa3b96b05055ef6e58a13c1418b20b7">nextDelimiter</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">returns the next delimiter after the current token or '\0', if there are no following delimiters. <a href="#3aa3b96b05055ef6e58a13c1418b20b7"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_string_tokenizer_1_1iterator.html#bc13d5278b0706125d72e28df2e98ba7">operator==</a> (const <a class="el" href="classost_1_1_string_tokenizer_1_1iterator.html">iterator</a> &other) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">compares to other iterator. <a href="#bc13d5278b0706125d72e28df2e98ba7"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_string_tokenizer_1_1iterator.html#2c844808f928c1f939534c49a12d3a94">operator!=</a> (const <a class="el" href="classost_1_1_string_tokenizer_1_1iterator.html">iterator</a> &other) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">compares to other iterator. <a href="#2c844808f928c1f939534c49a12d3a94"></a><br></td></tr>
<tr><td colspan="2"><br><h2>Friends</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_string_tokenizer_1_1iterator.html#e4c807aed5a3c9b17fa4b6f44e1f8012">StringTokenizer</a></td></tr>
</table>
<hr><a name="_details"></a><h2>Detailed Description</h2>
The input forward iterator for tokens.
<p>
<dl compact><dt><b>Author:</b></dt><dd>Henner Zeller </dd></dl>
<p>
<hr><h2>Constructor & Destructor Documentation</h2>
<a class="anchor" name="e6300cd59e2f0026319f5f8860d086d3"></a><!-- doxytag: member="ost::StringTokenizer::iterator::iterator" ref="e6300cd59e2f0026319f5f8860d086d3" args="()" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">ost::StringTokenizer::iterator::iterator </td>
<td class="md" valign="top">( </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap><code> [inline]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a class="anchor" name="365b92953a6e7b19287a12cb9fe61904"></a><!-- doxytag: member="ost::StringTokenizer::iterator::~iterator" ref="365b92953a6e7b19287a12cb9fe61904" args="()" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">virtual ost::StringTokenizer::iterator::~iterator </td>
<td class="md" valign="top">( </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap><code> [inline, virtual]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a class="anchor" name="1c99b3999e0c08589666c22830c54b62"></a><!-- doxytag: member="ost::StringTokenizer::iterator::iterator" ref="1c99b3999e0c08589666c22830c54b62" args="(const iterator &i)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">ost::StringTokenizer::iterator::iterator </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="classost_1_1_string_tokenizer_1_1iterator.html">iterator</a> & </td>
<td class="mdname1" valign="top" nowrap> <em>i</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap><code> [inline]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
copy constructor.
<p>
</td>
</tr>
</table>
<hr><h2>Member Function Documentation</h2>
<a class="anchor" name="3aa3b96b05055ef6e58a13c1418b20b7"></a><!-- doxytag: member="ost::StringTokenizer::iterator::nextDelimiter" ref="3aa3b96b05055ef6e58a13c1418b20b7" args="() const " --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">char ost::StringTokenizer::iterator::nextDelimiter </td>
<td class="md" valign="top">( </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap> const<code> [inline]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
returns the next delimiter after the current token or '\0', if there are no following delimiters.
<p>
It returns the very next delimiter (even if skipAllDelim=true). </td>
</tr>
</table>
<a class="anchor" name="acd7b122f9cd760297a2ce0d31be6c3d"></a><!-- doxytag: member="ost::StringTokenizer::iterator::operator *" ref="acd7b122f9cd760297a2ce0d31be6c3d" args="() THROWS(NoSuchElementException)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">const char* ost::StringTokenizer::iterator::operator * </td>
<td class="md" valign="top">( </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
returns the immutable string this iterator points to or '0' if no token is available (i.e.
<p>
i == <a class="el" href="classost_1_1_string_tokenizer.html#74b3471e3e481c0144758385c29cbfbf">end()</a>). Do not store pointers to this token, since it is invalidated for each iteration. If you need the token, copy it (e.g. with <a class="el" href="namespaceost.html#945b275fab2dac13c0f0b8b46e7c14b4">strdup()</a>); </td>
</tr>
</table>
<a class="anchor" name="2c844808f928c1f939534c49a12d3a94"></a><!-- doxytag: member="ost::StringTokenizer::iterator::operator!=" ref="2c844808f928c1f939534c49a12d3a94" args="(const iterator &other) const " --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">bool ost::StringTokenizer::iterator::operator!= </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="classost_1_1_string_tokenizer_1_1iterator.html">iterator</a> & </td>
<td class="mdname1" valign="top" nowrap> <em>other</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap> const<code> [inline]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
compares to other iterator.
<p>
Usually used to compare against the <a class="el" href="classost_1_1_string_tokenizer.html#74b3471e3e481c0144758385c29cbfbf">end()</a> iterator. </td>
</tr>
</table>
<a class="anchor" name="5da247325e2d1ace75f4f772438f0419"></a><!-- doxytag: member="ost::StringTokenizer::iterator::operator++" ref="5da247325e2d1ace75f4f772438f0419" args="() THROWS(NoSuchElementException)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"><a class="el" href="classost_1_1_string_tokenizer_1_1iterator.html">iterator</a>& ost::StringTokenizer::iterator::operator++ </td>
<td class="md" valign="top">( </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
shifts this iterator to the next token in the string.
<p>
</td>
</tr>
</table>
<a class="anchor" name="8cfac0a3036d1a1a41f8bc0e0c837515"></a><!-- doxytag: member="ost::StringTokenizer::iterator::operator=" ref="8cfac0a3036d1a1a41f8bc0e0c837515" args="(const iterator &i)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"><a class="el" href="classost_1_1_string_tokenizer_1_1iterator.html">iterator</a>& ost::StringTokenizer::iterator::operator= </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="classost_1_1_string_tokenizer_1_1iterator.html">iterator</a> & </td>
<td class="mdname1" valign="top" nowrap> <em>i</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap><code> [inline]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
assignment operator.
<p>
</td>
</tr>
</table>
<a class="anchor" name="bc13d5278b0706125d72e28df2e98ba7"></a><!-- doxytag: member="ost::StringTokenizer::iterator::operator==" ref="bc13d5278b0706125d72e28df2e98ba7" args="(const iterator &other) const " --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">bool ost::StringTokenizer::iterator::operator== </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="classost_1_1_string_tokenizer_1_1iterator.html">iterator</a> & </td>
<td class="mdname1" valign="top" nowrap> <em>other</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap> const<code> [inline]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
compares to other iterator.
<p>
Usually used to compare against the <a class="el" href="classost_1_1_string_tokenizer.html#74b3471e3e481c0144758385c29cbfbf">end()</a> iterator. </td>
</tr>
</table>
<hr><h2>Friends And Related Function Documentation</h2>
<a class="anchor" name="e4c807aed5a3c9b17fa4b6f44e1f8012"></a><!-- doxytag: member="ost::StringTokenizer::iterator::StringTokenizer" ref="e4c807aed5a3c9b17fa4b6f44e1f8012" args="" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">friend class <a class="el" href="classost_1_1_string_tokenizer.html">StringTokenizer</a><code> [friend]</code> </td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<hr>The documentation for this class was generated from the following file:<ul>
<li><a class="el" href="tokenizer_8h-source.html">tokenizer.h</a></ul>
<hr size="1"><address style="align: right;"><small>Generated on Mon Jun 19 10:50:58 2006 for GNU CommonC++ by
<a href="http://www.doxygen.org/index.html">
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.4.6 </small></address>
</body>
</html>
