CObList::RemoveHead

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

更新 : 2007 年 11 月

リストの先頭要素を削除し、その要素へのポインタを返します。

CObject* RemoveHead( );

戻り値

リストの先頭にあった直前の CObject ポインタを返します。

解説

RemoveHead 関数を呼び出す前に、リストが空でないことを確認する必要があります。リストが空の場合、MFC ライブラリのデバッグ環境ではアサートされます。リストに要素があるかどうかは、IsEmpty 関数で確認できます。

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

クラス	メンバ関数
CPtrList	*void RemoveHead( );**
CStringList	CString RemoveHead( );

使用例

CAge クラスのリストについては、「CObList::CObList」を参照してください。

CObList list;
CAge* pa1;
CAge* pa2;

list.AddHead(pa1 = new CAge(21));
list.AddHead(pa2 = new CAge(40)); // List now contains (40, 21).
ASSERT(*(CAge*) list.RemoveHead() == CAge(40));  // Old head
ASSERT(*(CAge*) list.GetHead() == CAge(21));  // New head
delete pa1;
delete pa2;