Clase de CPtrArray

Artículo
03/15/2013

Admite matrices de punteros vacíos.

class CPtrArray : public CObject

Miembros

Las funciones miembro de CPtrArray son similares a las funciones miembro de clases CObArray.Debido a esta similitud, puede utilizar la documentación de referencia de CObArray para las características de la función miembro.Siempre que aparezca un puntero de CObject como un parámetro o valor devuelto de la función, utilice un puntero a void.

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

por ejemplo, convierte a

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

Constructores públicos

Name	Descripción
CObArray::CObArray	Crea una matriz vacía.

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

CPtrArray escribe la macro de IMPLEMENT_DYNAMIC para admitir el acceso de tipo en tiempo de ejecución y volcar a CDumpContext un objeto.Si necesita un volcado de los elementos de matriz individuales de puntero, debe establecer el nivel de contexto de volcado en 1 o posterior.

[!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.

Las matrices de puntero no se pueden serializar.

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

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

Jerarquía de herencia

CObject

CPtrArray

Requisitos

encabezado: afxcoll.h

Vea también

Referencia

Clase de CObject

Gráfico de jerarquía

Clase de CObArray