CList::GetPrev

Artículo
06/10/2015

Obtiene el elemento de la lista identificado por rPosition, establezca rPosition al valor de POSICIÓN de entrada anterior en la lista.

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

Parámetros

TYPE
Parámetro de plantilla que especifica el tipo de los elementos de la lista.
rPosition
Una referencia a un valor devuelto de POSICIÓN por el GetPrev anterior u otra llamada de función miembro.

Valor devuelto

Si la lista está const, GetPrev devuelve una copia del elemento en el encabezado de la lista. Esto permite que la función se usa únicamente a la derecha de una instrucción de asignación y protege la lista de modificación.

Si la lista no está const, GetPrev devuelve una referencia a un elemento de la lista. Esto permite que la función se utiliza a cada lado de una instrucción de asignación y permite de modo que las entradas de lista son modificadas.

Comentarios

Puede utilizar GetPrev en un bucle de iteración inversa si establece la posición inicial con una llamada a GetTailPosition o a Buscar.

Debe asegurarse de que el valor de POSICIÓN representa una posición válida en la lista. Si no es válido, la versión de depuración de la biblioteca Microsoft Foundation Class aserciones.

Si el elemento recuperado es el primero en la lista, el nuevo valor de rPosition se establece en NULL.

Ejemplo

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