Partilhar via


CObList::GetHead

Obtém o CObject ponteiro que representa o elemento head desta lista.

CObject*& GetHead( );
const CObject*& GetHead( ) const;

Valor de retorno

Se a lista for acessada através de um ponteiro para um Const CObList, then GetHead Retorna um CObject ponteiro. Isso permite que a função a ser usada somente no lado direito de uma demonstrativo de atribuição e, portanto, protege a lista contra modificações.

Se a lista é acessada diretamente ou através de um ponteiro para um CObList, em seguida, GetHead Retorna uma referência a um CObject ponteiro. 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.

A tabela a seguir mostra outras funções de membro semelhantes a CObList::GetHead.

Classe

Função de membro

CPtrList

Const void * & (GetHead) const; void * & GetHead ();

CStringList

() CString & GetHead const const; CString & GetHead ();

Exemplo

See CObList::CObList para obter uma lista do CAge classe.

O exemplo a seguir ilustra o uso de GetHead no lado esquerdo de uma demonstrativo de atribuição.

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.      

Requisitos

Cabeçalho: afxcoll.h

Consulte também

Referência

Classe cObList

Gráfico de hierarquia

CObList::GetTail

CObList::GetTailPosition

CObList::AddHead

CObList::RemoveHead

Outros recursos

CObList membros