CStringList

CObject

└CStringList

CStringList类支持CString对象的列表。所有的比较都是通过值比较来完成的，这意味着不是比较字符串的地址而是比较字符串中的字符。

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

例如，可以将

CObject*& CObList::GetHead() const;

转换为

CString& CStringList::GetHead() const;

和将

POSITION AddHead( CObject* <newElement> );

转换为

POSITION AddHead( LPCTSTR <newElement> );

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

如果你需要数组中个别字符串元素的转储，则应该将转储环境的深度设置为1或更大。

当一个CStringList对象被删除时，或当它的元素被删除时，则相应的CString对象被删除。

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

#include <afxcoll.h>

CStringList类成员

构造

CStringList 　构造一个空的CString对象列表

首/尾访问

GetHead 　返回此列表（不能是空的）中头部的元素

GetTail 　返回此列表（不能是空的）中尾部的元素

操作

RemoveHead 　从列表的头部删除元素

RemoveTail 　从列表的尾部删除元素

AddHead 　在列表的头部添加一个元素（或者是另一个列表中的所有元素），即产生一个新的头部

AddTail 　在列表的尾部添加一个元素（或者是另一个列表中的所有元素），即产生一个新的尾部

RemoveAll 　删除此列表中的所有元素

重复

GetHeadPosition 　返回列表中的头部元素的位置

GetTailPosition 　返回列表中尾部元素的位置

GetNext 　获取用于重复的下一个元素

GetPrev 　获取用于重复的前一个元素

获取/修改

GetAt 　获取给定位置处的元素

SetAt 　设置给定位置处的元素

RemoveAt 　从此列表中删除由位置指定的一个元素

插入

InsertBefore 　在一个给定位置之前插入一个新元素

InsertAfter 　在一个给定位置之后插入一个新元素

搜索

Find 　获取由字符串值指定的元素的位置

FindIndex 　获取由一个从零开始的索引指定的元素的位置

状态

GetCount 　返回此列表中的元素个数

IsEmpty 　测试列表是否为空（没有元素）