Freigeben über


CTypedPtrList::GetNext

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  
); 
TYPE GetNext( 
   POSITION& rPosition  
) const;

Parameter

  • TYP
    Vorlagenparameter, der den Typ von Elementen enthalten in dieser Liste angibt.

  • rPosition
    Ein Verweis auf einen Wert POSITION zurückgegebenen Daten vorhergehendes GetNext, GetHeadPosition oder anderen Memberfunktionsaufruf zurück.

Rückgabewert

Wenn auf die Liste durch einen Zeiger auf const CTypedPtrList zugegriffen wird, gibt GetNext einen Zeiger vom Typ zurück, der durch den Vorlagenparametertyp angegeben wird. Dies ermöglicht die nur auf der rechten Seite einer Zuweisungsanweisung verwendet werden, Funktion, und schützt somit die Liste von der Änderung.

Wenn auf die Liste direkt oder über einen Zeiger auf CTypedPtrList zugegriffen wird, gibt GetNext einen Verweis auf einen Zeiger vom Typ zurück, der durch den Vorlagenparametertyp angegeben wird. 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 CPtrList::Find 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.

Es ist möglich, ein Element während einer Iteration zu entfernen. Im Beispiel für CObList::RemoveAt.

Anforderungen

Header: afxtempl.h

Siehe auch

Referenz

CTypedPtrList-Klasse

Hierarchiediagramm

CObList::Find

CObList::GetHeadPosition

CObList::GetTailPosition

CTypedPtrList::GetPrev

CTypedPtrList::GetHead

CTypedPtrList::GetTail