次の方法で共有


CObArray::SetSize

空の配列または要素を持つ配列のサイズを設定します。必要に応じてメモリを割り当てます。

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

パラメーター

  • nNewSize
    新しい配列のサイズ (要素数) を指定します。0 以上であることが必要です。

  • nGrowBy
    サイズを増やす必要があるときに、確保する要素スロットの最小数を指定します。

解説

新しいサイズが古いサイズよりも小さい場合、配列は切り捨てられ、すべての未使用のメモリが解放されます。効率には、クエリを使用する前に配列のサイズを設定するに SetSize を呼び出します。これは、項目が追加されるたびに配列を再割り当てし、コピーする必要がなくなります。

パラメーター nGrowBy は、配列を拡張するときの内部メモリの割り当てに影響します。その使用は GetSizeGetUpperBoundによって報告されるように返される配列のサイズには影響しません。

配列のサイズが育ったら、CObject * のすべての新しく割り当てられたポインターが NULL に設定されます。

次の表は CObArray::SetSizeに似ている他のメンバー関数を示します。

Class

メンバー関数

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 クラス

階層図