CAtlArray::InsertAt

  • [アーティクル]

更新 : 2007 年 11 月

新しい要素 (または要素の複数のコピー) を配列オブジェクトに挿入します。

void InsertAt(
   size_t iElement,
   INARGTYPE element,
   size_t nCount = 1 
);

パラメータ

  • iElement
    要素を挿入する位置のインデックス。

  • element
    挿入する要素の値。

  • nCount
    追加する要素の数。

解説

インデックス iElement の位置から 1 つ以上の要素を配列に挿入します。既存の要素は、上書きされないように別の位置に移動します。

デバッグ ビルドでは、CAtlArray オブジェクトが無効な場合、追加する要素の数が 0 の場合、または要素の合計数が大きすぎて配列に収まらない場合、ATLASSERT が出力されます。製品版ビルドでは、無効なパラメータが渡された場合、予期しない結果になることがあります。

使用例

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

// Add elements to the array
for (int b = 0; b < 10; b++)
{
   iBuffer.Add(0);
}

// Instert ten 1's into the array
// at position 5
iBuffer.InsertAt(5, 1, 10);

必要条件

ヘッダー : atlcoll.h

参照

参照

CAtlArray クラス

CAtlArray::Add

その他の技術情報

CAtlArray メンバ