~oif-team/ubuntu/natty/qt4-x11/xi2.1

<td width="1">  </td><td class="postheader" valign="center"><a href="index.html"><font color="#004faf">Home</font></a> · <a href="namespaces.html"><font color="#004faf">All Namespaces</font></a> · <a href="classes.html"><font color="#004faf">All Classes</font></a> · <a href="mainclasses.html"><font color="#004faf">Main Classes</font></a> · <a href="groups.html"><font color="#004faf">Grouped Classes</font></a> · <a href="modules.html"><font color="#004faf">Modules</font></a> · <a href="functions.html"><font color="#004faf">Functions</font></a></td>

<td align="right" valign="top" width="230"></td></tr></table><h1 class="title">iterator Class Reference<br /><span class="small-subtitle">(QLinkedList::iterator)<br />[<a href="qtcore.html">QtCore</a> module]</span>

<td width="1">  </td><td class="postheader" valign="center"><a href="index.html"><font color="#004faf">Home</font></a> · <a href="classes.html"><font color="#004faf">All Classes</font></a> · <a href="functions.html"><font color="#004faf">All Functions</font></a> · <a href="overviews.html"><font color="#004faf">Overviews</font></a></td><td class="searchBar" align="right" valign="center"><form action="http://www.google.com/cse" id="cse-search-box"><div><input type="hidden" name="cx" value="000136343326384750312:dhbxnqlakyu" /><input type="hidden" name="ie" value="UTF-8" /><input type="text" name="q" size="31" /><input type="submit" name="sa" value="Search" /></div></form></td>

</tr></table><h1 class="title">iterator Class Reference<br /><span class="small-subtitle">(QLinkedList::iterator)<br />[<a href="qtcore.html">QtCore</a> module]</span>

</h1>

<p>The QLinkedList::iterator class provides an STL-style non-const iterator for <a href="qlinkedlist.html">QLinkedList</a>. <a href="#details">More...</a></p>

<pre> #include <<a href="qlinkedlist.html">QLinkedList</a>></pre><p>Inherited by <a href="q3valuelistiterator.html" class="compat">Q3ValueListIterator</a>.</p>

<ul>

<li><a href="qlinkedlist-iterator-members.html">List of all members, including inherited members</a></li>

</ul>

<hr />

<h3>Public Functions</h3>

<ul>

<li><div class="fn"></div><b><a href="qlinkedlist-iterator.html#iterator">iterator</a></b> ()</li>

<li><div class="fn"></div><b><a href="qlinkedlist-iterator.html#iterator-3">iterator</a></b> ( const iterator & <i>other</i> )</li>

<li><div class="fn"></div>bool <b><a href="qlinkedlist-iterator.html#operator-not-eq">operator!=</a></b> ( const iterator & <i>other</i> ) const</li>

<li><div class="fn"></div>bool <b><a href="qlinkedlist-iterator.html#operator-not-eq-2">operator!=</a></b> ( const const_iterator & <i>other</i> ) const</li>

<li><div class="fn"></div>T & <b><a href="qlinkedlist-iterator.html#operator-2a">operator*</a></b> () const</li>

<li><div class="fn"></div>iterator <b><a href="qlinkedlist-iterator.html#operator-2b">operator+</a></b> ( int <i>j</i> ) const</li>

<li><div class="fn"></div>iterator & <b><a href="qlinkedlist-iterator.html#operator-2b-2b">operator++</a></b> ()</li>

<li><div class="fn"></div>iterator <b><a href="qlinkedlist-iterator.html#operator-2b-2b-2">operator++</a></b> ( int )</li>

<li><div class="fn"></div>iterator & <b><a href="qlinkedlist-iterator.html#operator-2b-eq">operator+=</a></b> ( int <i>j</i> )</li>

<li><div class="fn"></div>iterator <b><a href="qlinkedlist-iterator.html#operator-">operator-</a></b> ( int <i>j</i> ) const</li>

<li><div class="fn"></div>iterator & <b><a href="qlinkedlist-iterator.html#operator--">operator--</a></b> ()</li>

<li><div class="fn"></div>iterator <b><a href="qlinkedlist-iterator.html#operator---2">operator--</a></b> ( int )</li>

<li><div class="fn"></div>iterator & <b><a href="qlinkedlist-iterator.html#operator--eq">operator-=</a></b> ( int <i>j</i> )</li>

<li><div class="fn"></div>T * <b><a href="qlinkedlist-iterator.html#operator--gt">operator-></a></b> () const</li>

<li><div class="fn"></div>iterator & <b><a href="qlinkedlist-iterator.html#operator-eq">operator=</a></b> ( const iterator & <i>other</i> )</li>

<li><div class="fn"></div>bool <b><a href="qlinkedlist-iterator.html#operator-eq-eq">operator==</a></b> ( const iterator & <i>other</i> ) const</li>

<li><div class="fn"></div>bool <b><a href="qlinkedlist-iterator.html#operator-eq-eq-2">operator==</a></b> ( const const_iterator & <i>other</i> ) const</li>

</ul>

<h2>Public Functions</h2>

<tr><td class="memItemLeft" align="right" valign="top"></td><td class="memItemRight" valign="bottom"><b><a href="qlinkedlist-iterator.html#iterator">iterator</a></b> ()</td></tr>

<tr><td class="memItemLeft" align="right" valign="top"></td><td class="memItemRight" valign="bottom"><b><a href="qlinkedlist-iterator.html#iterator-3">iterator</a></b> ( const iterator & <i>other</i> )</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><b><a href="qlinkedlist-iterator.html#operator-not-eq">operator!=</a></b> ( const iterator & <i>other</i> ) const</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><b><a href="qlinkedlist-iterator.html#operator-not-eq-2">operator!=</a></b> ( const const_iterator & <i>other</i> ) const</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">T & </td><td class="memItemRight" valign="bottom"><b><a href="qlinkedlist-iterator.html#operator-2a">operator*</a></b> () const</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">iterator </td><td class="memItemRight" valign="bottom"><b><a href="qlinkedlist-iterator.html#operator-2b">operator+</a></b> ( int <i>j</i> ) const</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">iterator & </td><td class="memItemRight" valign="bottom"><b><a href="qlinkedlist-iterator.html#operator-2b-2b">operator++</a></b> ()</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">iterator & </td><td class="memItemRight" valign="bottom"><b><a href="qlinkedlist-iterator.html#operator-2b-eq">operator+=</a></b> ( int <i>j</i> )</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">iterator </td><td class="memItemRight" valign="bottom"><b><a href="qlinkedlist-iterator.html#operator-">operator-</a></b> ( int <i>j</i> ) const</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">iterator & </td><td class="memItemRight" valign="bottom"><b><a href="qlinkedlist-iterator.html#operator--">operator--</a></b> ()</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">iterator </td><td class="memItemRight" valign="bottom"><b><a href="qlinkedlist-iterator.html#operator---2">operator--</a></b> ( int )</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">T * </td><td class="memItemRight" valign="bottom"><b><a href="qlinkedlist-iterator.html#operator--gt">operator-></a></b> () const</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">iterator & </td><td class="memItemRight" valign="bottom"><b><a href="qlinkedlist-iterator.html#operator-eq">operator=</a></b> ( const iterator & <i>other</i> )</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><b><a href="qlinkedlist-iterator.html#operator-eq-eq">operator==</a></b> ( const iterator & <i>other</i> ) const</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><b><a href="qlinkedlist-iterator.html#operator-eq-eq-2">operator==</a></b> ( const const_iterator & <i>other</i> ) const</td></tr>

</table>

<hr />

<h2>Detailed Description</h2>

++i;

}</pre>

<p>However, this will potentially crash in <tt>++i</tt>, because <tt>i</tt> is a dangling iterator after the call to <a href="qlinkedlist.html#erase">erase</a>().</p>

<p>Multiple iterators can be used on the same list. If you add items to the list, existing iterators will remain valid. If you remove items from the list, iterators that point to the removed items will become dangling iterators. However, because of how <a href="shared.html#implicit-sharing">implicit sharing</a> works, you must not take a copy of a container while iterators are active on that container.</p>

<p>Multiple iterators can be used on the same list. If you add items to the list, existing iterators will remain valid. If you remove items from the list, iterators that point to the removed items will become dangling iterators. However, because of how <a href="implicit-sharing.html">implicit sharing</a> works, you must not take a copy of a container while iterators are active on that container.</p>

<p>See also <a href="qlinkedlist-const-iterator.html">QLinkedList::const_iterator</a> and <a href="qmutablelinkedlistiterator.html">QMutableLinkedListIterator</a>.</p>

100

<hr />

101

<h2>Member Function Documentation</h2>

102

100

103

<h3 class="fn"><a name="iterator"></a>iterator::iterator ()</h3>

101

104

<p>Constructs an uninitialized iterator.</p>

102

105

<p>Functions like operator*() and operator++() should not be called on an uninitialized iterator. Use operator=() to assign a value to it before using it.</p>

103

106

<p>See also <a href="qlinkedlist.html#begin">QLinkedList::begin</a>() and <a href="qlinkedlist.html#end">QLinkedList::end</a>().</p>

104

107

<h3 class="fn"><a name="iterator-3"></a>iterator::iterator ( const iterator & <i>other</i> )</h3>

105

108

<p>Constructs a copy of <i>other</i>.</p>

109

106

110

<h3 class="fn"><a name="operator-not-eq"></a>bool iterator::operator!= ( const iterator & <i>other</i> ) const</h3>

107

111

<p>Returns true if <i>other</i> points to a different item than this iterator; otherwise returns false.</p>

108

112

<p>See also <a href="qlinkedlist-iterator.html#operator-eq-eq">operator==</a>().</p>

109

113

<h3 class="fn"><a name="operator-not-eq-2"></a>bool iterator::operator!= ( const <a href="qlinkedlist-const-iterator.html">const_iterator</a> & <i>other</i> ) const</h3>

110

114

<p>Returns true if <i>other</i> points to a different item than this iterator; otherwise returns false.</p>

111

115

<p>See also <a href="qlinkedlist-iterator.html#operator-eq-eq">operator==</a>().</p>

116

112

117

<h3 class="fn"><a name="operator-2a"></a>T & iterator::operator* () const</h3>

113

118

<p>Returns a modifiable reference to the current item.</p>

114

119

<p>You can change the value of an item by using operator*() on the left side of an assignment, for example:</p>

115

120

<pre> if (*it == "Hello")

116

121

*it = "Bonjour";</pre>

117

122

<p>See also <a href="qlinkedlist-iterator.html#operator--gt">operator-></a>().</p>

123

118

124

<h3 class="fn"><a name="operator-2b"></a>iterator iterator::operator+ ( int <i>j</i> ) const</h3>

119

125

<p>Returns an iterator to the item at <i>j</i> positions forward from this iterator. (If <i>j</i> is negative, the iterator goes backward.)</p>

120

126

<p>This operation can be slow for large <i>j</i> values.</p>

121

127

<p>See also <a href="qlinkedlist-iterator.html#operator-">operator-</a>().</p>

128

122

129

<h3 class="fn"><a name="operator-2b-2b"></a>iterator & iterator::operator++ ()</h3>

123

130

<p>The prefix ++ operator (<tt>++it</tt>) advances the iterator to the next item in the list and returns an iterator to the new current item.</p>

124

131

<p>Calling this function on <a href="qlinkedlist.html#end">QLinkedList::end</a>() leads to undefined results.</p>

126

133

<h3 class="fn"><a name="operator-2b-2b-2"></a>iterator iterator::operator++ ( int )</h3>

127

134

<p>This is an overloaded function.</p>

128

135

<p>The postfix ++ operator (<tt>it++</tt>) advances the iterator to the next item in the list and returns an iterator to the previously current item.</p>

136

129

137

<h3 class="fn"><a name="operator-2b-eq"></a>iterator & iterator::operator+= ( int <i>j</i> )</h3>

130

138

<p>Advances the iterator by <i>j</i> items. (If <i>j</i> is negative, the iterator goes backward.)</p>

131

139

<p>See also <a href="qlinkedlist-iterator.html#operator--eq">operator-=</a>() and <a href="qlinkedlist-iterator.html#operator-2b">operator+</a>().</p>

140

132

141

<h3 class="fn"><a name="operator-"></a>iterator iterator::operator- ( int <i>j</i> ) const</h3>

133

142

<p>Returns an iterator to the item at <i>j</i> positions backward from this iterator. (If <i>j</i> is negative, the iterator goes forward.)</p>

134

143

<p>This operation can be slow for large <i>j</i> values.</p>

135

144

<p>See also <a href="qlinkedlist-iterator.html#operator-2b">operator+</a>().</p>

145

136

146

<h3 class="fn"><a name="operator--"></a>iterator & iterator::operator-- ()</h3>

137

147

<p>The prefix -- operator (<tt>--it</tt>) makes the preceding item current and returns an iterator to the new current item.</p>

138

148

<p>Calling this function on <a href="qlinkedlist.html#begin">QLinkedList::begin</a>() leads to undefined results.</p>

140

150

<h3 class="fn"><a name="operator---2"></a>iterator iterator::operator-- ( int )</h3>

141

151

<p>This is an overloaded function.</p>

142

152

<p>The postfix -- operator (<tt>it--</tt>) makes the preceding item current and returns an iterator to the previously current item.</p>

153

143

154

<h3 class="fn"><a name="operator--eq"></a>iterator & iterator::operator-= ( int <i>j</i> )</h3>

144

155

<p>Makes the iterator go back by <i>j</i> items. (If <i>j</i> is negative, the iterator goes forward.)</p>

145

156

<p>See also <a href="qlinkedlist-iterator.html#operator-2b-eq">operator+=</a>() and <a href="qlinkedlist-iterator.html#operator-">operator-</a>().</p>

157

146

158

<h3 class="fn"><a name="operator--gt"></a>T * iterator::operator-> () const</h3>

147

159

<p>Returns a pointer to the current item.</p>

148

160

<p>See also <a href="qlinkedlist-iterator.html#operator-2a">operator*</a>().</p>

161

149

162

<h3 class="fn"><a name="operator-eq"></a>iterator & iterator::operator= ( const iterator & <i>other</i> )</h3>

150

163

<p>Assigns <i>other</i> to this iterator.</p>

164

151

165

<h3 class="fn"><a name="operator-eq-eq"></a>bool iterator::operator== ( const iterator & <i>other</i> ) const</h3>

152

166

<p>Returns true if <i>other</i> points to the same item as this iterator; otherwise returns false.</p>

153

167

<p>See also <a href="qlinkedlist-iterator.html#operator-not-eq">operator!=</a>().</p>

156

170

<p>See also <a href="qlinkedlist-iterator.html#operator-not-eq">operator!=</a>().</p>

157

171

158

172

159

160

<td width="40%" align="center"><a href="trademarks.html">Trademarks</a></td>

161

162

</tr></table></div></address></body>

173

174

<td width="20%" align="center"><a href="trademarks.html">Trademarks</a></td>

175

176

163

177

</html>

Older »