CList选件类

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

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

成员

bxde0zae.collapse_all(zh-cn,VS.110).gif公共构造函数

名称

说明

CList::CList

构造空的有序列表。

bxde0zae.collapse_all(zh-cn,VS.110).gif公共方法

名称

说明

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;

继承层次结构

CObject

CList

要求

Header: afxtempl.h

请参见

参考

CObject选件类

层次结构图

CMap选件类

CArray选件类

概念

MFC示例集合