CObList::GetHead
Obtiene el puntero de CObject que representa el elemento principal de esta lista.
CObject*& GetHead( );
const CObject*& GetHead( ) const;
Valor devuelto
Si la lista se logra a través de un puntero a const CObList, después GetHead devuelve un puntero de CObject . Esto permite que la función se usa únicamente a la derecha de una instrucción de asignación y protege así la lista de modificación.
Si la lista está accesible directamente o a través de un puntero a CObList, después GetHead devuelve una referencia a un puntero de CObject . Esto permite que la función se utiliza a cada lado de una instrucción de asignación y permite de modo que las entradas de lista son modificadas.
Comentarios
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 aserciones. utilice IsEmpty para comprobar que la lista contiene elementos.
La tabla siguiente se muestran otras funciones miembro que son similares a CObList::GetHead.
Clase |
Función miembro |
|---|---|
const void*& GetHead( ) const; void*& GetHead( ); |
|
const CString& GetHead const ( ); CString& GetHead ( ); |
Ejemplo
Vea CObList:: CObList para una lista de la clase de CAge .
El ejemplo siguiente muestra el uso de GetHead en el lado izquierdo de una instrucción de asignación.
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.
Requisitos
encabezado: afxcoll.h