CStringList 类
支持 CString 对象列表。
语法
class CStringList : public CObject
成员
CStringList 的成员函数类似于类 CObList 的成员函数。 由于此相似性，因此你可以使用 CObList 参考文档获取成员函数细节。 无论你在何处看到作为返回值的 CObject 指针，都请替换为 CString（而非 CString 指针）。 无论你在何处看到作为函数参数的 CObject 指针，都请替换为 LPCTSTR。
CObject*& CObList::GetHead() const;
例如，转换为
CString& CStringList::GetHead() const;
和
POSITION AddHead( CObject* <newElement> );
转换为
POSITION AddHead( LPCTSTR <newElement> );
公共构造函数
| 名称 | 描述 |
|---|---|
CStringList::CStringList |
构造一个空列表。 |
公共方法
| 名称 | 描述 |
|---|---|
CStringList::AddHead |
将一个元素（或另一个列表中的所有元素）添加到列表的头部（创建新的头部）。 |
CStringList::AddTail |
将一个元素（或另一个列表中的所有元素）添加到列表的末尾（创建新的尾部）。 |
CStringList::Find |
获取指针值指定的元素的位置。 |
CStringList::FindIndex |
获取从零开始的索引指定的元素的位置。 |
CStringList::GetAt |
获取位于给定位置的元素。 |
CStringList::GetCount |
返回此列表中的元素数目。 |
CStringList::GetHead |
返回列表的头部元素（不能为空）。 |
CStringList::GetHeadPosition |
返回列表的 head 元素的位置。 |
CStringList::GetNext |
获取要迭代的下一个元素。 |
CStringList::GetPrev |
获取要进行迭代的上一个元素。 |
CStringList::GetSize |
返回此列表中的元素数目。 |
CStringList::GetTail |
返回列表的尾部元素（不能为空）。 |
CStringList::GetTailPosition |
返回列表的尾部元素的位置。 |
CStringList::InsertAfter |
在给定位置后插入新元素。 |
CStringList::InsertBefore |
在给定位置前插入新元素。 |
CStringList::IsEmpty |
测试空列表条件（无元素）。 |
CStringList::RemoveAll |
从此列表中移除所有元素。 |
CStringList::RemoveAt |
从此列表中移除按位置指定的元素。 |
CStringList::RemoveHead |
从列表的头部移除元素。 |
CStringList::RemoveTail |
从列表的尾部移除元素。 |
CStringList::SetAt |
设置位于给定位置的元素。 |
注解
所有比较均按值进行，这意味着将比较字符串中的字符而不是字符串的地址。
CStringList 包括用于支持其元素序列化和转储的 IMPLEMENT_SERIAL 宏。 如果使用重载插入运算符或 Serialize 成员函数将 CString 对象的列表存储到存档中，则将依次序列化每个 CString 元素。
如果需要转储单个 CString 元素，必须将转储上下文的深度设置为 1 或更大的值。
若要详细了解如何使用 CStringList，请参阅集合一文。
继承层次结构
CStringList
要求
标头：afxcoll.h