CAtlArray::SetCount
更新 : 2007 年 11 月
配列オブジェクトのサイズを設定します。
bool SetCount(
size_t nNewSize,
int nGrowBy = - 1
);
パラメータ
nNewSize
設定する配列のサイズ。nGrowBy
作成するバッファのサイズを決定するために使用する値。この値に -1 を指定すると、内部的に計算される値が使用されます。
戻り値
配列のサイズが正常に変更された場合は true、それ以外の場合は false を返します。
解説
配列のサイズは変更できます。サイズを大きくすると、空の要素が配列に追加されます。サイズを小さくすると、最大インデックスの要素が削除され、メモリが解放されます。
配列を使用する前に、このメソッドを呼び出して配列のサイズを設定します。SetCount を使用しない場合、要素の追加プロセスとそれに続いて実行されるメモリ割り当てにより、パフォーマンスが低下し、メモリの断片化が発生します。
使用例
「CAtlArray::GetData」の例を参照してください。
必要条件
ヘッダー : atlcoll.h