CPtrArray

CObject

└CPtrArray

CPtrArray类支持void指针数组。

CPtrArray的成员函数类似于CObArray类的成员函数。由于这种相似，你可以利用CObArray参考文档作为成员函数的说明。无论在何处使用一个CObject指针作为函数参数或返回值，都可以将它替换成void。例如：

CObject* CObArray::GetAt( int <nIndex> ) const;

可以转换成：

void* CPtrArray::GetAt( int <nIndex> ) const;

CPtrArray嵌入IMPLEMENT_DYNAMIC宏来支持运行时类型访问和转储到一个CDumpContext对象。如果你需要转储个别的指针数组元素，你必须将转储环境的深度设置为1或更大。

注意：

在使用一个数组之前，先用SetSize函数建立数组的大小，并为数组分配内存。如果应用程序没有使用SetSize函数，则向数组中增加元素会使它被频繁地再分配和拷贝。频繁再分配和拷贝的效率很低，并且可能使内存变得很零碎。

指针数组不能被串行化。

当一个指针数组被删除时，或当其元素被删掉时，只删掉指针，而这些指针所引用的实体不被删除。

#include <afxcoll.h>

请参阅：CObArray

CPtrArray类成员

构造

CPtrArray 　构造一个空的void指针数组

绑定

GetSize 　获取这个数组中的元素个数

GetUpperBound 　返回最大的有效索引

SetSize 　设置此数组中要包含的元素个数

操作

FreeExtra 　释放超出当前上界的所有未用内存

RemoveAll 　删除此数组中的所有元素

元素访问

GetAt 　返回给定索引处的值

SetAt 　设置给定索引处的值；数组不运行扩展

ElementAt 　返回对数组内的一个元素指针的一个临时引用

GetData 　允许访问数组中的元素。不能是NULL

扩大数组

SetAtGrow 　设置给定索引处的值，如果必要，允许数组扩展

Add 　将一个元素增加到数组尾；在必要时扩展数组

Append 　将另一个数组添加到此数组；如果必要，则扩展此数组

Copy 　将另一个数组拷贝给此数组；如果必要，则扩展此数组

插入/删除

InsertAt 　将一个元素（或另一数组中的所有元素）插入到指定索引处

RemoveAt 　删除指定索引处的元素

操作符

operator [] 　设置或获取给定索引处的元素