CArray::InsertAt

[アーティクル]
02/21/2013

InsertAt の一つ目のバージョンは、配列の指定したインデックスに 1 個の要素 (または要素の複数のコピー) を挿入します。

void InsertAt(
   INT_PTR nIndex,
   ARG_TYPE newElement,
   INT_PTR nCount = 1 
);
void InsertAt(
   INT_PTR nStartIndex,
   CArray* pNewArray 
);

パラメーター

nIndex
可能性がある値より大きい整数のインデックスは GetUpperBoundによって返される。
ARG_TYPE
これで要素の型を指定するテンプレートパラメーター配列。
newElement
この配列に設定する要素。
nCount
この要素を挿入する必要がある回数 (1) への既定値です。
nStartIndex
可能性がある値より大きい整数のインデックスは GetUpperBoundによって返される。
pNewArray
この配列に追加する要素を含む別の配列。

解説

プロセスでは、(インデックスを大きくして) 既存の要素の上でインデックスで移動し、上位のすべての要素の上に移動します。

2 番目のバージョンは nStartIndex の位置から開始して CArray の別のコレクションからすべての要素を挿入します。

SetAt 関数は、これに対し、1 を指定し、配列要素を再配置しません要素を置き換えます。

使用例

// example for CArray::InsertAt

CArray<CPoint,CPoint> ptArray;

ptArray.Add(CPoint(10,20));   // Element 0
ptArray.Add(CPoint(30,40));   // Element 1 (will become element 2)
ptArray.InsertAt(1, CPoint(50,60));   // New element 1

必要条件

ヘッダー: afxtempl.h

参照

関連項目

CArray クラス

CArray::GetUpperBound

CArray::RemoveAt