CList::GetPrev

Articolo
06/10/2015

Ottiene l'elemento dell'elenco identificato da rPosition, quindi imposta rPosition al valore POSITION voce precedente nell'elenco.

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

Parametri

TIPO
Parametro di modello che specifica il tipo degli elementi nell'elenco.
rPosition
Un riferimento a un valore di percorso restituito da GetPrev precedente o da un'altra chiamata di funzione membro.

Valore restituito

Se l'elenco è const, GetPrev restituisce una copia dell'elementoinizio dell'elenco. Questo consente alla funzione da utilizzare solo nella parte destra di un'istruzione di assegnazione e proteggere l'elenco di modifica.

Se l'elenco non è const, GetPrev restituisce un riferimento a un elemento di elenco. Questo consente alla funzione da utilizzare per entrambi i lati di un'istruzione di assegnazione e pertanto consente le voci di elenco da modificare.

Note

È possibile utilizzare GetPrev in un ciclo di iterazione inverso se si stabilisce la posizione iniziale con una chiamata a GetTailPosition o a Trova.

È necessario assicurarsi che il valore della posizione rappresenta un percorso valido nell'elenco. Se non è valido, quindi la versione di debug delle asserzioni della libreria MFC.

Se l'elemento recuperato è il primo l'elenco, il nuovo valore rPosition è impostato su NULL.

Esempio

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