CList::GetNext

Article
06/10/2015

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

Paramètres

TYPE
Paramètre de modèle spécifiant le type des éléments dans la 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 const, GetNext retourne une copie d'un élément de la liste. Cela permet la fonction à utiliser uniquement à droite d'une instruction d'assignation et empêché la liste de la modification.

Si la liste n'est pas const, GetNext retourne une référence à un élément de la liste. 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 à Rechercher.

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.

Exemple

// 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));
}