AddHead

AddHead

AddHead是添加一個新元素或列表元素到此開頭的列表,返回值第一個版本返回新插入。

函數原型


CList類中

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

CObList類中

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

參數


CList類中

ARG_TYPE :指定列表元素的類型模板參數(可以是引用)。
newElement:新元素。
pNewList :到另一 CList 的指針列表。在 pNewList 的組件將添加到此列表。

CObList類中

newElement:要添加的 CObject 指向此列表。
pNewList :到另一 CObList 的指針列表。在 pNewList 的組件將添加到此列表。

返回值


第一個版本返回新插入的元素的 POSITION 值。

備註


在操作之前該列表可為null

示例


CList類中

// Declarations of the variables used in the example
CList myList;
CList 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).
myList.AddHead(CString(_T("ABC")));
// This adds the elements of myList2 to the front of myList.
myList.AddHead(&myList2);

CObList類

用於列表 CAge 選件類參見 CObList::CObList。
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