CObList::GetNext

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

CObject*& GetNext(
   POSITION& rPosition 
);
const CObject* GetNext( 
   POSITION& rPosition  
) const;

Parameter

• rPosition
  Ein Verweis auf einen Wert zurückgegeben POSITION durch vorhergehendes GetNext, GetHeadPosition oder anderen Memberfunktionsaufruf.

Rückgabewert

Siehe die Rückgabewertbeschreibung für GetHead.

Hinweise

Sie können GetNext in einer vorwärts Iterationsschleife verwenden, wenn Sie die Anfangsposition mit einem Aufruf von GetHeadPosition oder zu 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 RemoveAt.

Hinweis
Ab MFC 8.0 hat die const Version dieser Methode geändert, um const CObject* anstelle const CObject*& zurückzugeben.Diese Änderung wurde vorgenommen, um den Compiler in Übereinstimmung mit dem C++-Standard einzubinden.

In der folgenden Tabelle werden andere Memberfunktionen auf, die mit CObList::GetNext ähneln.

Beispiel

Siehe CObList::CObList für Listen der CAge-Klasse.

CObList list;
POSITION pos;
list.AddHead(new CAge(21));
list.AddHead(new CAge(40)); // List now contains (40, 21).
// Iterate through the list in head-to-tail order.
#ifdef _DEBUG
   for (pos = list.GetHeadPosition(); pos != NULL;)
   {
      afxDump << list.GetNext(pos) << _T("\n");
   }
#endif      

Die Ergebnisse dieses Programms sind, wie folgt:

a CAge at $479C 40

a CAge at $46C0 21

Anforderungen

Header: afxcoll.h

Siehe auch

Referenz

CObList-Klasse

Hierarchien-Diagramm

CObList::Find

CObList::GetHeadPosition

CObList::GetTailPosition

CObList::GetPrev

CObList::GetHead