CAtlArray::InsertArrayAt

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

配列を別の配列に挿入します。

void InsertArrayAt(
   size_t iStart,
   const CAtlArray< E, ETraits >* paNew 
);

パラメータ

iStart
配列を挿入するインデックス。
paNew
挿入する配列。

解説

配列 paNew の要素が、要素 iStart の位置を先頭に配列オブジェクトにコピーされます。既存の配列要素は、上書きされないように別の位置に移動します。

デバッグビルドでは、CAtlArray オブジェクトが無効な場合、または paNew ポインタが NULL や無効な場合、ATLASSERT が出力されます。

メモ :
CAtlArray::InsertArrayAt は、CAutoPtr クラスを使用して作成した要素の配列をサポートしていません。

使用例

// Define two integer arrays
CAtlArray<int> iTargetArray, iSourceArray;

// Add elements to first array
for (int x = 0; x < 10; x++)
{
   iTargetArray.Add(x);
}

// Add elements to the second array
for (int x = 0; x < 10; x++)
{
   iSourceArray.Add(x * 10);
}

// Insert the Source array into the Target
// array, starting at the 5th element.
iTargetArray.InsertArrayAt(5, &iSourceArray);