Share via


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

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* );

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

See Also

Reference

CObArray Class

Hierarchy Chart

CObArray::SetAt

CObArray::SetAtGrow

CObArray::InsertAt

CObArray::operator [ ]