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，请参阅集合一文。

继承层次结构

CObject

CStringList

要求

标头afxcoll.h：

另请参阅

MFC 示例 COLLECT
CObject 类
层次结构图