CObArray::SetSize

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

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

パラメーター

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

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

配列のサイズが育ったら、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) ;**