CObList Class

Artículo
06/10/2015

Admite listas ordenadas de punteros nonunique de CObject accesibles secuencialmente o por valor de puntero.

class CObList : public CObject

Miembros

Constructores públicos

Name	Descripción
CObList::CObList	Crea una lista vacía para punteros de CObject .

Métodos públicos

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

Comentarios

las listas deCObList 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.

CObList escribe la macro de IMPLEMENT_SERIAL para admitir la serialización y volcar de sus elementos. Si una lista de punteros de CObject se almacena en un archivo, con un operador sobrecargado de inserción o con la función miembro de Serialize , cada elemento de CObject es serializado a su vez.

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

Cuando se elimina un objeto de CObList , o cuando se quitan los elementos, solo se quitan los punteros de CObject , no objetos que hacen referencia.

Puede derivar dispone de clases de CObList. La nueva clase de lista, diseñada para contener punteros a objetos derivados de CObject, agrega nuevos miembros de datos y el nuevo miembro funciona. Observe que la lista resultante no es seguro estrictamente tipo, porque permite la inserción de cualquier puntero de CObject .

Nota

Debe utilizar la macro de IMPLEMENT_SERIAL en la implementación de la clase derivada si desea serializar la lista.

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