CObList::GetHead
Получает указатель CObject, представляющий головной элемент списка.
CObject*& GetHead( );
const CObject*& GetHead( ) const;
Возвращаемое значение
Если доступ к списку осуществляется через указатель на const CObList, то GetHead возвращает указатель CObject.Это позволяет функции, которую необходимо использовать только в правой части оператора присваивания и, таким образом, защищающий список из изменений.
Если список доступа напрямую или через указатель на CObList, то GetHead возвращает ссылку на указатель CObject.Это позволяет функции, которую необходимо использовать с обеих сторон оператора назначения и таким образом позволяющее записи списка, который требуется изменить.
Заметки
Следует убедиться, что список не пуст перед вызовом GetHead.Если список пуст, отладочная версия библиотеки Microsoft Foundation Class assert.Используйте IsEmpty, чтобы убедиться, что список содержит элементы.
В следующей таблице приведены другие функции-члены, которые похожи на CObList::GetHead.
Класс |
Функция-член |
|---|---|
const GetHead void*& const (); void*& GetHead (); |
|
const CString& GetHead const (); CString& GetHead (); |
Пример
См. перечисление CObList::CObList для класса CAge.
В следующем примере показано использование GetHead в левой части оператора присваивания.
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.
Требования
Header: afxcoll.h