Класс 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см. в статье "Коллекции".
Иерархия наследования
CStringList
Требования
Заголовок: afxcoll.h