CList选件类

项目
03/01/2013

支持可访问按顺序排序的列表不唯一的对象或通过值传递。

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

成员

公共构造函数

名称	说明
CList::CList	构造空的有序列表。

公共方法

名称	说明
CList::AddHead	添加一个元素(或在其他元素中的所有元素列表)添加到列表的开头(用于新头）。
CList::AddTail	添加一个元素(或在其他元素中的所有元素列表)添加到列表尾(提交新的尾）。
CList::Find	获取指针值指定元素的位置。
CList::FindIndex	获取从零开始的索引指定元素的位置。
CList::GetAt	获取元素在特定位置。
CList::GetCount	中返回元素数列表。
CList::GetHead	返回列表的head元素(不能为空）。
CList::GetHeadPosition	返回列表的head元素的位置。
CList::GetNext	获取重复的下一个元素。
CList::GetPrev	获取重复上一个元素。
CList::GetSize	中返回元素数列表。
CList::GetTail	返回列表尾元素(不能为空）。
CList::GetTailPosition	返回列表尾元素的位置。
CList::InsertAfter	插入到特定位置之后的一个新的元素。
CList::InsertBefore	插入到特定位置之前的一个新的元素。
CList::IsEmpty	测试空列表情况(而不是元素）。
CList::RemoveAll	从此移除所有元素的列表。
CList::RemoveAt	从此移除元素列表，指定的位置。
CList::RemoveHead	从列表的开头移除元素。
CList::RemoveTail	从列表尾移除元素。
CList::SetAt	将该元素在特定位置。

参数

TYPE
在列表中存储的对象的类型。
ARG*_*TYPE
使用的类型引用列表中存储的对象。可以是引用。

备注

CList 列表的行为，如二进制文件链接列表。

类型 POSITION 的变量是列表的密钥。可以使用 POSITION 变量作为迭代器按顺序遍历和作为书签保存位置。但是位置不相同。索引。

插入元素非常快地在列表中前面，在尾和在已知的 POSITION。一个顺序搜索需要按值或索引查找元素。如果列表很长，此搜索可能会很慢。

如果您在列表中需要各个元素转储，必须将转储上下文的深度为1或更大。

此选件类的某些成员函数调用必须自定义为 CList 选件类的大多数使用的全局helper函数。请参见的“宏和Globals”部分中的集合选件帮助器类。

有关使用 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;