CObList::GetNext

Artigo
02/25/2013

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

CObject*& GetNext(
   POSITION& rPosition 
);
const CObject* GetNext( 
   POSITION& rPosition  
) const;

Parâmetros

rPosition
Uma referência a um valor de POSITION retornado por GetNextanterior, por GetHeadPosition, ou por outra chamada de função de membro.

Valor de retorno

Consulte a descrição do valor de retorno para GetHead.

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 Find.

Você deve garantir que o valor de POSITION 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 NULL.

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

Observação
Até a data de MFC 8,0 a versão const este modelo mudou para retornar const CObject* em vez de const CObject*&.Essa alteração foi feita para transferir o compilador em conformidade com o padrão C++.

A tabela a seguir mostra outras funções de membro que são semelhantes a CObList::GetNext.

Classe	Função de membro
CPtrList	void& GetNext( POSITION& rPosition ); const void GetNext( POSITION& rPosition ) const;
CStringList	CString& GetNext( POSITION& rPosition ); const CString& GetNext( POSITION& rPosition ) const;

CPtrList

void*& GetNext( POSITION& rPosition );

const void* GetNext( POSITION& rPosition ) const;

CStringList

CString& GetNext( POSITION& rPosition );

const CString& GetNext( POSITION& rPosition ) const;

Exemplo

Consulte CObList::CObList para uma listagem da classe de CAge .

CObList list;
POSITION pos;
list.AddHead(new CAge(21));
list.AddHead(new CAge(40)); // List now contains (40, 21).
// Iterate through the list in head-to-tail order.
#ifdef _DEBUG
   for (pos = list.GetHeadPosition(); pos != NULL;)
   {
      afxDump << list.GetNext(pos) << _T("\n");
   }
#endif

Os resultados do programa é a seguinte:

a CAge at $479C 40

a CAge at $46C0 21