CList::GetHead

Artículo
06/10/2015

Obtiene el elemento principal (o una referencia al elemento principal) de esta lista.

const TYPE& GetHead( ) const; 
TYPE& GetHead( );

Parámetros

TYPE
Parámetro de plantilla que especifica el tipo de objeto de la lista.

Valor devuelto

Si la lista está const, GetHead devuelve una copia del elemento en el encabezado de la lista. Esto permite que la función se usa únicamente a la derecha de una instrucción de asignación y protege la lista de modificación.

Si la lista no está const, GetHead devuelve una referencia al elemento en el encabezado de la lista. 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.

Ejemplo

// Define myList.
CList<CString,CString&> myList;

// Add an element to the front of the list.
myList.AddHead(CString(_T("ABC")));

// Verify the element was added to the front of the list.
ASSERT(CString(_T("ABC")) == myList.GetHead());