CList::GetHead

Article
03/04/2013

Obtient l'élément principal (ou une référence à l'élément principal) de cette liste.

const TYPE& GetHead( ) const;
TYPE& GetHead( );

Paramètres

TYPE
Paramètre de modèle spécifiant le type d'objet dans la liste.

Valeur de retour

Si la liste est const, GetHead 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, GetHead retourne une référence à l'élément au début 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 devez garantir que la liste n'est pas vide avant d'appeler GetHead.Si la liste est vide, la version debug des assertions de la bibliothèque MFC.Utilisez IsEmpty pour vérifier que la liste contient des éléments.

Exemple

// Define myList.
CList<CString,CString&> myList;

// Add an element to the front of the list.
myList.AddHead(CString(_T("ABC")));

// Verify the element was added to the front of the list.
ASSERT(CString(_T("ABC")) == myList.GetHead());