CList::GetNext

Artikel
06/10/2015

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

TYPE& GetNext( 
   POSITION& rPosition  
); 
const TYPE& GetNext( 
   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 GetNext, GetHeadPosition oder anderen Memberfunktionsaufruf zurück.

Rückgabewert

Wenn die Liste const ist, gibt GetNext eine Kopie eines Elements 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 GetNext 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 GetNext in einer vorwärts Iterationsschleife verwenden, wenn Sie die Anfangsposition mit einem Aufruf von GetHeadPosition 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 die letzte 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.
POSITION pos = myList.GetHeadPosition();
for (int i = 0; i < myList.GetCount(); i++)
{
   TRACE(_T("%s\r\n"), (LPCTSTR)myList.GetNext(pos));
}