CArray

CObject
 └CArray

template <class TYPE, class ARG_TYPE> class CArray : public CObject

参数:
TYPE模板参数指定存储在数组中的对象的类型。TYPE是一个由CArray返回的参数。
ARG_TYPE模板参数指定用于访问存储在数组中对象的参数类型。通常是一个对TYPE的参考。ARG_TYPE是一个传递给CArray的参数。

说明:
CArray类支持与CArray相似的数组,但是必要时可以动态压缩并扩展。数组索引从0开始。可以决定是固定数组上界还是允许当添加元素时扩展当前的边界。内存对上界是连续地分配空间,甚至一些元素可为空。
和CArray一样,CArray索引元素的访问时间是不变的,与数组大小无关。

提示:
在使用一个数组之前,使用SetSize建立它的大小和为它分配内存。如果不使用SetSize,则为数组添加元素就会引起频繁地重新分配和拷贝。频繁地重新分配和拷贝不但没有效率,而且导致内存碎片。

如果需要一堆数组中的个别数据,必须设置CDumpContext对象的深度为1或更大。
此类的某成员函数调用全局帮助函数,它必须为CArray的大多数使用而定制。请参阅宏和全局量部分中的“类收集帮助器”。
当从一个CArray对象中移去元素时,帮助函数DestructElements被调用。
当添加元素时,帮助函数ConstructElements被调用。
数组类的派生与列表的派生相似。
如果要了解关于使用CArray的更多信息,请参阅联机文档“Visual C++程序员指南”中的“收集”。
#include <afxtempl.h>

请参阅:
CObArray, DestructElements, ConstructElements, Collection ClassHelpers


CArray类的成员

构造函数
CArray构造一个空数组属性
GetSize获得此数组中的元素数
GetUpperBound返回最大的有效索引值
SetSize设置包含在此数组中的元素数

操作
FreeExtra释放大于当前上界的未使用的内存
RemoveAll从此数组移去所有元素元素访问
GetAt返回在给定索引上的值
SetAt设定一个给定索引的值;数组不允许扩展
ElementAt返回一个对数组中元素指针的临时参考
GetData允许对数组中的元素访问。可以为NULL扩展数组
SetAtGrow为一个给定索引设置值;如果必要,扩展数组
Add在数组的末尾添加元素;如果必要,扩展数组
Append在数组上附加另一个数组;如果必要,扩展数组
Copy把另一个数组拷贝到数组上;如果必要,扩展数组

插入/移去
InsertAt在指定的索引上插入一个元素(或另一个数组中的所有元素)
RemoveAt在指定的索引上移去一个元素

运算符
operator []在特定索引上设置或获取元素