CObArray::Add

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

更新 : 2007 年 11 月

配列の末尾に新規要素を追加し、配列の要素数を 1 つ増加させます。

INT_PTR Add(
   CObject* newElement 
);

パラメータ

newElement
配列に追加する CObject ポインタ。

戻り値

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

解説

nGrowBy の値を 2 以上に設定し SetSize を使用すると、メモリを増やして割り当てることができます。その場合でも、上限の増加は 1 だけです。

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

クラス	メンバ関数
CByteArray	INT_PTR Add( BYTEnewElement ); *throw( CMemoryException );**
CDWordArray	INT_PTR Add( DWORDnewElement ); *throw( CMemoryException );**
CPtrArray	INT_PTR Add( voidnewElement ); throw( CMemoryException );**
CStringArray	INT_PTR Add( LPCTSTRnewElement ); *throw( CMemoryException ); INT_PTR Add(const CString&**newElement);
CUIntArray	INT_PTR Add( UINTnewElement ); *throw( CMemoryException );**
CWordArray	INT_PTR Add( WORDnewElement ); *throw( CMemoryException );**

使用例

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

CObArray arr;

arr.Add(new CAge(21)); // Element 0
arr.Add(new CAge(40)); // Element 1
#ifdef _DEBUG
   afxDump.SetDepth(1);
   afxDump << _T("Add example: ") << &arr << _T("\n");
#endif

このプログラムの実行結果は次のようになります。

Add example: A CObArray with 2 elements

[0] = a CAge at $442A 21

[1] = a CAge at $4468 40