CList::GetHead

Статья
02/20/2013

Возвращает головной элемент (или ссылка на головной элемент) этого списка.

const TYPE& GetHead( ) const;
TYPE& GetHead( );

Параметры

ТИП
Параметр шаблона, определяющий тип объекта в списке.

Возвращаемое значение

Если список const, то GetHead возвращает копию элемента в начало списка.Это позволяет функции, которую необходимо использовать только в правой части оператора присваивания и защищает список из изменений.

Если список не является const, то GetHead возвращает ссылку на элемент в начало списка.Это позволяет функции, которую необходимо использовать с обеих сторон оператора назначения и таким образом позволяющее записи списка, который требуется изменить.

Заметки

Следует убедиться, что список не пуст перед вызовом GetHead.Если список пуст, отладочная версия библиотеки Microsoft Foundation Class assert.Используйте IsEmpty, чтобы убедиться, что список содержит элементы.

Пример

// Define myList.
CList<CString,CString&> myList;

// Add an element to the front of the list.
myList.AddHead(CString(_T("ABC")));

// Verify the element was added to the front of the list.
ASSERT(CString(_T("ABC")) == myList.GetHead());