Clase de CList

Artículo
04/10/2013

Admite listas ordenadas de objetos nonunique accesibles secuencialmente o por valor.

template< class TYPE, class ARG_TYPE = const TYPE& > 
class CList : public CObject

Members

Constructores públicos

Name	Descripción
CList::CList	Crea una lista ordenada vacía.

Métodos públicos

Name	Descripción
CList::AddHead	Agrega un elemento (o todos los elementos de otros enumerados) al principio de la lista (crea un nuevo encabezado).
CList::AddTail	Agrega un elemento (o todos los elementos de otros enumerados) a la cola de la lista (crea una nueva cola).
CList::Find	Obtiene la posición de un elemento especificado por valor de puntero.
CList::FindIndex	Obtiene la posición de un elemento especificado por un índice de base cero.
CList::GetAt	Obtiene el elemento en una posición determinada.
CList::GetCount	devuelve el número de elementos en esta lista.
CList::GetHead	Devuelve el elemento principal de la lista (no puede estar vacía).
CList::GetHeadPosition	Devuelve la posición del elemento head de la lista.
CList::GetNext	Obtiene el elemento siguiente para recorrer.
CList::GetPrev	Obtiene el elemento anterior para recorrer.
CList::GetSize	devuelve el número de elementos en esta lista.
CList::GetTail	Devuelve el elemento de cola de la lista (no puede estar vacía).
CList::GetTailPosition	Devuelve la posición del elemento de cola de la lista.
CList::InsertAfter	Inserta un nuevo elemento después de una posición determinada.
CList::InsertBefore	Inserta un nuevo elemento antes de una posición determinada.
CList::IsEmpty	Comprueba la condición vacía de lista (ningún elemento).
CList::RemoveAll	quita todos los elementos de esta lista.
CList::RemoveAt	Quita un elemento de esta lista, especificada por posición.
CList::RemoveHead	Quita el elemento del encabezado de la lista.
CList::RemoveTail	Quita el elemento de cola de la lista.
CList::SetAt	Establece el elemento en una posición determinada.

Parámetros

TYPE
tipo de objeto almacenado en la lista.
ARG*_*TYPE
Tipo utilizado para hacer referencia a los objetos en la lista.puede ser una referencia.

Comentarios

las listas deCList se comportan como listas doble-vinculadas.

Una variable de POSICIÓN con tipo es una clave de la lista.Puede utilizar una variable de POSICIÓN como iterador para recorrer una lista secuencialmente y como marcador para contener un lugar.Una posición no es igual que un índice, sin embargo.

La inserción de elementos es muy rápidamente al principio de la lista, en la cola, y en POSICIÓNconocido.Una búsqueda secuencial es necesaria para buscar un elemento por valor o por índice.esta búsqueda puede ser lenta si la lista es larga.

Si necesita un volcado de elementos individuales en la lista, debe establecer el nivel de contexto de volcado en 1 o posterior.

Algunas funciones miembro de las funciones globales de esta de la clase auxiliar de llamada que se deben personalizar para la mayoría de utilizan la clase de CList .Vea aplicaciones auxiliares de la clase de colección en la sección “las macros y Globals”.

Para obtener más información sobre cómo utilizar CList, vea el artículo colecciones.

Ejemplo

// CList is a template class that takes two template arguments.
// The first argument is type stored internally by the list, the
// second argument is the type used in the arguments for the
// CList methods.

// This code defines a list of ints.
CList<int,int> myIntList;

// This code defines a list of CStrings
CList<CString,CString&> myStringList;

// This code defines a list of MYTYPEs,
// NOTE: MYTYPE could be any struct, class or type definition
CList<MYTYPE,MYTYPE&> myTypeList;