CList::GetHead
Ruft das HEAD-Element (oder einen Verweis auf das Anfangselement) dieser Liste.
const TYPE& GetHead( ) const;
TYPE& GetHead( );
Parameter
- TYP
Vorlagenparameter, der den Typ des Objekts in der Liste angibt.
Rückgabewert
Wenn die Liste const ist, gibt GetHead eine Kopie des Elements am Anfang der Liste zurück.Dies ermöglicht die nur auf der rechten Seite einer Zuweisungsanweisung verwendet werden, Funktion, und schützt die Liste von der Änderung.
Wenn die Liste nicht const ist, gibt GetHead einen Verweis auf das Element am Anfang der Liste zurück.Dies ermöglicht die von einer Zuweisungsanweisung auf beiden Seiten verwendet werden, Funktion, und ermöglicht somit die geändert werden, werden.
Hinweise
Sie müssen sicherstellen, dass die Liste nicht leer ist, bevor sie GetHead aufruft.Wenn die Liste leer ist, dann die Debugversion der Microsoft Foundation Class-Bibliothek-Assertionen.Verwenden Sie IsEmpty, um zu überprüfen, ob die Liste Elemente enthält.
Beispiel
// 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());
Anforderungen
Header: afxtempl.h