CObject * & ; GetHead ( );
CObject * GetHead ( ) const ;
Valeur de retour
Si la liste est accessible via un pointeur vers un CObList const, GetHead retourne un pointeur de CObject . Cela permet à la fonction pour être utilisés uniquement sur la partie droite d'une instruction d'affectation et protège ainsi la liste de modification.
Si la liste est accessible directement ou via un pointeur à une CObList, GetHead retourne une référence à un pointeur de CObject . Cela permet à la fonction pour être utilisé sur les deux côtés d'une instruction d'affectation et permet ainsi les entrées de liste de modifier.
Remarques
Obtient le pointeur CObject qui représente l'élément head de cette liste.
Vous devez vous assurer que la liste n'est pas vide avant d'appeler GetHead. Si la liste est vide, la version Debug de la bibliothèque Microsoft Foundation Class affirme. Utilisez IsEmpty pour vérifier que la liste contient des éléments.
Exemple
L'exemple suivant illustre l'utilisation de GetHead sur le côté gauche d'une instruction d'affectation.
nbsp ; const CObList * cplist ;
CObList * plist = new CObList ;
CAge * page1 = nouvelle CAge (21) ;
CAge * page2 = nouvelle CAge (30) ;
CAge * page3 = nouvelle CAge (40) ;
plist - > AddHead (page1) ;
plist - > AddHead (page2) ; / Liste contient maintenant (30, 21).
/ / L'instruction suivante remplace l'élément head.
plist - > GetHead() = page3 ; / Liste contient maintenant (40, 21).
ASSERT (*(CAge*) plist - > GetHead() == CAge (40)) ;
cplist = plist ; / / cplist est un pointeur vers la liste un const.
/ / cplist - > GetHead() = page3 ; / / Erreur : Impossible d'assigner un pointeur vers un const liste
ASSERT (*(CAge*) plist - > GetHead() == CAge (40)) ; / / OK
supprimer page1 ;
supprimer page2 ;
supprimer page3 ;
supprimer plist ; / / Nettoie la mémoire
Aperçu cObList |  ; Membres de la classe | Graphique de la hiérarchie
Voir aussi  ;CObList::GetTail, CObList::GetTailPosition, CObList::AddHead, CObList::RemoveHead