次の方法で共有


CAtlArray::SetAtGrow

配列を配置する必要に応じて配列オブジェクトの要素の値を設定するには、このメソッドを呼び出します。

void SetAtGrow(
   size_t iElement,
   INARGTYPE element 
);

パラメーター

  • iElement
    セットに配列要素を指すインデックス。

  • element
    指定された要素の新しい値。

解説

インデックスによって指される要素の値を置き換えます。iElement が配列の現在のサイズを超える場合、配列は CAtlArray::SetCountの呼び出しを使用して自動的にインクリメントします。デバッグ ビルドでは、ATLASSERT は CAtlArray のオブジェクトが無効な場合に発生します。リリース ビルドでは、無効なパラメーターにより予測できない結果が生じる可能性があります。

使用例

// Declare an array of integers
CAtlArray<int> iGrowArray;

// Add an element
iGrowArray.Add(0);

// Add an extra element at position 19.
// This will grow the array to accommodate.
iGrowArray.SetAtGrow(19, 0);

// Confirm size of new array
ATLASSERT(iGrowArray.GetCount() == 20);

// Note: the values at position 1 to 18
// are undefined.

必要条件

Header: atlcoll.h

参照

関連項目

CAtlArray クラス

CAtlArray::SetAt