CList::RemoveHead

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

更新 : 2007 年 11 月

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

TYPE RemoveHead( );

パラメータ

TYPE
リストの要素の型を指定するテンプレートパラメータ。

戻り値

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

解説

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

使用例

// Define myList.
CList<CString,CString&> myList;

// Add two elements to the list.
myList.AddHead(CString(_T("ABC")));
myList.AddHead(CString(_T("123")));

// Remove the head element and verify the list.
// NOTE: once the head is removed, the number of
// elements in the list will be one.
CString strHead = myList.RemoveHead();
ASSERT((CString(_T("123")) == strHead) && (myList.GetCount() == 1) && 
   (CString(_T("ABC")) == myList.GetHead()));