CWordArray

CObject

└CWordArray

CWordArray类支持16位字的数组。
CWordArray的成员函数与CObArray类的成员函数类似。因为这种相似性，你可以利用CObArray的参考文档找到成员函数的说明。每当你看到CObject指针被用作函数参数或返回值时，就用WORD来替换。

CObject* CObArray::GetAt( int <nIndex> ) const;
例如，被转换为
WORD CWordArray::GetAt( int <nIndex> ) const;
CWordArray合并了IMPLEMENT_SERIAL宏以支持它的元素的串行化和转储。如果字数组被保存到档案中，可以通过重载的插入操作符或使用CObject::Serialize成员函数，则每个元素将依次被串行化。
注意：在使用数组之前，应使用SetSize来设置它的大小并为之分配内存。如果你没有使用SetSize，则在数组中加入元素时会引起频繁的重分配和拷贝。频繁的重分配和拷贝是效率低下的，会引起内存碎片。
如果你需要转储数组中的单个元素，则必须将转储环境的深度设为1或更大。有关使用CWordArray的更多信息参见联机的《Visual C++ 程序员指南》中的文章“集合”。
#include <afxcoll.h>

CWordArray 类成员

构造

CWordArray

构造一个空的字数组

界限

GetSize	获得数组中元素的数目
GetUpperBound	返回最大的有效索引
SetSize	设置数组中将包含的元素的数目

操作

FreeExtra	释放在当前上界之上的没有使用的内存
RemoveAll	从数组中清除所有的元素

访问元素

GetAt	返回给定索引处的值
SetAt	为给定的索引设置值；数组不允许增长
ElementAt	返回对数组中元素指针的临时引用
GetData	允许访问数组中的元素。可以为NULL

增长数组

SetAtGrow	设置给定索引处的值；如果有必要则增长数组
Add	在数组的末尾加入元素；如果有必要则增长数组
Append	将一个数组追加在另一个数组后面；如果有必要则增长数组
Copy	将一个数组拷贝到另一个数组。如果有必要则增长数组

插入/清除

InsertAt	在指定索引处插入一个元素（或其它数组中的全部元素）
RemoveAt	清除指定索引处的元素

操作符

operator []

设置或获得指定索引处的元素