CList::GetHead

Artigo
02/25/2013

Obtém o elemento principal (ou uma referência ao elemento principal) de esta lista.

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

Parâmetros

TIPO
Parâmetros de modelo que especifica o tipo de objeto na lista.

Valor de retorno

Se a lista estiver const, GetHead retorna uma cópia do elemento no início da lista.Isso permite que a função é usada somente no lado direito de uma instrução de atribuição e protege a lista de alteração.

Se a lista não é const, GetHead retorna uma referência ao elemento no início da lista.Isso permite a função é usada em ambos os lados de uma instrução de atribuição e isso permite que as entradas de lista são alteradas.

Comentários

Você deve garantir que a lista não está vazio antes de chamar GetHead.Se a lista estiver vazia, então a versão de depuração de biblioteca de classes da Microsoft foundation afirma.Use IsEmpty para verificar que a lista contém os 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());