CObArray Class

Artículo
06/10/2015

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.