qvaluelist.html

这是qt3的帮助文档的中文版

<p> <p>也可以参考<a href="#last">last</a>()。
<p>实例：<a href="mail-example.html#x765">network/mail/smtp.cpp</a>。

<h3 class=fn>const T &amp; <a name="first-2"></a>QValueList::first () const
</h3> 
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。

<h3 class=fn><a href="qvaluelist.html#const_iterator">const_iterator</a> <a name="fromLast"></a>QValueList::fromLast () const
</h3>
<p> 返回指向列表中最后一项的迭代器，或者如果列表中没有最后一项，返回<a href="#end">end</a>()。
<p> 可以使用end()函数替换。例如：
<p> <pre>
    QValueList&lt;int&gt; l;
    ……
    QValueList&lt;int&gt;::<a href="#iterator">iterator</a> it = l.<a href="#end">end</a>();
    --it;
    if ( it != <a href="#end">end</a>() )
        // ……
</pre>
 
<p> 
<h3 class=fn><a href="qvaluelist.html#iterator">iterator</a> <a name="fromLast-2"></a>QValueList::fromLast ()
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 返回指向列表中最后一项的迭代器，或者如果列表中没有最后一项，返回<a href="#end">end</a>()。
<p> 可以使用end()函数替换。例如：
<p> <pre>
    QValueList&lt;int&gt; l;
    ……
    QValueList&lt;int&gt;::<a href="#iterator">iterator</a> it = l.<a href="#end">end</a>();
    --it;
    if ( it != <a href="#end">end</a>() )
        // ……
</pre>
 
<p> 
<h3 class=fn><a href="qvaluelist.html#reference">reference</a> <a name="front"></a>QValueList::front ()
</h3> 
<p> 返回列表中第一个项的引用。如果列表中没有第一个项（比如，<a href="#empty">empty</a>()返回真），返回值是为定义的。
<p> 这个函数的提供是为了兼容STL。它等于<a href="#first">first</a>()。
<p> <p>也可以参考<a href="#back">back</a>()。

<h3 class=fn><a href="qvaluelist.html#const_reference">const_reference</a> <a name="front-2"></a>QValueList::front () const
</h3> 
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。

<h3 class=fn><a href="qvaluelist.html#iterator">iterator</a> <a name="insert"></a>QValueList::insert ( <a href="qvaluelist.html#iterator">iterator</a>&nbsp;it, const&nbsp;T&nbsp;&amp;&nbsp;x )
</h3>
<p> 在迭代器<em>it</em>之前插入值<em>x</em>。
<p> 返回指向被插入项的迭代器。
<p> <p>也可以参考<a href="#append">append</a>()和<a href="#prepend">prepend</a>()。
<p>实例：<a href="themes-example.html#x306">themes/themes.cpp</a>。

<h3 class=fn>void <a name="insert-2"></a>QValueList::insert ( <a href="qvaluelist.html#iterator">iterator</a>&nbsp;pos, <a href="qvaluelist.html#size_type">size_type</a>&nbsp;n, const&nbsp;T&nbsp;&amp;&nbsp;x )
</h3> 
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 在位置<em>pos</em>之前，插入<em>x</em>的<em>n</em>个复制。

<h3 class=fn>bool <a name="isEmpty"></a>QValueList::isEmpty () const
</h3>
<p> 如果列表没有包含任何项，返回真，否则返回假。
<p> <p>也可以参考<a href="#count">count</a>()。
<p>实例：<a href="simple-qfont-demo-walkthrough.html#x2128">fonts/simple-qfont-demo/viewer.cpp</a>、<a href="ftpclient-example.html#x683">network/ftpclient/ftpmainwindow.cpp</a>和<a href="mail-example.html#x766">network/mail/smtp.cpp</a>。

<h3 class=fn>T &amp; <a name="last"></a>QValueList::last ()
</h3>
<p> 返回列表中最后一项的引用。如果列表中没有最后一项（比如，<a href="#empty">empty</a>()返回真），返回值是为定义的。

<h3 class=fn>const T &amp; <a name="last-2"></a>QValueList::last () const
</h3> 
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。

<h3 class=fn>bool <a name="operator!-eq"></a>QValueList::operator!= ( const&nbsp;<a href="qvaluelist.html">QValueList</a>&lt;T&gt;&nbsp;&amp;&nbsp;l ) const
</h3>
<p> 比较两个列表。
<p> 如果这个列表和<em>l</em>不等，返回真，否则返回假。

<h3 class=fn><a href="qvaluelist.html">QValueList</a>&lt;T&gt; <a name="operator+"></a>QValueList::operator+ ( const&nbsp;<a href="qvaluelist.html">QValueList</a>&lt;T&gt;&nbsp;&amp;&nbsp;l ) const
</h3>
<p> 创建一个新的列表并且用这个列表的项来填充它。然后<em>l</em>项被添加。返回新的列表。

<h3 class=fn><a href="qvaluelist.html">QValueList</a>&lt;T&gt;&nbsp;&amp; <a name="operator+-eq"></a>QValueList::operator+= ( const&nbsp;<a href="qvaluelist.html">QValueList</a>&lt;T&gt;&nbsp;&amp;&nbsp;l )
</h3>
<p> 向这个列表添加<em>l</em>项。返回这个列表的引用。

<h3 class=fn><a href="qvaluelist.html">QValueList</a>&lt;T&gt;&nbsp;&amp; <a name="operator+-eq-2"></a>QValueList::operator+= ( const&nbsp;T&nbsp;&amp;&nbsp;x )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 向这个列表添加值<em>x</em>。返回这个列表的引用。

<h3 class=fn><a href="qvaluelist.html">QValueList</a>&lt;T&gt;&nbsp;&amp; <a name="operator-lt-lt"></a>QValueList::operator&lt;&lt; ( const&nbsp;T&nbsp;&amp;&nbsp;x )
</h3>
<p> 在列表末尾添加值<em>x</em>。返回这个列表的引用。

<h3 class=fn><a href="qvaluelist.html">QValueList</a>&lt;T&gt;&nbsp;&amp; <a name="operator-eq"></a>QValueList::operator= ( const&nbsp;<a href="qvaluelist.html">QValueList</a>&lt;T&gt;&nbsp;&amp;&nbsp;l )
</h3>
<p> 把<em>l</em>赋值给这个列表并且返回这个列表的引用。
<p> 当前列表的所有迭代器都因为这个操作而变为无效。这个赋值操作消耗O(1)时间，因为QValueList是<a href="shclass.html#implicitly-shared">隐含地共享</a>

<h3 class=fn><a href="qvaluelist.html">QValueList</a>&lt;T&gt;&nbsp;&amp; <a name="operator-eq-2"></a>QValueList::operator= ( const&nbsp;std::list&lt;T&gt;&nbsp;&amp;&nbsp;l )
</h3> 
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 把<em>l</em>的内容赋值给这个列表。
<p> 当前列表的所有迭代器都因为这个操作而变为无效。

<h3 class=fn>bool <a name="operator-eq-eq"></a>QValueList::operator== ( const&nbsp;<a href="qvaluelist.html">QValueList</a>&lt;T&gt;&nbsp;&amp;&nbsp;l ) const
</h3>
<p> 比较两个列表。
<p> 如果这个列表和<em>l</em>相等，返回真，否则返回假。

<h3 class=fn>bool <a name="operator-eq-eq-2"></a>QValueList::operator== ( const&nbsp;std::list&lt;T&gt;&nbsp;&amp;&nbsp;l ) const
</h3> 
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 如果这个列表和<em>l</em>相等，返回真，否则返回假。
<p> 这个操作符的提供是为了和STL容器兼容。

<h3 class=fn>const T &amp; <a name="operator[]"></a>QValueList::operator[] ( <a href="qvaluelist.html#size_type">size_type</a>&nbsp;i ) const
</h3>
<p> 返回列表中索引为<em>i</em>的项的常量引用。由你来决定检查它是否真的存在。你可以很容易地使用<a href="#count">count</a>()函数做到这一点。无论如何，这个操作符没有检查<em>i</em>是否在范围之内并且如果它不存在，将会递送未定义的结果。
<p> <b>警告：</b>这个函数使用的是线性搜索并且对于大的列表这将会非常慢。QValueList没有对随机项访问进行优化。如果你需要随机访问，请使用一个不同的容易，比如<a href="qvaluevector.html">QValueVector</a>。

<h3 class=fn>T &amp; <a name="operator[]-2"></a>QValueList::operator[] ( <a href="qvaluelist.html#size_type">size_type</a>&nbsp;i )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> Returns a non-const reference to the item with index <em>i</em>.

<h3 class=fn>void <a name="pop_back"></a>QValueList::pop_back ()
</h3> 
<p> 移除列表中的最后一项。如果没有最后一项，这个操作是未定义的。
<p> 这个函数的提供是为了兼容STL。

<h3 class=fn>void <a name="pop_front"></a>QValueList::pop_front ()
</h3> 
<p> 移除列表中的第一个项。如果没有第一个项，这个操作是未定义的。
<p> 这个函数的提供是为了兼容STL。

<h3 class=fn><a href="qvaluelist.html#iterator">iterator</a> <a name="prepend"></a>QValueList::prepend ( const&nbsp;T&nbsp;&amp;&nbsp;x )
</h3>
<p> 在列表的开始插入<em>x</em>。
<p> <p>也可以参考<a href="#insert">insert</a>()和<a href="#append">append</a>()。

<h3 class=fn>void <a name="push_back"></a>QValueList::push_back ( const&nbsp;T&nbsp;&amp;&nbsp;x )
</h3> 
<p> 在列表的末尾插入<em>x</em>。
<p> 这个函数的提供是为了兼容STL。它等于<a href="#append">append</a>()。

<h3 class=fn>void <a name="push_front"></a>QValueList::push_front ( const&nbsp;T&nbsp;&amp;&nbsp;x )
</h3> 
<p> 在列表的开始插入<em>x</em>。
<p> 这个函数的提供是为了兼容STL。它等于<a href="#prepend">prepend</a>()。

<h3 class=fn><a href="qvaluelist.html#iterator">iterator</a> <a name="remove"></a>QValueList::remove ( <a href="qvaluelist.html#iterator">iterator</a>&nbsp;it )
</h3>
<p> 移除列表中<em>it</em>所指向的项。除了<em>it</em>之外其它指向相同项的迭代器一样都无效了。返回一个指向<em>it</em>之后的下一个项的迭代器，或者如果没有这样的项，返回<a href="#end">end</a>()。
<p> <p>也可以参考<a href="#clear">clear</a>()。

<h3 class=fn>uint <a name="remove-2"></a>QValueList::remove ( const&nbsp;T&nbsp;&amp;&nbsp;x )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 移除所有值为<em>x</em>的项并且返回被移除项的数量。

<h3 class=fn><a href="qvaluelist.html#size_type">size_type</a> <a name="size"></a>QValueList::size () const
</h3> 
<p> Returns the number of items in the list.
<p> 这个函数的提供是为了兼容STL。它等于<a href="#count">count</a>()。
<p> <p>也可以参考<a href="#empty">empty</a>()。
<p>实例：<a href="ftpclient-example.html#x696">network/ftpclient/ftpview.cpp</a>。

<hr><h2>相关函数</h2>
<h3 class=fn><a href="qdatastream.html">QDataStream</a>&nbsp;&amp; <a name="operator-lt-lt-2"></a>operator&lt;&lt; ( <a href="qdatastream.html">QDataStream</a>&nbsp;&amp;&nbsp;s, const&nbsp;<a href="qvaluelist.html">QValueList</a>&lt;T&gt;&nbsp;&amp;&nbsp;l )
</h3>
<p> 写一个列表<em>l</em>到流<em>s</em>中。存储在列表中的类型T也必须实现了这个操作符。

<h3 class=fn><a href="qdatastream.html">QDataStream</a>&nbsp;&amp; <a name="operator-gt-gt"></a>operator&gt;&gt; ( <a href="qdatastream.html">QDataStream</a>&nbsp;&amp;&nbsp;s, <a href="qvaluelist.html">QValueList</a>&lt;T&gt;&nbsp;&amp;&nbsp;l )
</h3>
<p> 从流<em>s</em>中读取一个列表<em>l</em>。存储在列表中的类型T也必须实现了这个操作符。

<!-- eof -->
<hr><p>
这个文件是<a href="index.html">Qt工具包</a>一部分。
版权所有 &copy; 1995-2002
<a href="http://www.trolltech.com/">Trolltech</a>。保留所有权利。
<p><address><hr><div align=center>
<table width=100% cellspacing=0 border=0><tr>
<td>Copyright &copy; 2002 
<a href="http://www.trolltech.com">Trolltech</a>
<td><a href="http://www.trolltech.com/trademarks.html">Trademarks</a>
<td><a href="zh_CN.html">译者:Cavendish</a>
<td align=right><div align=right>Qt 3.0.5版</div>
</table></div></address></body>
</html>