CList::GetHead
先頭要素 (またはこのリストの先頭要素への参照を取得します。)
const TYPE& GetHead( ) const;
TYPE& GetHead( );
パラメーター
- type
一覧でオブジェクトの型を指定するテンプレート パラメーター。
戻り値
リストが const場合、GetHead はリストの先頭から要素のコピーを返します。これは、関数が代入ステートメントの右側でのみ使用されるようにし、変更のリストを保護します。
リストが constである GetHead は、リストの先頭から要素への参照を返します。これは、関数が代入ステートメントのどちらにも使用されるようにするため、リスト エントリが変更されるようにします。
解説
リストが GetHeadを呼び出す前に、空でないことを確認する必要があります。リストが空の場合は、Microsoft Foundation Class ライブラリの assert のデバッグ バージョン。リストに要素が含まれていることを確認するには 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