CObList::GetHead

Článek
03/04/2013

Získává CObject ukazatel představující elementem tohoto seznamu.

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

Vrácená hodnota

Pokud seznam otevírá ukazatel const CObList, pak GetHead vrátí CObject ukazatel.To umožňuje funkce používané pouze na pravé straně příkazu přiřazení a tím chrání před změnami v seznamu.

Pokud je v seznamu přistupovat přímo nebo prostřednictvím ukazatele na CObList , pak GetHead vrací odkaz na CObject ukazatel.To umožňuje funkce používané na každé straně příkazu přiřazení a tak umožňuje upravit položky seznamu.

Poznámky

Musí zajistit, že seznam není prázdný před voláním GetHead .Nepodmíněných Pokud je seznam prázdný, pak ladicí verzi knihovny Microsoft Foundation Class výrazů.Použití IsEmpty ověřte, že seznam obsahuje prvky.

Následující tabulka obsahuje další členské funkce, které jsou podobné CObList::GetHead .

Třída	Členská funkce
CPtrList	*Const void & GetHead () const; void * & (GetHead);**
CStringList	Const CString & GetHead () const; CString & (GetHead);

Příklad

Viz CObList::CObList seznam CAge třídy.

Následující příklad ukazuje použití GetHead na levé straně příkazu přiřazení.

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.