CAtlArray::Append
更新 : 2007 年 11 月
配列の内容を別の配列の末尾に追加します。
size_t Append(
const CAtlArray< E, ETraits >& aSrc
);
パラメータ
- aSrc
追加する配列。
戻り値
追加した要素のうち 1 番目の要素のインデックスを返します。
解説
指定した配列の要素を既存の配列の末尾に追加します。必要に応じて、新しい要素のためにメモリが割り当てられます。
配列は同じ型の配列に追加される必要があります。また、配列をそれ自身に追加することはできません。
デバッグ ビルドでは、引数 CAtlArray が有効な配列でない場合、または aSrc が同じオブジェクトを参照している場合、ATLASSERT が出力されます。リリース ビルドでは、無効な引数によって、予期しない動作が引き起こされることがあります。
使用例
// Declare two integer arrays
CAtlArray<int> iArray1,iArray2;
iArray1.Add(1); // element 0
iArray1.Add(2); // element 1
iArray2.Add(3); // element 0
iArray2.Add(4); // element 1
// Append iArray2 to iArray1
iArray1.Append(iArray2);
ATLASSERT(iArray1.GetCount() == 4);
必要条件
ヘッダー : atlcoll.h