CList::GetPrev

Artigo
02/25/2013

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

TYPE& GetPrev(
   POSITION& rPosition 
);
const TYPE& GetPrev( 
   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 GetPrev anterior ou por outra chamada de função de membro.

Valor de retorno

Se a lista estiver const, GetPrev retorna uma cópia do elemento no início 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, GetPrev 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 GetPrev em um loop de iteração invertido determinando-se a posição inicial com uma chamada a GetTailPosition 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 primeiro 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,
// in reverse order.
POSITION pos = myList.GetTailPosition();
for (int i = 0; i < myList.GetCount(); i++)
{
   TRACE(_T("%s\r\n"), (LPCTSTR)myList.GetPrev(pos));
}