共用方式為


CList::GetHead

取得標頭項目 (或的標頭項目的參考) 這份清單。

const TYPE& GetHead( ) const;
TYPE& GetHead( );

參數

  • 型別
    指定物件型別的樣板參數清單中。

傳回值

如果清單是 constGetHead 傳回元素的複本在清單的開頭。 這可讓函式在指派陳述式右邊只使用和保護清單受到修改。

如果清單不是, constGetHead 傳回對這個項目的參考在清單的開頭。 這可讓函式使用在指派陳述式的任一端上因此允許清單項目進行修改。

備註

您必須確定清單是在呼叫 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());      

需求

Header: afxtempl.h

請參閱

參考

CList 類別

階層架構圖

CList::GetTail

CList::GetTailPosition

CList::AddHead

CList::RemoveHead