CArry的使用完整版

CArray的用法

templateclass CArray:public CObject

参数

TYPE

模板参数指定存储在数组中的对象的类型。TYPE是一个由CArray返回的参数。ARG_TYPE

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

说明

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

需要包含的头文件

CArray类支持与C arrays相似的数组，但是必要时可以动态压缩并扩展。数组索引从0开始。可以决定是固定数组上界还是允许当添加元素时扩展当前的边界。内存对上界是连续地分配空间，甚至一些元素可为空。

和CArray一样，CArray索引元素的访问时间是不变的，与数组大小无关。

提示：

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

如果需要一堆数组中的个别数据，必须设置CDumpContext对象的深度为1或更大。

此类的某成员函数调用全局帮助函数，它必须为CArray的大多数使用而定制。请参阅宏和全局量部分中的“类收集帮助器”。

当从一个CArray对象中移去元素时，帮助函数DestructElements被调用。

当添加元素时，帮助函数ConstructElements被调用。

数组类的派生与列表的派生相似。

MFC提供了一套模板库，来实现一些比较常见的数据结构如Array,List,Map。CArray即为其中的一个，用来实现动态数组的功能。CArray是从CObject派生,有两个模板参数，第一个参数就是CArray类数组元素的变量类型，后一个是函数调用时的参数类型。有一个类 class Object，要定义一个Object的动态数组，那么可以用以下两种方法：

CArray Var1;

CArray Var2;

Var2的效率要高。

ClassHelpers

CArray类的成员

构造函数

Carray构造一个空数组

属性

GetSize获得此数组中的元素数

GetUpperBound返回最大的有效索引值

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

操作

FreeExtra释放大于当前上界的未使用的内存

RemoveAll从此数组移去所有元素

元素访问

GetAt返回在给定索引上的值

SetAt设定一个给定索引的值；数组不允许扩展

ElementAt返回一个对数组中元素指针的临时参考

GetData允许对数组中的元素访问。可以为NULL

扩展数组

SetAtGrow为一个给定索引设置值；如果必要，扩展数组

Add在数组的末尾添加元素；如果必要，扩展数组

Append在数组上附加另一个数组；如果必要，扩展数组

Copy把另一个数组拷贝到数组上；如果必要，扩展数组

插入/移去

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

RemoveAt在指定的索引上移去一个元素

运算符

[ ]在特定索引上设置或获取元素

成员函数

CArray::Add

int Add(ARG_TYPE newElement);

throw(CmemoryException);

返回值

添加元素的索引。

参数

ARG_TYPE

模板参数指定应用数组中元素的参数的类型。

newElement

被加入此数组的元素。

说明

在数组的末尾加入一个新的元素，数组长度加1。如果SetSize已经使用nGrowBy值比1大，则内存按其分配。无论怎样，上界只增长1。

示例

//example for CArray:Add

CArray ptArray;

Cpoint pt(10.20);

ptArray.Add(pt);

//Element 0

ptArray.Add(Cpoint(30,40));

//Element 1

CArray::