CList::GetHead

Articolo
03/05/2013

Ottiene l'elemento head o un riferimento all'elemento head) di questo elenco.

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

Parametri

TIPO
Parametro di modello che specifica il tipo di oggetto nell'elenco.

Valore restituito

Se l'elenco è const, GetHead restituisce una copia dell'elementoinizio dell'elenco.Questo consente alla funzione da utilizzare solo nella parte destra di un'istruzione di assegnazione e proteggere l'elenco di modifica.

Se l'elenco non è const, GetHead restituisce un riferimento all'inizio dell'elenco.Questo consente alla funzione da utilizzare per entrambi i lati di un'istruzione di assegnazione e pertanto consente le voci di elenco da modificare.

Note

È necessario verificare che l'elenco non è vuoto prima di chiamare GetHead.Se l'elenco è vuoto, la versione di debug delle asserzioni della libreria MFC.Utilizzare IsEmpty per verificare che l'elenco contenga elementi.

Esempio

// 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());