CList

template < class TYPE, class ARG_TYPE > class CList : public CObject

參數：TYPE存儲在列表中的對象類型。ARG_TYPE用於參考存儲在列表中的對象的類型。可以是一個參考。

説明：

類型POSITION的變量是列表的關鍵字。可使用POSITION變量作為循環因子來順序遍歷列表，作為書籤來保存位置。然而，位置不同於索引。

元素插入在列表的標題、在末尾和已知的POSITION時非常快。按值或索引來查找一個元素，需要順序查找。如果列表太長，此查找可能較慢。如果需要轉儲列表中的個別元素，必須設置轉儲上下文的深度為1或更大。

#include <afxtempl.h>

請參閲：CMap, CArray

CList 構造一個空的有序列表。

標題/末尾訪問

GetHead() 返回列表的標題元素（不能為空）。

GetTail() 返回列表的末尾元素（不能為空）。

RemoveHead()從列表標題中移走元素。

RemoveTail() 從列表末尾移走元素。

AddHead() 添加一個元素或另一個列表的所有元素到列表標題（生成新的標題）。

AddTail() 添加一個元素或另一個列表的所有元素到列表尾部（生成新的尾部）。

RemoveAll() 從列表中移走所有元素。

GetHeadPosition() 返回列表標題元素的位置。

GetTailPosition() 返回列表尾部元素的位置。

GetNext() 獲取用於遍歷下一個元素。

GetPrev() 獲取用於遍歷的前一個元素。

GetAt() 在指定的位置上獲得元素。

SetAt() 在指定的位置上設置元素。

RemoveAt() 從列表中刪除一個由位置確定的元素。

InsertBefore() 在指定的位置前插入一個新的元素。

InsertAfter() 在指定的位置後插入一個新的元素。

Find() 獲得由指針值確定的元素位置。

FindIndex() 獲得由基於零的索引指定的元素位置。

GetCount() 返回此列表中的元素數。

IsEmpty() 檢測列表是否為空。