CObArray::Add

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

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

INT_PTR Add(
   CObject* newElement 
);

パラメーター

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

戻り値

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

解説

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

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

Class	メンバー関数
CByteArray	INT_PTR Add( BYTE newElement ); *throw( CMemoryException );**
CDWordArray	INT_PTR Add( DWORD newElement ); *throw( CMemoryException );**
CPtrArray	INT_PTR Add( void* newElement ); *throw( CMemoryException );**
CStringArray	INT_PTR Add( LPCTSTR newElement ); *throw( CMemoryException ); INT_PTR Add(const CString&** newElement);
CUIntArray	INT_PTR Add( UINT newElement ); *throw( CMemoryException );**
CWordArray	INT_PTR Add( WORD newElement ); *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