CList::AddHead

Статья
02/20/2013

Добавляет новый элемент или список элементов в начало списка.

POSITION AddHead(
   ARG_TYPE newElement 
);
void AddHead(
   CList* pNewList 
);

Параметры

ARG_TYPE
Параметр шаблона, указывающие тип элемента списка (может иметь ссылку).
newElement
Новый элемент.
pNewList
Указатель на другой список CList.Элементы в pNewList будут добавлены к этому списку.

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

Первая версия возвращает значение POSITION вновь вставленного элемента.

Заметки

Список может быть пустым перед операцией.

Пример

// Declarations of the variables used in the example
CList<CString,CString&> myList;
CList<CString,CString&> myList2;

// There are two versions of CList::AddHead: one adds a single
// element to the front of the list, the second adds another list
// to the front. 

// This adds the string "ABC" to the front of myList.
// myList is a list of CStrings (ie defined as CList<CString,CString&>).
myList.AddHead(CString(_T("ABC")));

// This adds the elements of myList2 to the front of myList.
myList.AddHead(&myList2);