CList::RemoveTail

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

更新 : 2007 年 11 月

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

TYPE RemoveTail( );

パラメータ

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

戻り値

リストの末尾にあった要素へのポインタを返します。

解説

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

使用例

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

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

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