CObArray::SetSize

建立空白的或現有的陣列大小,必要時,配置記憶體。

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

參數

  • nNewSize
    新的陣列大小 (項目數目)。必須大於或等於 0。

  • nGrowBy
    項目位置的最小數目,如果配置的大小增加是必要的。

備註

如果新的大小小於舊的大小,則會截斷此陣列,並釋放所有未使用的記憶體。為了提高效率,請呼叫 SetSize 在使用之前設定這個陣列的大小。在每次項目加入,如此可避免需要重新配置和複製陣列。

當陣列增加時, nGrowBy 參數會影響內部記憶體配置。其使用絕對不會影響陣列大小為所報告。 GetSizeGetUpperBound

如果陣列的大小變大,所有新配置的 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 類別

階層架構圖