CObList::GetHead

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

Index