CObArray::Add
Adds a new element to the end of an array, growing the array by 1.
INT_PTR Add(
CObject* newElement
);
Parameters
- newElement
The CObject pointer to be added to this array.
Return Value
The index of the added element.
Remarks
If SetSize has been used with an nGrowBy value greater than 1, then extra memory may be allocated. However, the upper bound will increase by only 1.
The following table shows other member functions that are similar to CObArray::Add.
Class |
Member Function |
|---|---|
INT_PTR Add( BYTE newElement ); throw( CMemoryException* ); |
|
INT_PTR Add( DWORD newElement ); throw( CMemoryException* ); |
|
INT_PTR Add( void* newElement ); throw( CMemoryException* ); |
|
INT_PTR Add( LPCTSTR newElement ); throw( CMemoryException* ); INT_PTR Add(const CString& newElement); |
|
INT_PTR Add( UINT newElement ); throw( CMemoryException* ); |
|
INT_PTR Add( WORD newElement ); throw( CMemoryException* ); |
Example
See CObList::CObList for a listing of the CAge class used in all collection examples.
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
The results from this program are as follows:
Add example: A CObArray with 2 elements
[0] = a CAge at $442A 21
[1] = a CAge at $4468 40
Requirements
Header: afxcoll.h