CDWordArray

CObject
 └CDWordArray

CDWordArray类支持32位的双字数组。
CDWordArray的成员函数与CObArray类似。因为这个相似性,可以为指定的成员函数使用CObArray参考。无论在何处见到一个作为函数参数或返回值的CObject指针,可用一个DWORD取代。
CObject* CObArray::GetAt( int <nIndex> ) const;
例如,可转换为:
DWORD CDWordArray::GetAt( int <nIndex> ) const;
CDWordArray与IMPLEMENT_SERIAL宏组合能支持对其元素进行串行化和转储。如果一个双字数组保存在归档文件中,使用装载插入操作符(<<)或Serialize成员函数可依次为每个元素串行化。
注意:
在使用数组前,使用SetSize来规定其大小,并分配存储空间。如果不使用SetSize,往数组中添加元素会导致频繁分配和转储,这会降低效率并出现内存碎片。
如果需要数组中单个元素的调试输出,必须设置CDumpContext的深度值为1或更大。
关于使用CDWordArray的更多信息,请参阅联机文档“Visual C++程序员指南”中的“Collections”。
#include <afxcoll.h>
请参阅:CObArray


CDWordArray类的成员

构造函数
CDWordArray构造一个空的双字数组

范围
GetSize获得数组中的元素数目
GetUpperBound返回最大的有效索引
SetSize规定数组中包含的元素数目

操作
FreeExtra释放所有在当前上限之上的内存
RemoveAll清除数组中的所有元素

元素访问
GetAt返回给定索引的值
SetAt在给定索引处设置值,数组不允许扩充
ElementAt返回数组中双字的一个临时参考
GetData允许访问数组中的元素,可以为NULL

扩充数组
SetAtGrow为某值设置给定的索引。如果有必要,数组允许扩充
Add在数组尾部添加元素。如果有必要,数组允许扩充
Append可以向数组后添加新的数组。如果有必要,数组允许扩充
Copy拷贝数组到另一数组中。如果有必要,数组允许扩充

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

操作符
operator []在指定索引处设置或获得元素