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 |
|---|---|
void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); throw (CMemoryException*); |
|
void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); throw (CMemoryException*); |
|
void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); throw (CMemoryException*); |
|
void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); throw (CMemoryException*); |
|
void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); throw (CMemoryException*); |
|
void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); throw (CMemoryException*); |
Ejemplo
Vea el ejemplo para CObArray::GetData.
Requisitos
encabezado: afxcoll.h