CObArray::Add
1.で配列の拡張配列の末尾に新しい要素を追加します。
INT_PTR Add(
CObject* newElement
);
パラメーター
- newElement
この配列に追加する CObject のポインター。
戻り値
追加された要素のインデックス。
解説
SetSize が大きい nGrowBy の値が 1 より使用される場合は、別個のメモリが割り当てられた場合があります。ただし、上限は 1.だけインクリメントされます。
次の表は CObArray::Addに似ている他のメンバー関数を示します。
Class |
メンバー関数 |
|---|---|
INT_PTR Add( BYTE newElement) ; スローします (CMemoryException*) ; |
|
INT_PTR Add( DWORD newElement) ; スローします (CMemoryException*) ; |
|
INT_PTR Add( void* newElement) ; スローします (CMemoryException*) ; |
|
INT_PTR Add( LPCTSTR newElement) ;スローします (CMemoryException*) ; INT_PTR Add(const CString& newElement) ; |
|
INT_PTR Add( UINT newElement) ; スローします (CMemoryException*) ; |
|
INT_PTR Add( WORD newElement) ; スローします (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
必要条件
Header: afxcoll.h