Partager via


CTypedPtrList::GetNext

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

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

Paramètres

  • TYPE
    Paramètre de modèle spécifiant le type d'éléments contenus dans cette liste.

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

Valeur de retour

Si la liste est accessible via un pointeur vers const CTypedPtrList, puis GetNext retourne un pointeur du type spécifié par le TYPEde paramètre de modèle. Cela permet la fonction à utiliser uniquement à droite d'une instruction d'assignation et empêché la liste de la modification.

Si la liste est accessible directement ou via un pointeur vers CTypedPtrList, puis GetNext retourne une référence à un pointeur du type spécifié par le TYPEde paramètre de modèle. Cela permet la fonction à utiliser de chaque côté d'une instruction d'assignation et permet donc les entrées de liste à modifier.

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 à CPtrList::Find.

Vous devez vérifier que la valeur de 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 CObList::RemoveAt.

Configuration requise

Header: afxtempl.h

Voir aussi

Référence

CTypedPtrList, classe

Graphique de la hiérarchie

CObList::Find

CObList::GetHeadPosition

CObList::GetTailPosition

CTypedPtrList::GetPrev

CTypedPtrList::GetHead

CTypedPtrList::GetTail