Compartir a través de


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

CPtrList

const void*& GetHead( ) const; void*& GetHead( );

CStringList

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

Vea también

Referencia

Clase CObList

Gráfico de jerarquía

CObList::GetTail

CObList::GetTailPosition

CObList::AddHead

CObList::RemoveHead