Partager via


CObList::GetHead

Obtient le pointeur d' CObject qui représente l'élément principal de cette liste.

CObject*& GetHead( ); 
const CObject*& GetHead( ) const;

Valeur de retour

Si la liste est accessible via un pointeur vers const CObList, puis GetHead retourne un pointeur d' CObject . 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 CObList, puis GetHead retourne une référence à un pointeur d' CObject . 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.

Le tableau suivant indique les autres fonctions membres similaires à CObList::GetHead.

Classe

Fonction membre

CPtrList

void*& const (const GetHead) ; void*& GetHead () ;

CStringList

CString& const (const GetHead) ; CString& GetHead () ;

Exemple

Consultez CObList::CObList pour obtenir l'intégralité de la classe d' CAge .

L'exemple suivant illustre l'utilisation d' GetHead sur le côté gauche d'une instruction d'assignation.

const CObList* cplist;

CObList* plist = new CObList;
CAge* page1 = new CAge(21);
CAge* page2 = new CAge(30);
CAge* page3 = new CAge(40);
plist->AddHead(page1);
plist->AddHead(page2);  // List now contains (30, 21). 
// The following statement REPLACES the head element.
plist->GetHead() = page3; // List now contains (40, 21).
ASSERT(*(CAge*) plist->GetHead() == CAge(40));
cplist = plist;  // cplist is a pointer to a const list. 
// cplist->GetHead() = page3; // Error: can't assign a pointer to a const list
ASSERT(*(CAge*) plist->GetHead() == CAge(40)); // OK 

delete page1;
delete page2;
delete page3;
delete plist; // Cleans up memory.      

Configuration requise

Header: afxcoll.h

Voir aussi

Référence

CObList, classe

Graphique de la hiérarchie

CObList::GetTail

CObList::GetTailPosition

CObList::AddHead

CObList::RemoveHead