Compartir a través de


CObArray::SetSize

Establece el tamaño de una matriz vacía o existente; asigna memoria en caso necesario.

void SetSize(
   INT_PTR nNewSize,
   INT_PTR nGrowBy = -1 
);

Parámetros

  • nNewSize
    El nuevo tamaño de la matriz (número de elementos).Debe ser mayor o igual que 0.

  • nGrowBy
    El número mínimo de ranuras de elemento se asignan si un aumento del tamaño es necesario.

Comentarios

Si el nuevo tamaño es menor que el tamaño anterior, se trunca la matriz y se libera toda la memoria no utilizada.Para aumentar la eficacia, llame a SetSize para establecer el tamaño de la matriz antes de utilizarla.Esto evita la necesidad de reasignación y de copiar la matriz cada vez que se agrega un elemento.

El parámetro de nGrowBy afecta a la asignación de memoria interna mientras la matriz crece.Su uso nunca afecta al tamaño de la matriz que notifica por GetSize y GetUpperBound.

Si el tamaño de la matriz ha crecido, todos los punteros recién asignados de CObject * se establecen en NULL.

La tabla siguiente se muestran otras funciones miembro que son similares a CObArray::SetSize.

Clase

Función miembro

CByteArray

void SetSize( INT_PTR nNewSize, int nGrowBy = -1 );

    throw (CMemoryException*);

CDWordArray

void SetSize( INT_PTR nNewSize, int nGrowBy = -1 );

    throw (CMemoryException*);

CPtrArray

void SetSize( INT_PTR nNewSize, int nGrowBy = -1 );

    throw (CMemoryException*);

CStringArray

void SetSize( INT_PTR nNewSize, int nGrowBy = -1 );

    throw (CMemoryException*);

CUIntArray

void SetSize( INT_PTR nNewSize, int nGrowBy = -1 );

    throw (CMemoryException*);

CWordArray

void SetSize( INT_PTR nNewSize, int nGrowBy = -1 );

    throw (CMemoryException*);

Ejemplo

Vea el ejemplo para CObArray::GetData.

Requisitos

encabezado: afxcoll.h

Vea también

Referencia

Clase de CObArray

Gráfico de jerarquía