CList::AddTail

Статья
02/20/2013

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

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

Параметры

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

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

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

Заметки

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

Пример

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

// Add elements to the end of myList and myList2.
myList.AddTail(CString(_T("A")));
myList.AddTail(CString(_T("B")));
myList2.AddTail(CString(_T("C")));
myList2.AddTail(CString(_T("D")));

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

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

// This adds the elements of myList2 to the end of myList.
myList.AddTail(&myList2);