CList::GetNext

Artigo
08/25/2010

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

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

Parâmetros

TIPO
Parâmetro do modelo especifica o tipo dos elementos na lista.
rPosition
Uma referência a um POSIÇÃO valor retornado por um anteriorGetNext, GetHeadPosition ou Outros telefonar de função de membro.

Valor de retorno

Se a lista estiver Const, GetNext Retorna uma cópia de um elemento da lista. Isso permite que a função a ser usada somente no lado direito de uma demonstrativo de atribuição e protege a lista de modificação.

Se a lista não estiver Const, GetNext Retorna uma referência a um elemento da lista. Isso permite que a função a ser usada em um dos lados de uma demonstrativo de atribuição e, portanto, permite que as entradas da lista a ser modificada.

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

Você deve garantir que seu POSIÇÃOvalor de 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 NULO.

Exemplo

// Define myList.
CList<CString,CString&> myList;

// Add two elements to the list.
myList.AddHead(CString(_T("ABC")));
myList.AddHead(CString(_T("123")));

// Dump the list elements to the debug window.
POSITION pos = myList.GetHeadPosition();
for (int i = 0; i < myList.GetCount(); i++)
{
   TRACE(_T("%s\r\n"), (LPCTSTR)myList.GetNext(pos));
}