CObList::AddHead

2011-08-09

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

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

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