CList

CObject　└CList

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

参数：

TYPE存储在列表中的对象类型。ARG_TYPE用于参考存储在列表中的对象的类型。可以是一个参考。

说明：

类CList支持可按顺序或按值访问的非唯一对象的有序列表。CList 列表与双链接列表行为相似。

类型POSITION的变量是列表的关键字。可使用POSITION变量作为循环因子来顺序遍历列表，作为书签来保存位置。然而，位置不同于索引。

元素插入在列表的标题、在末尾和已知的POSITION时非常快。按值或索引来查找一个元素，需要顺序查找。如果列表太长，此查找可能较慢。如果需要转储列表中的个别元素，必须设置转储上下文的深度为1或更大。

#include <afxtempl.h>

请参阅：CMap, CArray

CList类的成员

构造函数

CList构造一个空的有序列表

标题/末尾访问

GetHead返回列表的标题元素（不能为空）GetTail返回列表的末尾元素（不能为空）

操作

RemoveHead从列表标题中移走元素RemoveTail从列表末尾移走元素AddHead添加一个元素（或另一个列表的所有元素）到列表标题（生成新的标题）AddTail添加一个元素（或另一个列表的所有元素）到列表尾部（生成新的尾部）RemoveAll从列表中移走所有元素

循环

GetHeadPosition返回列表标题元素的位置GetTailPosition返回列表尾部元素的位置GetNext获取用于遍历下一个元素GetPrev获取用于遍历的前一个元素

获取/修改

GetAt在指定位置上获得元素SetAt在指定位置上设置元素RemoveAt从列表中删除一个由位置确定的元素

插入

InsertBefore在指定位置前插入一个新的元素InsertAfter在指定位置后插入一个新的元素

查找

Find获得由指针值确定的元素位置FindIndex获得由基于零的索引指定的元素位置

状态

GetCount返回此列表中的元素数IsEmpty检测空列表的情况（没有元素）