CObList::GetHead

CObject * & GetHead ( );

CObject * GetHead ( ) const;

Возвращаемое значение

Если этот список осуществляется через указатель на const CObList, GetHead возвращает указатель от CObject . Это позволяет функции для использования только на правой части оператора присваивания и таким образом защищает списка от изменения.

Если этот список осуществляется напрямую или через указатель на CObList, GetHead возвращает ссылку на указатель от CObject . Это позволяет функции для использования с любой стороны от оператора присваивания и таким образом позволяет записи списка изменяемый.

Примечания

Получает указатель CObject , который представляет собой главный элемент этого списка.

Необходимо убедиться, что список не пуст перед вызовом GetHead. Если этот список пуст, отладочная версия библиотеки Microsoft Foundation Class утверждает. Использовать IsEmpty используется для проверки, что в списке содержатся элементы.

Пример

В следующем примере демонстрируется использование GetHead на левой стороне оператора присваивания.

nbsp;  const CObList * cplist;

CObList * plist = новый CObList;
   Кейдж * page1 = новый Кейдж (21);
   Кейдж * page2 = новый Кейдж (30);
   Кейдж * page3 = новый Кейдж (40);
   plist - > AddHead (page1);
   plist - > AddHead (page2);  / / Список теперь содержит (30, 21).
   / / Следующее заявление ЗАМЕНЯЕТ элемент head.
   plist - > GetHead() = page3; / / Список теперь содержит (40, 21).
   ASSERT (*(CAge*) plist - > GetHead() == Кейдж (40));
   cplist = plist;  / / cplist — указатель на список const.
/ / cplist - > GetHead() = page3; / / Ошибка: не удается назначить указатель на список const
   ASSERT (*(CAge*) plist - > GetHead() == Кейдж (40)); / / ОК

удалить page1;
   удалить page2;
   удалить page3;
   удалить plist; / / Очищает память

Обзор cObListЧлены класса | Иерархическая схема

См. также CObList::GetTail, CObList::GetTailPosition, CObList::AddHead, CObList::RemoveHead

Index