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 類別

階層架構圖