CList::GetPrev

Article
03/04/2013

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

TYPE& GetPrev(
   POSITION& rPosition 
);
const TYPE& GetPrev( 
   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 GetPrev précédent ou un autre appel d'une fonction membre.

Valeur de retour

Si la liste est const, GetPrev retourne une copie de l'élément au début 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, GetPrev 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 GetPrev dans une boucle d'itération inverse si vous générez la position d'origine par un appel à GetTailPosition 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 premier 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,
// in reverse order.
POSITION pos = myList.GetTailPosition();
for (int i = 0; i < myList.GetCount(); i++)
{
   TRACE(_T("%s\r\n"), (LPCTSTR)myList.GetPrev(pos));
}