CObject * & GetHead ( );
CObject * GetHead ( ) const;
Valore restituito
Se l'elenco è possibile accedere tramite un puntatore a un CObList const, GetHead restituisce un puntatore CObject . Questo permette la funzione per essere utilizzato soltanto sul lato destro di un'istruzione di assegnazione e quindi protegge l'elenco dalla modificazione.
Se l'elenco è possibile accedere direttamente o tramite un puntatore a un CObList, GetHead restituisce un riferimento a un puntatore CObject . Questo permette la funzione essere utilizzato su entrambi i lati di un'istruzione di assegnazione e quindi permette di modificare le voci di elenco.
Osservazioni
Ottiene il puntatore CObject che rappresenta l'elemento head di questo elenco.
È necessario assicurarsi che l'elenco non è vuota prima di chiamare GetHead. Se l'elenco è vuoto, quindi la versione di Debug di Microsoft Foundation Class Library afferma. Utilizzare IsEmpty per verificare che l'elenco contiene elementi.
Esempio
Nell'esempio seguente viene illustrato l'utilizzo di GetHead sul lato sinistro di un'istruzione di assegnazione.
nbsp; const CObList * cplist;
CObList * plist = nuovo CObList;
Gabbia * pagina1 = nuova gabbia (21);
Gabbia * pagina2 = nuova gabbia (30);
Gabbia * pagina3 = nuova gabbia (40);
plist - > AddHead (pagina 1);
plist - > AddHead (pagina 2); / / Lista contiene ora (30, 21).
/ / L'istruzione seguente sostituisce l'elemento head.
plist - > GetHead() = pagina3; / / Lista contiene ora (40, 21).
ASSERT (*(CAge*). plist - > GetHead() = = CAge (40));
cplist = plist; / / cplist è un puntatore const elencare.
/ / cplist - > GetHead() = pagina3; / / Errore: non è possibile assegnare un puntatore const elencare
ASSERT (*(CAge*). plist - > GetHead() = = CAge (40)); / / OK
eliminare pagina1;
eliminare pagina2;
eliminare pagina3;
eliminare plist; / / Pulisce la memoria
Pa&noramica cObList |nbsp; Membri della classe | Gerarchia Chart
Vedere a&nchenbsp;CObList::GetTail, CObList::GetTailPosition, CObList::AddHead, CObList::RemoveHead