CObList::AddHead

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

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

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

パラメータ

newElement
リストに追加する CObject ポインタ。
pNewList
他の CObList リストへのポインタ。pNewList 内の要素がこのリストに追加されます。

戻り値

最初の形式は、新しく挿入した要素の POSITION 値を返します。

CObList::AddHead に類似している他のメンバ関数を以下に示します。

クラス	メンバ関数
CPtrList	POSITION AddHead( voidnewElement ); void AddHead( CPtrListpNewList );
CStringList	POSITION AddHead(const CString&newElement ); POSITION AddHead(LPCTSTRnewElement ); void AddHead(CStringList*pNewList );

CPtrList

POSITION AddHead( void*newElement );

void AddHead( CPtrList*pNewList );

CStringList

POSITION AddHead(const CString&newElement );

POSITION AddHead(LPCTSTRnewElement );

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