Freigeben über


CList::RemoveHead

Entfernt das Element aus dem Anfang der Liste und gibt einen Zeiger darauf zurück.

TYPE RemoveHead( );

Parameter

  • TYP
    Vorlagenparameter, der den Typ der Elemente in der Liste angibt.

Rückgabewert

Das Element zuvor am Anfang der Liste.

Hinweise

Sie müssen sicherstellen, dass die Liste nicht leer ist, bevor sie RemoveHead 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 two elements to the list.
myList.AddHead(CString(_T("ABC")));
myList.AddHead(CString(_T("123")));

// Remove the head element and verify the list. 
// NOTE: once the head is removed, the number of 
// elements in the list will be one.
CString strHead = myList.RemoveHead();
ASSERT((CString(_T("123")) == strHead) && (myList.GetCount() == 1) && 
   (CString(_T("ABC")) == myList.GetHead()));      

Anforderungen

Header: afxtempl.h

Siehe auch

Referenz

CList-Klasse

Hierarchiediagramm

CList::GetHead

CList::AddHead