CList::GetNext

Artigo
02/25/2013

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 
);
const TYPE& GetNext( 
   POSITION& rPosition  
) const;

Parâmetros

TIPO
Parâmetros de modelo que especifica o tipo dos elementos na 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 estiver const, GetNext retorna uma cópia de um elemento da lista.Isso permite que a função é usada somente no lado direito de uma instrução de atribuição e protege a lista de alteração.

Se a lista não é const, GetNext retorna uma referência a um elemento da lista.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 Localizar.

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.

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));
}