CList::GetHead

获取元素的刀头(或指向头元素的引用)此列表。

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

参数

  • 类型
    指定对象的类型模板参数列表。

返回值

如果列表为 constGetHead 返回元素的副本放在列表的开头。这使得功能在赋值语句右侧仅使用并防止修改的列表。

如果列表不是 constGetHead 返回对元素列表的开头。这使得函数使用在赋值语句的两侧从而允许列表项进行修改。

备注

您必须确保列表在调用 GetHead之前不为null。如果列表为空,则选件Microsoft基础类库的调试版本断言。使用 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