CObArray::Append

[アーティクル]
08/09/2011

指定されている配列の最後に別の配列の内容を追加します。

INT_PTR Append(
   const CObArray& src 
);

パラメーター

src
配列へ追加されるコピー元の要素。

戻り値

追加した最初の要素のインデックスを返します。

解説

2 つの配列は同じ型にする必要があります。

必要に応じて、Append は配列に追加された要素数に応じてメモリを増加して割り当てます。

CObArray::Append に類似している他のメンバー関数を以下に示します。

Class	メンバー関数
CByteArray	INT_PTR Append( const CByteArray& src );
CDWordArray	INT_PTR Append( const CDWordArray& src );
CPtrArray	INT_PTR Append( const CPtrArray& src );
CStringArray	INT_PTR Append( const CStringArray& src );
CUIntArray	INT_PTR Append( const CUIntArray& src );
CWordArray	INT_PTR Append( const CWordArray& src );

使用例

すべてのコレクションの例で使われている CAge クラスのリストについては、CObList::CObList を参照してください。

CObArray myArray1, myArray2;

// Add elements to the second array.
myArray2.Add(new CAge(21));
myArray2.Add(new CAge(42));

// Add elements to the first array and also append the second array.
myArray1.Add(new CAge(3));
myArray1.Append(myArray2);

#ifdef _DEBUG
   afxDump.SetDepth(1);
   afxDump << _T("myArray1: ") << &myArray1 << _T("\n");
   afxDump << _T("myArray2: ") << &myArray2 << _T("\n");
#endif