CObList::GetNext

Artigo
08/25/2010

Obtém o elemento da lista identificado por rPosition, em seguida, define rPosition para o POSITION valor da próxima entrada na lista.

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

Parâmetros

rPosition
Uma referência a um POSITION valor retornado por uma anterior GetNext, GetHeadPosition, ou Outros telefonar de função de membro.

Valor de retorno

Consulte a descrição do valor retornado para GetHead.

Comentários

Você pode usar GetNext em um loop de iteração direta se estabelecer a posição inicial com uma telefonar para GetHeadPosition ou Find.

Você deve garantir que seu POSITION valor representa uma posição válida na lista. Se for inválido, versão de depurar de biblioteca Microsoft Foundation classe declara.

Se o elemento recuperado for o último na lista, o novo valor de rPosition é definido como NULL.

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

Observação:
sistema autônomo da MFC 8.0 a versão const deste método foi alterada para retornar const CObject* em vez de const CObject*&. Essa alterar foi feita para que o compilador de conformidade com o C++ padrão.

A tabela a seguir mostra outras funções de membro 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

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

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

sistema autônomo resultados deste programa são da seguinte maneira:

a CAge at $479C 40

a CAge at $46C0 21