CPtrArray 类

支持 void 指针数组。

语法

class CPtrArray : public CObject

成员

CPtrArray 的成员函数与 CObArray 类的成员函数类似。 由于此相似性,因此你可以使用 CObArray 参考文档获取成员函数细节。 无论你在何处看到作为函数参数的 CObject 指针或返回值,都将替换指向 void 的指针。

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

例如,转换为

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

公共构造函数

名称 描述
CPtrArray::CPtrArray 构造一个空数组。

公共方法

名称 描述
CPtrArray::Add 向数组的末尾添加一个元素;根据需要扩展该数组。
CPtrArray::Append 将另一个数组追加到该数组中;根据需要扩展该数组。
CPtrArray::Copy 将另一个数组复制到该数组;根据需要扩展该数组。
CPtrArray::ElementAt 在该数组中返回对元素指针的临时引用。
CPtrArray::FreeExtra 若高于当前的上限,则将释放所有未使用的内存。
CPtrArray::GetAt 返回给定索引位置处的值。
CPtrArray::GetCount 获取此数组中的元素数。
CPtrArray::GetData 允许访问该数组中的元素。 可以为 NULL
CPtrArray::GetSize 获取此数组中的元素数。
CPtrArray::GetUpperBound 返回最大的有效索引。
CPtrArray::InsertAt 在指定索引处插入一个元素(或另一个数组中的所有元素)。
CPtrArray::IsEmpty 确定数组是否为空。
CPtrArray::RemoveAll 从此数组中移除所有元素。
CPtrArray::RemoveAt 移除特定索引处的元素。
CPtrArray::SetAt 设置给定索引的值;不允许对该数组进行扩展。
CPtrArray::SetAtGrow 设置给定索引的值;根据需要扩展该数组。
CPtrArray::SetSize 设置要在该数组中包含的元素数。

公共运算符

“属性” 描述
CPtrArray::operator [ ] 设置或获取位于指定索引处的元素。

备注

CPtrArray 合并 IMPLEMENT_DYNAMIC 宏以支持运行时类型访问并转储到 CDumpContext 对象。 如果需要单个指针数组元素的转储,就必须将转储上下文的深度设为 1 或更大的值。

注意

在使用数组之前,先使用 SetSize 建立其大小并为其分配内存。 如果不使用 SetSize,则向数组添加元素会导致它经常重新分配和复制。 经常重新分配和复制会降低效率而且会产生内存碎片。

无法序列化指针数组。

删除指针数组或移除其元素时,仅删除指针而不是指针引用的实体。

若要详细了解如何使用 CPtrArray,请参阅集合一文。

继承层次结构

CObject

CPtrArray

要求

标头:afxcoll.h

另请参阅

CObject 类
层次结构图
CObArray 类