CObList::AddHead

この一覧の先頭に新しい要素または要素のリストを追加します。

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

パラメーター

• newElement
  このリストに追加する CObject のポインター。

• pNewList
  CObList の別のリストへのポインター。pNewList の要素は、この一覧に追加されます。

戻り値

最初のバージョンが新しく挿入される要素の POSITION の値を返します。

次の表は CObList::AddHeadに似ている他のメンバー関数を示します。

Class	メンバー関数
CPtrList	POSITION AddHead( void* newElement) ; void AddHead( CPtrList* pNewList) ;
CStringList	POSITION AddHead(const CString& newElement) ; POSITION AddHead(LPCTSTR newElement) ; void AddHead(CStringList* pNewList) ;

解説

リストは、演算の前に空の場合もあります。

使用例

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      

このプログラムの結果は次のとおりです。:

AddHead example: A CObList with 2 elements

a CAge at $44A8 40

a CAge at $442A 21

必要条件

Header: afxcoll.h

参照

関連項目

CObList クラス

階層図

CObList::GetHead

CObList::RemoveHead