CList::RemoveHead

Artigo
08/25/2010

Remove o elemento do topo da lista e retorna um ponteiro para ele.

TYPE RemoveHead( );

Parâmetros

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

Valor de retorno

O elemento anteriormente no topo da lista.

Comentários

Você deve garantir que a lista não vazia antes de chamar RemoveHead. 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 two elements to the list.
myList.AddHead(CString(_T("ABC")));
myList.AddHead(CString(_T("123")));

// Remove the head element and verify the list.
// NOTE: once the head is removed, the number of
// elements in the list will be one.
CString strHead = myList.RemoveHead();
ASSERT((CString(_T("123")) == strHead) && (myList.GetCount() == 1) && 
   (CString(_T("ABC")) == myList.GetHead()));