CList::GetHead

Artigo
08/25/2010

Obtém o elemento head (ou uma referência ao elemento head) desta lista.

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

Parâmetros

TIPO
Parâmetro do modelo especifica o tipo de objeto na lista.

Valor de retorno

Se a lista estiver Const, GetHead Retorna uma cópia do elemento no topo da lista. Isso permite que a função a ser usada somente no lado direito de uma demonstrativo de atribuição e protege a lista de modificação.

Se a lista não estiver Const, GetHead Retorna uma referência ao elemento no topo da lista. Isso permite que a função a ser usada em um dos lados de uma demonstrativo de atribuição e, portanto, permite que as entradas da lista a ser modificada.

Comentários

Você deve garantir que a lista não vazia antes de chamar GetHead. Se a lista estiver vazia, a versão de depurar de biblioteca Microsoft Foundation classe declara.Use IsEmpty para verificar se a lista contém elementos.

Exemplo

// 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());