Compartir a través de


CObArray Class

admite las matrices de los punteros de CObject .

class CObArray : public CObject

Miembros

Constructores públicos

Name

Descripción

CObArray::CObArray

Crea una matriz vacía para punteros de CObject .

Métodos públicos

Name

Descripción

CObArray::Add

Agrega un elemento al final de la matriz; aumenta la matriz en caso necesario.

CObArray::Append

Anexa otra matriz a la matriz; aumenta la matriz en caso necesario.

CObArray::Copy

Copia otra matriz a la matriz; aumenta la matriz en caso necesario.

CObArray::ElementAt

Devuelve una referencia temporal a puntero de elemento dentro de la matriz.

CObArray::FreeExtra

Libera toda la memoria no utilizada sobre el límite superior actual.

CObArray::GetAt

Devuelve el valor en el índice especificado.

CObArray::GetCount

Obtiene el número de elementos en esta matriz.

CObArray::GetData

Permite el acceso a los elementos de la matriz. puede ser NULL.

CObArray::GetSize

Obtiene el número de elementos en esta matriz.

CObArray::GetUpperBound

Devuelve el índice válido mayor.

CObArray::InsertAt

Inserta un elemento (o todos los elementos en otra matriz) en el índice especificado.

CObArray::IsEmpty

Determina si la matriz está vacía.

CObArray::RemoveAll

Quita todos los elementos de esta matriz.

CObArray::RemoveAt

quita un elemento en un índice específico.

CObArray::SetAt

Establece el valor en el índice especificado; matriz no permitido crecer.

CObArray::SetAtGrow

Establece el valor en el índice especificado; aumenta la matriz en caso necesario.

CObArray::SetSize

Establece el número de elementos que se contendrán en esta matriz.

Operadores públicos

Name

Descripción

CObArray::operator [ ]

Establece u obtiene el elemento en el índice especificado.

Comentarios

Estas matrices de objetos son similares a las matrices de C, pero pueden reducir y crecer dinámicamente según sea necesario.

Los índices de matriz siempre empiezan en la posición 0. Puede decidir si corregir el límite superior o permitir que la matriz expanda cuando agregue elementos más allá de la actual enlazada. La memoria se asigna uno junto al límite superior, aunque algunos elementos es null.

En Win32, el tamaño de un objeto de CObArray está restringida sólo a la memoria disponible.

Como con la matriz de C/C++., tiempo de acceso para un elemento indizado CObArray es constante y es independiente del tamaño de la matriz.

CObArray escribe la macro de IMPLEMENT_SERIAL para admitir la serialización y volcar de sus elementos. Si una matriz de punteros de CObject se almacena en un archivo, con el operador sobrecargado de inserción o con la función miembro de Serialize , cada elemento de CObject , a su vez, se serializa junto con su índice de matriz.

Si necesita un volcado de memoria de los elementos individuales de CObject en una matriz, debe establecer la profundidad del objeto de CDumpContext en 1 o posterior.

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

Nota

Antes de utilizar una matriz, utilice SetSize para establecer su tamaño y para asignar memoria para ella.Si no utiliza SetSize, agregar elementos a la matriz hace con frecuencia que se reasignara y copiar.La reasignación frecuente y la copia son ineficaces y pueden fragmentar la memoria.

Derivación de la clase array es similar a la derivación de lista. Para obtener detalles sobre la derivación de una clase especial de la lista, vea el artículo colecciones.

Nota

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

Jerarquía de herencia

CObject

CObArray

Requisitos

encabezado: afxcoll.h

Vea también

Referencia

CObject Class

Gráfico de jerarquías

CStringArray Class

CPtrArray Class

CByteArray (Clase)

CWordArray Class

CDWordArray (Clase)