CStringArray Class

2015-06-09

支持 CString 对象数组。

class CStringArray : public CObject

Members

CStringArray 的成员函数类似于类 CObArray 的成员函数。由于此相似性，因此你可以使用 CObArray 参考文档获取成员函数细节。无论你在何处看到作为返回值的 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> )

公共构造函数

名称	描述
CObArray::CObArray	构造一个空数组。

公共方法

名称	描述
CObArray::Add	向数组的末尾添加一个元素；根据需要扩展该数组。
CObArray::Append	将另一个数组追加到该数组中；根据需要扩展该数组。
CObArray::Copy	将另一个数组复制到该数组；根据需要扩展该数组。
CObArray::ElementAt	在该数组中返回对元素指针的临时引用。
CObArray::FreeExtra	若高于当前的上限，则将释放所有未使用的内存。
CObArray::GetAt	返回给定索引位置处的值。
CObArray::GetCount	获取此数组中的元素数。
CObArray::GetData	允许访问该数组中的元素。可以为 NULL。
CObArray::GetSize	获取此数组中的元素数。
CObArray::GetUpperBound	返回最大的有效索引。
CObArray::InsertAt	在指定索引处插入一个元素（或另一个数组中的所有元素）。
CObArray::IsEmpty	确定数组是否为空。
CObArray::RemoveAll	从此数组中移除所有元素。
CObArray::RemoveAt	移除特定索引处的元素。
CObArray::SetAt	设置给定索引的值；不允许对该数组进行扩展。
CObArray::SetAtGrow	设置给定索引的值；根据需要扩展该数组。
CObArray::SetSize	设置要在该数组中包含的元素数。

公共运算符

名称	描述
CObArray::operator [ ]	设置或获取位于指定索引处的元素。

备注

CStringArray 包括用于支持其元素序列化和转储的 IMPLEMENT_SERIAL 宏。如果将 CString 对象的数组存储到存档中（使用重载插入运算符或 Serialize 成员函数），则将依次序列化每个元素。

备注

在使用数组之前，先使用 SetSize 建立其大小并为其分配内存。如果不使用 SetSize，则向数组添加元素会导致它经常重新分配和复制。经常重新分配和复制会降低效率而且会产生内存碎片。

如果你需要对数组中单个字符串元素进行转储，则必须将转储上下文的深度设置为等于或大于 1。

当删除 CString 数组或移除其元素时，将以适当方式释放字符串内存。

有关使用 CStringArray 的详细信息，请参阅文章集合。

继承层次结构

CObject

CStringArray

要求

**标头：**afxcoll.h

请参见

参考

CObject Class

层次结构图

通过