CObList::GetHead
取得表示這個清單中的標頭項目的 CObject 指標。
CObject*& GetHead( );
const CObject*& GetHead( ) const;
傳回值
如果清單傳遞指標存取 const CObList，則 GetHead 傳回 CObject 指標。這可讓函式在指派陳述式右邊只使用和以保護清單受到修改。
如果清單傳遞指標直接存取 CObList或為，則 GetHead 傳回 CObject 指標的參考。這可讓函式使用在指派陳述式的任一端上因此允許清單項目進行修改。
備註
您必須確定清單是在呼叫 GetHead之前不是空的。如果清單是空的，則 MFC 程式庫的偵錯版本的判斷提示。使用 IsEmpty 確認清單包含項目。
下表顯示類似 CObList::GetHead的其他成員函式。
類別 |
成員函式 |
|---|---|
const void*_& GetHead const ();void*_& GetHead (); |
|
const CString_& GetHead const ();CString_& GetHead (); |
範例
提供 CAge 類別的目錄參閱 CObList::CObList 。
下列範例會在指派陳述式左邊的說明使用 GetHead 。
const CObList* cplist;
CObList* plist = new CObList;
CAge* page1 = new CAge(21);
CAge* page2 = new CAge(30);
CAge* page3 = new CAge(40);
plist->AddHead(page1);
plist->AddHead(page2); // List now contains (30, 21).
// The following statement REPLACES the head element.
plist->GetHead() = page3; // List now contains (40, 21).
ASSERT(*(CAge*) plist->GetHead() == CAge(40));
cplist = plist; // cplist is a pointer to a const list.
// cplist->GetHead() = page3; // Error: can't assign a pointer to a const list
ASSERT(*(CAge*) plist->GetHead() == CAge(40)); // OK
delete page1;
delete page2;
delete page3;
delete plist; // Cleans up memory.
需求
Header: afxcoll.h