http://www.baike.com/wiki/CStringArray
CStringArray - CStringArray
CStringArray的 成员函数类似于CObArray类的成员函数。由于具有这些相似性,你可以参考关于CObArray的参考文件来获取CStringArray成员函数的详细说明。如果在说明中看到某一函数的返回值是一个指向CObject对象的 指针,则可以用一个CString(而不是一个CString指针)来代替它。如果看到某一函数的参数是一个指向CObject的指针,则可以用LPCTSTR来代替它。 例如,可以将
CObject* CObArray::GetAt( int ) const;
转换为
CString CStringArray::GetAt( int ) const;
和将
void SetAt( int , CObject* )
转换为
void SetAt( int , LPCTSTR );
CStringArray与IMPLEMENT_SERIAL 宏联合起来支持其元素的连续和转储。如果一个CString 对象数组被用一个 重载的插入操作符或Serialize 成员函数保存到一个存档中,则它的每一个元素都按顺序连续。
注意:
在使用一个 数组之前,使用SetSize来建立它的大小并给它分配内存。如果你不使用SetSize,则向数组中添加元素时将导致数组被频繁地拷贝和分配内存。频繁分配内存和拷贝会导致效率低和内存零碎。
如果你需要数组中个别字符串元素的转储,则应该将转储环境的深度设置为1或更大。当一个CString数组被删除时,或当其中的个别元素被删除时,字符串内存被根据需要释放。
有关使用 CStringArray的更多信息,参见“Visual C++程序员指南”中的文章“ 集合”。
#include
CStringArray类成员
构造
CStringArray构造一个空的CString对象数组 |
GetSize获取这个数组中的元素数目 SetSize设置这个数组中包含的元素数目 GetUpperBound返回最大的有效索引 |
FreeExtra释放当前数组边界之外的未使用的所有内存 RemoveAll从数组中删除所有元素 |
GetAt返回位于给定索引处的值 SetAt设置给定索引处的元素的值;不得将数组增大 ElementAt返回对数组中的某一元素指针的临时引用 GetData对数组中的元素允许的访问。可以是NULL |
SetAtGrow设置给定索引处的值,如果必要的话可以增长数组 Add在数组的末尾添加一个元素;可根据需要增长数组 Append向数组中添加另一个数组;如果必要的话可增长数组 Copy将另一个数组拷贝到此数组中;如果必要的话可增长数组 |
InsertAt在指定索引处插入一个元素(或者是另一个数组中的所有元素) RemoveAt删除指定索引处的一个元素 |
operator []设置或获取在指定索引处的元素 |