CObList::AddHead

Статья
02/20/2013

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

POSITION AddHead(
   CObject* newElement 
);
void AddHead(
   CObList* pNewList 
);

Параметры

newElement
Указатель CObject, добавляемый к этому списку.
pNewList
Указатель на другой список CObList.Элементы в pNewList будут добавлены к этому списку.

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

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

В следующей таблице приведены другие функции-члены, которые похожи на CObList::AddHead.

Класс	Функция-член
CPtrList	POSITION AddHead( void* newElement ); void AddHead( CPtrList* pNewList );
CStringList	POSITION AddHead(const CString& newElement ); POSITION AddHead(LPCTSTR newElement ); void AddHead(CStringList* pNewList);

CPtrList

POSITION AddHead( void* newElement );

void AddHead( CPtrList* pNewList );

CStringList

POSITION AddHead(const CString& newElement );

POSITION AddHead(LPCTSTR newElement );

void AddHead(CStringList* pNewList);

Заметки

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

Пример

См. перечисление CObList::CObList для класса CAge.

CObList list;
list.AddHead(new CAge(21)); // 21 is now at head.
list.AddHead(new CAge(40)); // 40 replaces 21 at head.
#ifdef _DEBUG
   afxDump.SetDepth(1);
   afxDump << _T("AddHead example: ") << &list << _T("\n");
#endif

Результаты из этой программы следующим образом:

AddHead example: A CObList with 2 elements

a CAge at $44A8 40

a CAge at $442A 21