Класс 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	Возвращает позицию головного элемента списка.
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 для поддержки сериализации и записи элементов в дамп. Если список CString объектов хранится в архиве либо с перегруженным оператором вставки, либо с Serialize функцией-членом, каждый CString элемент сериализуется в свою очередь.

Если вам нужен дамп отдельных CString элементов, необходимо задать глубину контекста дампа значение 1 или больше.

Дополнительные сведения об использовании CStringListсм. в статье "Коллекции".

Иерархия наследования

CObject

CStringList

Требования

Заголовок: afxcoll.h

См. также

Пример MFC COLLECT
CObject Класс
Диаграмма иерархии