CObList::GetHead
Obtém o ponteiro de CObject que representa o elemento principal da lista.
CObject*& GetHead( );
const CObject*& GetHead( ) const;
Valor de retorno
Se a lista é acessada através de um ponteiro para const CObList, então GetHead retorna um ponteiro de CObject .Isso permite que a função é usada somente no lado direito de uma instrução de atribuição e isso protege a lista de alteração.
Se a lista é acessada diretamente ou por um ponteiro para CObList, então GetHead retorna uma referência a um ponteiro de CObject .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.
A tabela a seguir mostra outras funções de membro que são semelhantes a CObList::GetHead.
Classe |
Função de membro |
|---|---|
const de GetHead de void*& const (;) void*& GetHead (;) |
|
const de CString& GetHead const (;) CString& GetHead (;) |
Exemplo
Consulte CObList::CObList para uma listagem da classe de CAge .
O exemplo a seguir ilustra o uso de GetHead no lado esquerdo de uma instrução 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