void SetSize( int nNewSize, int nGrowBy = -1 );
throw( CMemoryException );
Parameters
nNewSize
The new array size (number of elements). Must be greater than or equal to 0.
nGrowBy
The minimum number of element slots to allocate if a size increase is necessary.
Remarks
Establishes the size of an empty or existing array; allocates memory if necessary. If the new size is smaller than the old size, then the array is truncated and all unused memory is released. For efficiency, call SetSize to set the size of the array before using it. This prevents the need to reallocate and copy the array each time an item is added.
The nGrowBy parameter affects internal memory allocation while the array is growing. Its use never affects the array size as reported by GetSize and GetUpperBound.
The following table shows other member functions that are similar to CObArray::SetSize.
| Class | Member Function |
| CByteArray | void SetSize( int nNewSize, int nGrowBy = -1 ); throw( CMemoryException ); |
| CDWordArray | void SetSize( int nNewSize, int nGrowBy = -1 ); throw( CMemoryException ); |
| CPtrArray | void SetSize( int nNewSize, int nGrowBy = -1 ); throw( CMemoryException ); |
| CStringArray | void SetSize( int nNewSize, int nGrowBy = -1 ); throw( CMemoryException ); |
| CUIntArray | void SetSize( int nNewSize, int nGrowBy = -1 ); throw( CMemoryException ); |
| CWordArray | void SetSize( int nNewSize, int nGrowBy = -1 ); throw( CMemoryException ); |
Example
See the example for CObArray::GetData.