CObject * & GetHead ( );
CObject * GetHead ( ) const;
Valor devuelto
Si la lista se accede a través de un puntero a un CObList const, GetHead devuelve un puntero de CObject . Esto permite que la función ser utilizado sólo en el lado derecho de una instrucción de asignación y protege así a la lista de modificación.
Si la lista se accede directamente o a través de un puntero a un CObList, GetHead devuelve una referencia a un puntero de CObject . Esto permite la función ser utilizado en ambos lados de una instrucción de asignación y así las entradas de la lista a ser modificado.
Observaciones
Obtiene el puntero de CObject que representa el elemento central de esta lista.
Debe asegurarse de que la lista no está vacía antes de llamar a GetHead. Si la lista está vacía, la versión de depuración de la biblioteca Microsoft Foundation Class afirma. Utilice IsEmpty para comprobar que la lista contiene elementos.
Ejemplo
El ejemplo siguiente ilustra el uso de GetHead en el lado izquierdo de una instrucción de asignación.
nbsp; const CObList * cplist;
CObList * plist = new CObList;
Jaula * página1 = nueva jaula (21);
Jaula * page2 = nueva jaula (30);
Jaula * página3 = nueva jaula (40);
plist - > AddHead (página1);
plist - > AddHead (página2); / / Lista contiene ahora (30, 21).
/ / La siguiente instrucción reemplaza el elemento cabeza.
plist - > GetHead() = página 3; / / Lista ahora contiene 40 (21).
ASSERT (*(CAge*) plist - > GetHead() == CAge (40));
cplist = plist; / / cplist es un puntero a un const lista.
/ / cplist - > GetHead() = página 3; / / Error: no se puede asignar un puntero a la lista un const
ASSERT (*(CAge*) plist - > GetHead() == CAge (40)); / / ACEPTAR
Eliminar página 1;
eliminar página2;
Eliminar página 3;
eliminar plist; / / Limpia memoria
Visió&n General de cObList |nbsp; Miembros de clase | Diagrama de jerarquía
Vea tambié&nnbsp;CObList::GetTail, CObList::GetTailPosition, CObList::AddHead, CObList::RemoveHead