CStringArray选件类

支持某些 CString 对象。

class CStringArray : public CObject

成员

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

要求

Header: afxcoll.h

请参见

参考

CObject选件类

层次结构图