次の方法で共有


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

参照

関連項目

CList クラス

階層図

CList::GetTail

CList::GetTailPosition

CList::AddHead

CList::RemoveHead