CList 類別

發行項
02/28/2013

存取非唯一的物件支援排序清單循序或傳值。

template< class TYPE, class ARG_TYPE = const TYPE& > 
class CList : public CObject

Members

公用建構函式

名稱	描述
CList::CList	建構空白的排序清單。

公用方法

名稱	描述
CList::AddHead	將項目 (或另一個檔案中的所有項目清單) 加入至清單的開頭 (設定新的開頭)。
CList::AddTail	將項目 (或另一個檔案中的所有項目清單) 加入至清單的尾端 (設定一個新的尾端)。
CList::Find	取得指令指標值所指定之項目的位置。
CList::FindIndex	取得以零起始的索引所指定之項目的位置。
CList::GetAt	取得這個項目在指定的位置。
CList::GetCount	傳回的元素數目。這個清單中的。
CList::GetHead	傳回清單的標頭項目 (不可以是 Null)。
CList::GetHeadPosition	傳回清單的標頭項目的位置。
CList::GetNext	取得可逐一查看的下一個項目。
CList::GetPrev	取得可逐一查看的上一個項目。
CList::GetSize	傳回的元素數目。這個清單中的。
CList::GetTail	傳回清單的尾端項目 (不可以是 Null)。
CList::GetTailPosition	傳回清單的尾端項目的位置。
CList::InsertAfter	在指定的位置後面插入新的項目。
CList::InsertBefore	在指定位置之前插入新的項目。
CList::IsEmpty	空白清單情況的 (沒有項目) 的測試。
CList::RemoveAll	從這份清單中移除所有項目。
CList::RemoveAt	從這份清單中移除項目，由指定位置。
CList::RemoveHead	從清單中移除的項目。
CList::RemoveTail	從清單的尾端移除項目。
CList::SetAt	設定這個項目在指定的位置。

參數

TYPE
在清單中之物件的型別。
ARG*_*TYPE
用於型別參考清單中儲存的物件。可以是參考。

備註

CList 清單的行為就像雙重連結的清單。

型別位置的變數是清單中的索引鍵。您可以使用位置變數做為 Iterator 循序周遊清單和為書籤保留位置。但是位置不同於"的索引。

插入項目非常快速地在清單開頭，在尾部和在已知的位置。循序搜尋需要依值或索引查閱項目。如果串列較長，速度，搜尋可能會很慢。

如果可在清單需要個別項目傾印，您必須將傾印內容的深度為 1 或更大。

這個類別的某些成員函式的呼叫必須自訂為 CList 的大部分類別會使用全域的 Helper 函式。請參閱「巨集和全域變數>一節的集合類別 Helper 。

如需使用 CList的詳細資訊，請參閱本文集合。

範例

// CList is a template class that takes two template arguments.
// The first argument is type stored internally by the list, the
// second argument is the type used in the arguments for the
// CList methods.

// This code defines a list of ints.
CList<int,int> myIntList;

// This code defines a list of CStrings
CList<CString,CString&> myStringList;

// This code defines a list of MYTYPEs,
// NOTE: MYTYPE could be any struct, class or type definition
CList<MYTYPE,MYTYPE&> myTypeList;