<h3 class=fn><a name="QPtrList-2"></a>QPtrList::QPtrList ( const&nbsp;<a href="qptrlist.html">QPtrList</a>&lt;type&gt;&nbsp;&amp;&nbsp;list )
</h3>
構(gòu)造一個(gè)<em>list</em>的復(fù)制。
<p> <em>list</em>的每一個(gè)項(xiàng)都<a href="#append">被添加</a>到這個(gè)列表中。只有指針被復(fù)制（淺復(fù)制）。

<h3 class=fn><a name="~QPtrList"></a>QPtrList::~QPtrList ()
</h3>
移除列表中的所有項(xiàng)并且銷毀這個(gè)列表。
<p> 訪問這個(gè)列表的所有列表迭代器都會(huì)被重置。
<p> <p>也可以參考<a href="qptrcollection.html#setAutoDelete">setAutoDelete</a>()。

<h3 class=fn>void <a name="append"></a>QPtrList::append ( const&nbsp;type&nbsp;*&nbsp;item )
</h3>
在列表的最后插入<em>item</em>。
<p> 被插入的項(xiàng)變?yōu)楫?dāng)前列表項(xiàng)。這和<tt>insert( count(), item )</tt>是相同的。
<p> <em>item</em>必須不是一個(gè)空指針。
<p> <p>也可以參考<a href="#insert">insert</a>()、<a href="#current">current</a>()和<a href="#prepend">prepend</a>()。
<p>實(shí)例：<a href="customlayout-example.html#x1371">customlayout/border.cpp</a>、<a href="customlayout-example.html#x1389">customlayout/card.cpp</a>、<a href="customlayout-example.html#x1348">customlayout/flow.cpp</a>、<a href="grapher-nsplugin-example.html#x2778">grapher/grapher.cpp</a>、<a href="listviews-example.html#x347">listviews/listviews.cpp</a>、<a href="listviews-example.html#x318">listviews/listviews.h</a>和<a href="qwerty-example.html#x385">qwerty/qwerty.cpp</a>。

<h3 class=fn>type * <a name="at"></a>QPtrList::at ( uint&nbsp;index )
</h3>
返回一個(gè)在列表<em>index</em>位置的項(xiàng)的指針，如果索引超出范圍，返回空。
<p> 如果<em>index</em>有效，設(shè)置這個(gè)項(xiàng)為當(dāng)前列表項(xiàng)。有效范圍是<tt>0……(count() - 1)</tt>。
<p> 這個(gè)函數(shù)是非常有效的。它從第一項(xiàng)、最后一項(xiàng)或當(dāng)前項(xiàng)中最接近<em>index</em>的開始掃描。
<p> <p>也可以參考<a href="#current">current</a>()。
<p>實(shí)例：<a href="customlayout-example.html#x1372">customlayout/border.cpp</a>、<a href="customlayout-example.html#x1390">customlayout/card.cpp</a>、<a href="customlayout-example.html#x1349">customlayout/flow.cpp</a>、<a href="dirview-example.html#x1737">dirview/dirview.cpp</a>、<a href="fileiconview-example.html#x863">fileiconview/qfileiconview.cpp</a>、<a href="mdi-example.html#x2035">mdi/application.cpp</a>和<a href="qwerty-example.html#x386">qwerty/qwerty.cpp</a>。

<h3 class=fn>int <a name="at-2"></a>QPtrList::at () const
</h3>
這是一個(gè)重載成員函數(shù)，提供了方便。它的行為基本上和上面的函數(shù)相同。
<p> 返回當(dāng)前列表項(xiàng)的索引。如果當(dāng)前項(xiàng)為空，返回值為-1。
<p>也可以參考<a href="#current">current</a>()。

<h3 class=fn>bool <a name="autoDelete"></a>QPtrCollection::autoDelete () const
</h3>
<p> 返回自動(dòng)刪除選項(xiàng)的設(shè)置。默認(rèn)為假。
<p> <p>也可以參考<a href="qptrcollection.html#setAutoDelete">setAutoDelete</a>()。

<h3 class=fn>void <a name="clear"></a>QPtrList::clear ()<tt> [虛]</tt>
</h3>
移除列表中所有項(xiàng)。
<p> 如果<a href="qptrcollection.html#setAutoDelete">自動(dòng)刪除</a>生效，被移除的項(xiàng)目將被刪除。
<p> 所有訪問這個(gè)列表的列表迭代器都將被重置。
<p> <p>也可以參考<a href="#remove">remove</a>()、<a href="#take">take</a>()和<a href="qptrcollection.html#setAutoDelete">setAutoDelete</a>()。
<p>從<a href="qptrcollection.html#clear">QPtrCollection</a>中重新實(shí)現(xiàn)。

<h3 class=fn>int <a name="compareItems"></a>QPtrList::compareItems ( <a href="qptrcollection.html#Item">QPtrCollection::Item</a>&nbsp;item1, <a href="qptrcollection.html#Item">QPtrCollection::Item</a>&nbsp;item2 )<tt> [虛 保護(hù)]</tt>
</h3>
<p> 這個(gè)虛函數(shù)比較兩個(gè)列表項(xiàng)。
<p> 返回：
<ul>
<li> 如果<em>item1</em>==<em>item2</em>，返回0
<li> 如果<em>item1</em>!=<em>item2</em>，返回非0
</ul>
<p> 這個(gè)函數(shù)返回<em>int</em>而不是<em>bool</em>，這樣可以重新實(shí)現(xiàn)返回三個(gè)值并且使用它來排序：
<p> <ul>
<li> 如果<em>item1</em> == <em>item2</em>，返回0
<li> 如果<em>item1</em>&gt;<em>item2</em>，返回&gt;0（正整數(shù)）
<li> 如果<em>item1</em>&lt;<em>item2</em>，返回&lt;0（負(fù)整數(shù)）
</ul>
<p> <a href="#inSort">inSort</a>()需要<a href="#compareItems">compareItems</a>()像這里所描述的這樣來被實(shí)現(xiàn)。
<p> 這個(gè)函數(shù)不應(yīng)該修改列表，因?yàn)橐恍┏Ａ亢瘮?shù)調(diào)用compareItems()。
<p> 默認(rèn)實(shí)現(xiàn)是比較指針。

<h3 class=fn>uint <a name="contains"></a>QPtrList::contains ( const&nbsp;type&nbsp;*&nbsp;item ) const
</h3>
計(jì)算并且返回<em>item</em>在列表中出現(xiàn)的次數(shù)。
<p> 當(dāng)在列表中搜索<em>item</em>時(shí)，<a href="#compareItems">compareItems</a>()函數(shù)被調(diào)用。如果compareItems()沒有被重新實(shí)現(xiàn)，調(diào)用<a href="#containsRef">containsRef</a>()是更有效率的。
<p> 這個(gè)函數(shù)不影響當(dāng)前列表項(xiàng)。
<p> <p>也可以參考<a href="#containsRef">containsRef</a>()和<a href="#compareItems">compareItems</a>()。

<h3 class=fn>uint <a name="containsRef"></a>QPtrList::containsRef ( const&nbsp;type&nbsp;*&nbsp;item ) const
</h3>
計(jì)算并且返回<em>item</em>在列表中出現(xiàn)的次數(shù)。
<p> 調(diào)用這個(gè)函數(shù)比<a href="#contains">contains</a>()快多了，因?yàn)閏ontains()使用<a href="#compareItems">compareItems</a>()來用<em>item</em>與列表中的每一個(gè)項(xiàng)進(jìn)行比較。這個(gè)函數(shù)只比較指針。
<p> 這個(gè)函數(shù)不影響當(dāng)前列表項(xiàng)。
<p> <p>也可以參考<a href="#contains">contains</a>()。

<h3 class=fn>uint <a name="count"></a>QPtrList::count () const<tt> [虛]</tt>
</h3>
返回列表中項(xiàng)的數(shù)量。
<p>也可以參考<a href="#isEmpty">isEmpty</a>()。
<p>實(shí)例：<a href="customlayout-example.html#x1373">customlayout/border.cpp</a>、<a href="customlayout-example.html#x1391">customlayout/card.cpp</a>、<a href="customlayout-example.html#x1350">customlayout/flow.cpp</a>、<a href="fileiconview-example.html#x864">fileiconview/qfileiconview.cpp</a>、<a href="grapher-nsplugin-example.html#x2779">grapher/grapher.cpp</a>、<a href="mdi-example.html#x2036">mdi/application.cpp</a>和<a href="qwerty-example.html#x387">qwerty/qwerty.cpp</a>。
<p>從<a href="qptrcollection.html#count">QPtrCollection</a>中重新實(shí)現(xiàn)的。

<h3 class=fn>type * <a name="current"></a>QPtrList::current () const
</h3>
返回一個(gè)指向當(dāng)前列表項(xiàng)的指針。當(dāng)前列表項(xiàng)可能為空（意味著當(dāng)前索引為-1）。
<p>也可以參考<a href="#at">at</a>()。

<h3 class=fn>QLNode * <a name="currentNode"></a>QPtrList::currentNode () const
</h3>
返回指向當(dāng)前列表節(jié)點(diǎn)的指針。
<p> 節(jié)點(diǎn)可以被保存并且稍后使用<a href="#removeNode">removeNode</a>()移除。這樣做的優(yōu)點(diǎn)是可以直接移除這個(gè)項(xiàng)，而不用搜索列表。
<p> <b>警告：</b>不要調(diào)用這個(gè)函數(shù)，除非你是專家。
<p> <p>也可以參考<a href="#removeNode">removeNode</a>()、<a href="#takeNode">takeNode</a>()和<a href="#current">current</a>()。

<h3 class=fn>int <a name="find"></a>QPtrList::find ( const&nbsp;type&nbsp;*&nbsp;item )
</h3>
找到<em>item</em>在列表中第一次出現(xiàn)的位置。
<p> 如果這個(gè)項(xiàng)被找到，列表會(huì)設(shè)置當(dāng)前項(xiàng)指向找到的項(xiàng)，并且返回這個(gè)項(xiàng)的索引。如果沒有被找到，列表設(shè)置當(dāng)前項(xiàng)為空，當(dāng)前索引為-1，并且返回-1。
<p> 當(dāng)在列表中搜索這個(gè)項(xiàng)時(shí)，<a href="#compareItems">compareItems</a>()函數(shù)被調(diào)用。如果compareItems()沒有被重新實(shí)現(xiàn)，調(diào)用<a href="#findRef">findRef</a>()是更有效率的。
<p> <p>也可以參考<a href="#findNext">findNext</a>()、<a href="#findRef">findRef</a>()、<a href="#compareItems">compareItems</a>()和<a href="#current">current</a>()。

<h3 class=fn>int <a name="findNext"></a>QPtrList::findNext ( const&nbsp;type&nbsp;*&nbsp;item )
</h3>
從當(dāng)前列表項(xiàng)，找到<em>item</em>在列表中下一次出現(xiàn)的位置。
<p> 如果這個(gè)項(xiàng)被找到，列表會(huì)設(shè)置當(dāng)前項(xiàng)指向找到的項(xiàng)，并且返回這個(gè)項(xiàng)的索引。如果沒有被找到，列表設(shè)置當(dāng)前項(xiàng)為空，當(dāng)前索引為-1，并且返回-1。
<p> 當(dāng)在列表中搜索這個(gè)項(xiàng)時(shí)，<a href="#compareItems">compareItems</a>()函數(shù)被調(diào)用。如果compareItems()沒有被重新實(shí)現(xiàn)，調(diào)用<a href="#findNextRef">findNextRef</a>()是更有效率的。
<p> <p>也可以參考<a href="#find">find</a>()、<a href="#findNextRef">findNextRef</a>()、<a href="#compareItems">compareItems</a>()和<a href="#current">current</a>()。

<h3 class=fn>int <a name="findNextRef"></a>QPtrList::findNextRef ( const&nbsp;type&nbsp;*&nbsp;item )
</h3>
從當(dāng)前列表項(xiàng)，找到<em>item</em>在列表中下一次出現(xiàn)的位置。
<p> 如果這個(gè)項(xiàng)被找到，列表會(huì)設(shè)置當(dāng)前項(xiàng)指向找到的項(xiàng)，并且返回這個(gè)項(xiàng)的索引。如果沒有被找到，列表設(shè)置當(dāng)前項(xiàng)為空，當(dāng)前索引為-1，并且返回-1。
<p> 調(diào)用這個(gè)函數(shù)比<a href="#findNext">findNext</a>()快得多，因?yàn)閒indNext()是使用<a href="#compareItems">compareItems</a>()來用<em>item</em>與列表中的每一個(gè)項(xiàng)進(jìn)行比較。這個(gè)函數(shù)只比較指針。
<p> <p>也可以參考<a href="#findRef">findRef</a>()、<a href="#findNext">findNext</a>()和<a href="#current">current</a>()。

<h3 class=fn>int <a name="findRef"></a>QPtrList::findRef ( const&nbsp;type&nbsp;*&nbsp;item )
</h3>
找到<em>item</em>在列表中第一次出現(xiàn)的位置。
<p> 如果這個(gè)項(xiàng)被找到，列表會(huì)設(shè)置當(dāng)前項(xiàng)指向找到的項(xiàng)，并且返回這個(gè)項(xiàng)的索引。如果沒有被找到，列表設(shè)置當(dāng)前項(xiàng)為空，當(dāng)前索引為-1，并且返回-1。
<p> 調(diào)用這個(gè)函數(shù)比<a href="#find">find</a>()快得多，因?yàn)閒ind()是使用<a href="#compareItems">compareItems</a>()來用<em>item</em>與列表中的每一個(gè)項(xiàng)進(jìn)行比較。這個(gè)函數(shù)只比較指針。
<p> <p>也可以參考<a href="#findNextRef">findNextRef</a>()、<a href="#find">find</a>()和<a href="#current">current</a>()。

<h3 class=fn>type * <a name="first"></a>QPtrList::first ()
</h3>
返回指向列表中第一個(gè)項(xiàng)的指針并且使它成為當(dāng)前列表項(xiàng)，或者如果列表為空當(dāng)前項(xiàng)就為空。
<p>也可以參考<a href="#getFirst">getFirst</a>()、<a href="#last">last</a>()、<a href="#next">next</a>()、<a href="#prev">prev</a>()和<a href="#current">current</a>()。
<p>實(shí)例：<a href="grapher-nsplugin-example.html#x2780">grapher/grapher.cpp</a>、<a href="listviews-example.html#x319">listviews/listviews.h</a>和<a href="showimg-example.html#x1281">showimg/showimg.cpp</a>。

<h3 class=fn>type * <a name="getFirst"></a>QPtrList::getFirst () const
</h3>
返回指向列表中第一個(gè)項(xiàng)的指針，如果列表為空返回空。
<p> 這個(gè)函數(shù)不影響當(dāng)前列表項(xiàng)。
<p> <p>也可以參考<a href="#first">first</a>()和<a href="#getLast">getLast</a>()。

<h3 class=fn>type * <a name="getLast"></a>QPtrList::getLast () const
</h3>
Returns a pointer to the last item in the list, or null if the
list is empty.
返回指向列表中最后一個(gè)項(xiàng)的指針，如果列表為空返回空。
<p> 這個(gè)函數(shù)不影響當(dāng)前列表項(xiàng)。
<p> <p>也可以參考<a href="#last">last</a>()和<a href="#getFirst">getFirst</a>()。

<h3 class=fn>void <a name="inSort"></a>QPtrList::inSort ( const&nbsp;type&nbsp;*&nbsp;item )
</h3>
把<em>item</em>插入到列表中它被排序的位置。
<p> 排序依靠的是虛函數(shù)<a href="#compareItems">compareItems</a>()。為了維護(hù)這個(gè)派遜，所有的項(xiàng)都必須使用<a href="#inSort">inSort</a>()來插入。
<p> 被插入的項(xiàng)變?yōu)楫?dāng)前項(xiàng)。
<p> <em>item</em>必須不能是一個(gè)空指針。
<p> 請(qǐng)注意inSort()很慢。如果你想先向列表插入很多項(xiàng)，插入完之后再排序，你應(yīng)該使用<a href="#sort">sort</a>()。inSort()進(jìn)行了O(n)次比較。這就意味著插入n個(gè)項(xiàng)到你的列表需要比較O(n^2)次，而sort()做同樣的工作只需要O(n*log n)次。所以只有在你有一個(gè)預(yù)先排好序的列表并且想向其中插入少量的項(xiàng)時(shí)，再使用inSort()。
<p> <p>也可以參考<a href="#insert">insert</a>()、<a href="#compareItems">compareItems</a>()、<a href="#current">current</a>()和<a href="#sort">sort</a>()。

<h3 class=fn>bool <a name="insert"></a>QPtrList::insert ( uint&nbsp;index, const&nbsp;type&nbsp;*&nbsp;item )
</h3>
插入<em>item</em>到列表的<em>index</em>位置。
<p> 如果成功返回真，或者如果<em>index</em>超出范圍返回假。有效的范圍是從0到<a href="#count">count</a>()（包括count()）。如果<em>index</em>==count()，項(xiàng)就被添加。
<p> 被插入的項(xiàng)變?yōu)楫?dāng)前項(xiàng)。
<p> <em>item</em>必須不能是一個(gè)空指針。
<p> <p>也可以參考<a href="#append">append</a>()和<a href="#current">current</a>()。

<h3 class=fn>bool <a name="isEmpty"></a>QPtrList::isEmpty () const
</h3>
如果列表是空的，返回真，否則返回假。
<p> <p>也可以參考<a href="#count">count</a>()。

<h3 class=fn>type * <a name="last"></a>QPtrList::last ()
</h3>
返回指向列表最后一項(xiàng)的指針，并且把這一項(xiàng)變?yōu)楫?dāng)前列表項(xiàng)，如果列表為空，當(dāng)前列表項(xiàng)為空。
<p>也可以參考<a href="#getLast">getLast</a>()、<a href="#first">first</a>()、<a href="#next">next</a>()、<a href="#prev">prev</a>()和<a href="#current">current</a>()。

<h3 class=fn>type * <a name="next"></a>QPtrList::next ()