CObList::GetHead

Artykuł
02/27/2013

Pobiera CObject wskaźnik reprezentujący elementu nagłówkowego tej listy.

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

Wartość zwracana

Jeśli lista jest dostępna za pośrednictwem wskaźnika do const CObList, następnie GetHead zwraca CObject wskaźnik.Umożliwia funkcja tylko na prawej stronie instrukcji przypisania, a zatem chroni przed modyfikacją listy.

Jeśli lista jest dostępna bezpośrednio lub za pomocą wskaźnika do CObList, następnie GetHead zwraca odwołanie do CObject wskaźnik.Umożliwia funkcji na dowolnej stronie instrukcji przypisania i tym samym pozwala na pozycje listy modyfikacji.

Uwagi

Musi zapewnić lista nie jest pusta przed wywoływaniem GetHead.Jeśli lista jest pusta, deklaracji rozkazujących wersji debugowania biblioteki klas Microsoft Foundation.Użyj IsEmpty , aby sprawdzić, czy lista zawiera elementy.

W poniższej tabeli przedstawiono funkcje, które są podobne do innego członka CObList::GetHead.

Klasa	Funkcja Członkowskie
CPtrList	*Const void & (GetHead) jest stała; void * & (GetHead);**
CStringList	Const CString & (GetHead) jest stała; CString & (GetHead);

Przykład

Zobacz CObList::CObList listę CAge klasy.

Poniższy przykład ilustruje użycie GetHead po lewej stronie instrukcji przypisania.

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.