CObList::GetHead

Artikel
02/26/2013

Ruft den CObject Zeiger ab, der das HEAD-Element dieser Liste darstellt.

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

Rückgabewert

Wenn auf die Liste durch einen Zeiger auf const CObList zugegriffen wird, gibt GetHead einen CObject Zeiger zurück.Dies ermöglicht die nur auf der rechten Seite einer Zuweisungsanweisung verwendet werden, Funktion, und schützt somit die Liste von der Änderung.

Wenn auf die Liste direkt oder über einen Zeiger auf CObList zugegriffen wird, gibt GetHead einen Verweis auf ein CObject Zeiger 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.

In der folgenden Tabelle werden andere Memberfunktionen auf, die mit CObList::GetHead ähneln.

Klasse	Memberfunktion
CPtrList	*const const void& GetHead( ); void& GetHead( );*
CStringList	const const CString& GetHead( ); CString& GetHead( );

Beispiel

Siehe CObList::CObList für Listen der CAge-Klasse.

Im folgenden Beispiel wird die Verwendung von GetHead auf der linken Seite einer Zuweisungsanweisung.

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.