Partager via


CObList::GetNext

Obtient l'élément de liste identifié par rPosition, puis définit rPosition à la valeur d' POSITION de l'entrée dans la liste.

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

Paramètres

  • rPosition
    Une référence à une valeur d' POSITION retournée par GetNextprécédent, GetHeadPosition, ou un autre appel d'une fonction membre.

Valeur de retour

Consultez la description de la valeur de retour de GetHead.

Notes

Vous pouvez utiliser GetNext dans une boucle d'itération avancée si vous générez la position d'origine par un appel à GetHeadPosition ou à Find.

Vous devez vérifier que la valeur d' POSITION représente une position valide dans la liste. Si elle n'est pas valide, la version debug des assertions de la bibliothèque MFC.

Si l'élément est extrait le dernier dans la liste, la nouvelle valeur d' rPosition a la valeur NULL.

Il est possible de supprimer un élément au cours d'une itération. Consultez l'exemple pour RemoveAt.

Notes

As of MFC 8,0 la version const de cette méthode a été modifiée pour retourner const CObject* au lieu d' const CObject*&.Cette modification a été apportée pour entrer le compilateur dans la conformité à la norme C++.

Le tableau suivant indique les autres fonctions membres similaires à CObList::GetNext.

Classe

Fonction membre

CPtrList

void*& GetNext( POSITION& rPosition );

const void* GetNext( POSITION& rPosition ) const;

CStringList

CString& GetNext( POSITION& rPosition );

const CString& GetNext( POSITION& rPosition ) const;

Exemple

Consultez CObList::CObList pour obtenir l'intégralité de la classe d' CAge .

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      

Les résultats de ce programme sont les suivantes :

a CAge at $479C 40

a CAge at $46C0 21

Configuration requise

Header: afxcoll.h

Voir aussi

Référence

CObList, classe

Graphique de la hiérarchie

CObList::Find

CObList::GetHeadPosition

CObList::GetTailPosition

CObList::GetPrev

CObList::GetHead