CStringList的成员函式类似于类CObList类的成员函式。由于具有这些相似性，你可以参考关于CObList的参考档案来获取CStringList成员函式的详细说明。如果在说明中看到某一函式的返回值是一个指向CObject对象的指针，则可以用一个CString（而不是一个CString指针）来代替它。如果看到某一函式的参数是一个指向CObject的指针，则可以用LPCTSTR来代替它。
基本介绍
- 外文名：CStringList
- 类似于：类CObList类的成员函式
- RemoveHead：从列表的头部删除元素
- RemoveTail：从列表的尾部删除元素
CStringList
CObject |
└CStringList |
CStringList类支持CString对象的列表。所有的比较都是通过值比较来完成的，这意味着不是比较字元串的地址而是比较字元串中的字元。
例如，可以将
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 | 测试列表是否为空（没有元素） |
