CPtrList

CObject

└CPtrList

CPtrList类支持void指针列表。

CPtrList类的成员函数类似于CObList类的成员函数。由于这种类似性，可以使用CObList参考文档作为成员函数的说明。无论在任何时候使用一个CObject指针作为函数参数或返回值，都可以将指针替换为void。例如，

CObject*& CObList::Gethead() const;

可以替换成：

void* CPtrList::Gethead() const;

CPtrList嵌入了IMPLEMENT_DYNAMIC宏来支持运行类型访问和转储到CDumpContext对象。如果应用程序需要转储各个指针列表元素，则必须将转储环境的深度设置为1或大于1。

指针列表不能为NULL。

当一个CPtrList对象被删除时，或当其元素被删除时，只删除指针，而指针所引用的实体并未被删除。

#include <afxcoll.h>

请参阅：CObList

CPtrList类成员

构造

CPtrList 　构造一个空的void指针列表

首/尾访问

GetHead 　返回列表（不能为空）的头元素

GetTail 　返回列表（不能为空）的尾元素

操作

RemoveHead 　移走列表的头元素

RemoveTail 　移走列表的尾元素

AddHead 　将一个元素（或另一列表中的所有元素）增加到列表头（成为新的列表头）

AddTail 　将一个元素（或另一列表中的所有元素）增加到列表尾（成为新的列表尾）

RemoveAll 　从此列表中移走所有元素

重复

GetHeadPosition 　返回列表头元素的位置

GetTailPosition 　返回列表尾元素的位置

GetNext 　获取用于重复的下一个元素

GetPrev 　获取用于重复的上一个元素

获取/修改

GetAt 　获取在给定位置的元素

SetAt 　设置在给定位置的元素

RemoveAt 　从此列表中移走给定位置的元素

插入

InsertBefore 　在一个给定位置之前插入一个新元素

InsertAfter 　在一个给定位置之后插入一个新元素

搜索

Find 　获取一个由指针值指定的元素的位置

FindIndex 　获取由一个索引（从零开始）指定的元素的位置

状态

GetCount 　返回此列表中的元素数目

IsEmpty 　测试列表是否为空（无元素）