Clase CPtrArray

Admite matrices de punteros void.

Sintaxis

class CPtrArray : public CObject

Miembros

Las funciones miembro de CPtrArray son similares a las de la clase CObArray. Debido a esta similitud, puede utilizar la documentación de referencia de CObArray para obtener información específica de la función miembro. Siempre que vea un puntero CObject como un parámetro de función o un valor devuelto, sustituya un puntero a void.

CObject* CObArray::GetAt( int <nIndex> ) const;

por ejemplo, se traduce en

void* CPtrArray::GetAt( int <nIndex> ) const;

Constructores públicos

Nombre	Descripción
CPtrArray::CPtrArray	Construye una matriz vacía.

Métodos públicos

Nombre	Descripción
CPtrArray::Add	Agrega un elemento al final de la matriz; aumenta el tamaño de la matriz si es necesario.
CPtrArray::Append	Anexa otra matriz a la matriz; aumenta el tamaño de la matriz si es necesario.
CPtrArray::Copy	Copia otra matriz a la matriz; aumenta el tamaño de la matriz si es necesario.
CPtrArray::ElementAt	Devuelve una referencia temporal al puntero del elemento dentro de la matriz.
CPtrArray::FreeExtra	Libera toda la memoria no usada por encima del límite superior actual.
CPtrArray::GetAt	Devuelve el valor en un índice dado.
CPtrArray::GetCount	Obtiene el número de elementos de esta matriz.
CPtrArray::GetData	Permite el acceso a los elementos de la matriz. Puede ser NULL.
CPtrArray::GetSize	Obtiene el número de elementos de esta matriz.
CPtrArray::GetUpperBound	Devuelve el índice válido de mayor tamaño.
CPtrArray::InsertAt	Inserta un elemento (o todos los elementos de otra matriz) en un índice especificado.
CPtrArray::IsEmpty	Determina si la matriz está vacía.
CPtrArray::RemoveAll	Quita todos los elementos de esta matriz.
CPtrArray::RemoveAt	Quita un elemento en un índice específico.
CPtrArray::SetAt	Establece el valor de un índice dado; la matriz no puede aumentar de tamaño.
CPtrArray::SetAtGrow	Establece el valor de un índice dado; aumenta el tamaño de la matriz si es necesario.
CPtrArray::SetSize	Establece el número de elementos que contendrá esta matriz.

Operadores públicos

Nombre	Descripción
CPtrArray::operator [ ]	Establece u obtiene el elemento en el índice especificado.

Comentarios

CPtrArray incorpora la macro IMPLEMENT_DYNAMIC para admitir el acceso a tipos en tiempo de ejecución y el volcado en un objeto CDumpContext. Si se necesita un volcado de elementos de matriz de punteros individuales, se debe establecer la profundidad del contexto de volcado en 1 o un valor superior.

Nota:

Antes de usar una matriz, use SetSize para establecer su tamaño y asignarle memoria. Si no usa SetSize, al agregar elementos a la matriz, esta se reasigna y se copia con frecuencia. La reasignación y copia frecuentes son ineficaces y pueden fragmentar la memoria.

Las matrices de punteros no se pueden serializar.

Cuando se elimina una matriz de punteros, o cuando se quitan sus elementos, solo se quitan los punteros, no las entidades a las que hacen referencia.

Para más información sobre cómo usar CPtrArray, consulte el artículo Colecciones.

Jerarquía de herencia

CObject

CPtrArray

Requisitos

Encabezado: afxcoll.h

Consulte también

CObject (clase)
Gráfico de jerarquías
CObArray (clase)