CObList::GetHead
获取表示头此列表中的元素的 CObject 指针。
CObject*& GetHead( );
const CObject*& GetHead( ) const;
返回值
如果列表是通过指针捕获到 const CObList，则 GetHead 返回 CObject 指针。这使得功能在赋值语句右侧仅使用从而防止修改的列表。
如果列表是通过指针直接获取或设置 CObList，则 GetHead 返回对 CObject 指针。这使得函数使用在赋值语句的两侧从而允许列表项进行修改。
备注
您必须确保列表在调用 GetHead之前不为null。如果列表为空，则选件Microsoft基础类库的调试版本断言。使用 IsEmpty 验证列表包含元素。
下表显示类似于 CObList::GetHead的其他成员函数。
类 |
成员函数 |
|---|---|
const void*& GetHead( ) 常量;void*& GetHead( ); |
|
const CString& GetHead( ) 常量;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