CList::AddHead

Статья
06/10/2015

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

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);