CList::GetPrev

Artikel
02/26/2013

Ruft das Listenelement, das durch rPosition identifiziert wird ab, wird rPosition zum POSITION-Wert des vorherigen Eintrags in der Liste fest.

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

Parameter

TYP
Vorlagenparameter, der den Typ der Elemente in der Liste angibt.
rPosition
Ein Verweis auf einen Wert POSITION zurückgegebenen Daten vorhergehendes GetPrev oder anderen Memberfunktionsaufruf zurück.

Rückgabewert

Wenn die Liste const ist, gibt GetPrev eine Kopie des Elements am Anfang der Liste zurück.Dies ermöglicht die nur auf der rechten Seite einer Zuweisungsanweisung verwendet werden, Funktion, und schützt die Liste von der Änderung.

Wenn die Liste nicht const ist, gibt GetPrev einen Verweis auf ein Element der Liste zurück.Dies ermöglicht die von einer Zuweisungsanweisung auf beiden Seiten verwendet werden, Funktion, und ermöglicht somit die geändert werden, werden.

Hinweise

Sie können GetPrev in einer Rückiterationsschleife verwenden, wenn Sie die Anfangsposition mit einem Aufruf von GetTailPosition oder zu Suchen herstellen.

Sie müssen sicherstellen, dass das POSITION-Wert eine gültige Position in der Liste darstellt.Wenn er ungültig ist, dann die Debugversion der Microsoft Foundation Class-Bibliothek-Assertionen.

Wenn das abgerufene Element das erste in der Liste ist, wird der neue Wert für rPosition zu NULL festgelegt.

Beispiel

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