CObList::GetHead

CObject * & GetHead ( );

CObject * GetHead ( ) const;

Valor de retorno

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

Se a lista for acessada diretamente ou através de um ponteiro para um CObList, GetHead retorna uma referência para um ponteiro de CObject . Isso permite que a função para ser usada em ambos os lados de uma instrução de atribuição e, portanto, permite que as entradas da lista a ser modificada.

Observações

Obtém o ponteiro de CObject que representa o elemento cabeçalho desta lista.

Você deve garantir que a lista não seja vazia antes de chamar GetHead. Se a lista estiver vazia, a versão de Depurar do Microsoft Foundation Biblioteca de Classes asserts. Use IsEmpty para verificar se a lista contém elementos.

Exemplo

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

nbsp;  const CObList * cplist;

CObList * plist = CObList novo;
   Gaiola * page1 = nova gaiola (21);
   Gaiola * Página2 = nova gaiola (30);
   Gaiola * página3 = nova gaiola (40);
   plist - > AddHead (página 1);
   plist - > AddHead (página 2);  / / Lista agora contém (30, 21).
   / / A instrução a seguir substitui o elemento cabeçalho.
   plist - > GetHead() = Página3; / / Lista agora contém (40, 21).
   ASSERT (*(CAge*) plist - > GetHead() = = gaiola (40));
   cplist = plist;  / / cplist é um ponteiro para uma const listar.
/ / cplist - > GetHead() = Página3; / / Erro: não é possível atribuir um ponteiro para uma const listar
   ASSERT (*(CAge*) plist - > GetHead() = = gaiola (40)); / / OK

Excluir página 1;
   Excluir página 2;
   Excluir página 3;
   Excluir plist; / / Limpa a memória

Visão geral de cObListMembros de classe | Gráfico de hierarquia

Co&nsulte tambémnbsp;CObList::GetTail, CObList::GetTailPosition, CObList::AddHead, CObList::RemoveHead

Index