Compartir a través de


CObList Class

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.

Jerarquía de herencia

CObject

CObList

Requisitos

encabezado: afxcoll.h

Vea también

Referencia

CObject Class

Gráfico de jerarquías

CStringList Class

CPtrList Class