Compartilhar via


CTypedPtrList::GetNext

Obtém o elemento de lista identificado por rPosition, então define rPosition ao valor de POSIÇÃO de entrada seguir na lista.

TYPE& GetNext(
   POSITION& rPosition 
);
TYPE GetNext(
   POSITION& rPosition 
) const;

Parâmetros

  • TIPO
    Parâmetros de modelo que especifica o tipo de elementos contidos em esta lista.

  • rPosition
    Uma referência a um valor de POSIÇÃO retornado por GetNextanterior, por GetHeadPosition, ou por outra chamada de função de membro.

Valor de retorno

Se a lista é acessada através de um ponteiro para const CTypedPtrList, então GetNext retorna um ponteiro de tipo especificado pelo parâmetro TIPO de modelo.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 CTypedPtrList, então GetNext retorna uma referência a um ponteiro de tipo especificado pelo parâmetro TIPO de modelo.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ê pode usar GetNext em um loop de iteração para frente determinando-se a posição inicial com uma chamada a GetHeadPosition ou a CPtrList::Find.

Você deve garantir que o valor de POSIÇÃO representa uma posição válido na lista.Se for inválido, então a versão de depuração de biblioteca de classes da Microsoft foundation afirma.

Se o elemento recuperado é o último na lista, então o novo valor de rPosition é definido como NULO.

é possível remover um elemento durante uma iteração.Consulte o exemplo para CObList::RemoveAt.

Requisitos

Cabeçalho: afxtempl.h

Consulte também

Referência

Classe de CTypedPtrList

Gráfico de hierarquia

CObList::Find

CObList::GetHeadPosition

CObList::GetTailPosition

CTypedPtrList::GetPrev

CTypedPtrList::GetHead

CTypedPtrList::GetTail