CObArray::SetSize

建立一个空或现有数组的大小;如果需要，分配内存。

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

参数

• nNewSize
  新的数组大小(元素的数字）。 必须高于或等于 0。

• nGrowBy
  元素槽的最小值分配的，如果范围增量是必需的。

备注

如果新大小小于旧范围，则该数组将被截断，并且会释放所有未使用的内存。 为提高效率，请调用 SetSize 在使用之前设置数组大小。 每次项目添加，这样可防止需要分配和复制数组。

当数组增加时，nGrowBy 参数影响内部内存分配。 它使用不影响数组大小如报告 GetSize 和 GetUpperBound。

如果数组的大小增大，所有新分配的 CObject * 指针设置为NULL。

下表显示类似于 CObArray::SetSize的其他成员函数。

类	成员函数
CByteArray	void SetSize( INT_PTR nNewSize, int nGrowBy = -1 );     引发异常(CMemoryException*);
CDWordArray	void SetSize( INT_PTR nNewSize, int nGrowBy = -1 );     引发异常(CMemoryException*);
CPtrArray	void SetSize( INT_PTR nNewSize, int nGrowBy = -1 );     引发异常(CMemoryException*);
CStringArray	void SetSize( INT_PTR nNewSize, int nGrowBy = -1 );     引发异常(CMemoryException*);
CUIntArray	void SetSize( INT_PTR nNewSize, int nGrowBy = -1 );     引发异常(CMemoryException*);
CWordArray	void SetSize( INT_PTR nNewSize, int nGrowBy = -1 );     引发异常(CMemoryException*);

示例

为 CObArray::GetData参见示例。

要求

Header: afxcoll.h

请参见

参考

CObArray选件类

层次结构图