CStringArray

举例说明

CStringArray

CStringArray类支持CString对象数组。

CStringArray的成员函数类似于CObArray类的成员函数。由于具有这些相似性，你可以参考关于CObArray的参考文件来获取CStringArray成员函数的详细说明。如果在说明中看到某一函数的返回值是一个指向CObject对象的指针，则可以用一个CString（而不是一个CString指针）来代替它。如果看到某一函数的参数是一个指向CObject的指针，则可以用LPCTSTR来代替它。

举例说明

例如，可以将

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

转换为

CString CStringArray::GetAt( int <nIndex> ) const;

和将

void SetAt( int <nIndex>, CObject* <newElement> )

转换为

void SetAt( int <nIndex>, LPCTSTR <newElement> );

CStringArray与IMPLEMENT_SERIAL宏联合起来支持其元素的连续和转储。如果一个CString对象数组被用一个重载的插入操作符或Serialize成员函数保存到一个存档中，则它的每一个元素都按顺序连续。

注意：

在使用一个数组之前，使用SetSize来建立它的大小并给它分配内存。如果你不使用SetSize，则向数组中添加元素时将导致数组被频繁地拷贝和分配内存。频繁分配内存和拷贝会导致效率低和内存零碎。

如果你需要数组中个别字符串元素的转储，则应该将转储环境的深度设置为1或更大。当一个CString数组被删除时，或当其中的个别元素被删除时，字符串内存被根据需要释放。

有关使用CStringArray的更多信息，参见“Visual C++程序员指南”中的文章“集合”。

#include <afxcoll.h>

CStringArray类成员

构造

CStringArray构造一个空的CString对象数组 绑定

GetSize获取这个数组中的元素数目 SetSize设置这个数组中包含的元素数目 GetUpperBound返回最大的有效索引 操作符

FreeExtra释放当前数组边界之外的未使用的所有内存 RemoveAll从数组中删除所有元素 元素访问

GetAt返回位于给定索引处的值 SetAt设置给定索引处的元素的值；不得将数组增大 ElementAt返回对数组中的某一元素指针的临时引用 GetData对数组中的元素允许的访问。可以是NULL 扩大数组

SetAtGrow设置给定索引处的值，如果必要的话可以增长数组 Add在数组的末尾添加一个元素；可根据需要增长数组 Append向数组中添加另一个数组；如果必要的话可增长数组 Copy将另一个数组拷贝到此数组中；如果必要的话可增长数组 插入/删除

InsertAt在指定索引处插入一个元素（或者是另一个数组中的所有元素） RemoveAt删除指定索引处的一个元素 操作符

operator []设置或获取在指定索引处的元素