Класс 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> );
Открытые конструкторы
Имя |
Описание |
---|---|
Создает пустой список. |
Открытые методы
Имя |
Описание |
---|---|
Добавляет элемент (или все элементы в других список) в начало списка (делает новую головку). |
|
Добавляет элемент (или все элементы в других список) в кабелю списка (делает новый хвост). |
|
Получает положение элемента, заданного значением указателя. |
|
Получает положение элемента, указанного на нулевой- индексу. |
|
Возвращает элемент на заданной позиции. |
|
Получает число элементов в данном списке. |
|
Возвращает головной элемент списка (не может быть пустым). |
|
Возвращает позицию головного элемента списка. |
|
Возвращает следующий элемент для итерации. |
|
Возвращает предыдущий элемент для итерации. |
|
Получает число элементов в данном списке. |
|
Возвращает элемент списка с префиксом tail (не может быть пустым). |
|
Возвращает позицию элемента с префиксом tail списка. |
|
Вставляет новый элемент после заданной позиции. |
|
Вставляет новый элемент до заданной позиции. |
|
Тесты для пустого состояния списка (без элементов). |
|
Удаляет все элементы из этого списка. |
|
Удаляет элемент из этого списка, указанного по позиции. |
|
Удаляет элемент из списка head. |
|
Удаляет элемент из списка с префиксом tail. |
|
Задает элемент по заданной позиции. |
Заметки
Все сравнения выполняются значением означать, что символы в строке сравнитьы вместо адресов строк.
CStringList содержит макрос IMPLEMENT_SERIAL для поддержки сериализации и сбрасывать его элементов. Если список объектов CString хранится в архив или с перегруженным оператора insert или функцией-членом Serialize, то каждый элемент CString сериализации в свою очередь.
Если требуется дамп отдельных элементов CString, необходимо установить глубину контекста дампа значение 1 или больше.
Дополнительные сведения об использовании CStringList см. в статье коллекции.
Иерархия наследования
CStringList
Требования
Header: afxcoll.h