CList::GetHead
更新 : 2007 年 11 月
リストの先頭要素、または先頭要素への参照を取得します。
const TYPE& GetHead( ) const;
TYPE& GetHead( );
パラメータ
- TYPE
リスト内のオブジェクトの型を指定するテンプレート パラメータ。
戻り値
const リストの場合、GetHead はリストの先頭の要素のコピーを返します。このとき、この関数を代入ステートメントの右辺にしか使えないので、リストは変更されません。
リストが const 以外の場合、GetHead はリストの先頭の要素への参照を返します。このとき、この関数は代入ステートメントの右辺にも左辺にも使用できるので、リストのエントリを変更できます。
解説
GetHead 関数を呼び出す前に、リストが空でないことを確認する必要があります。リストが空の場合、MFC ライブラリのデバッグ環境ではアサートされます。リストに要素があるかどうかは、IsEmpty 関数で確認できます。
使用例
// Define myList.
CList<CString,CString&> myList;
// Add an element to the front of the list.
myList.AddHead(CString(_T("ABC")));
// Verify the element was added to the front of the list.
ASSERT(CString(_T("ABC")) == myList.GetHead());
必要条件
ヘッダー : afxtempl.h