CObArray::Add

项目
03/01/2013

添加新元素。数组的末尾，增长数组由1。

INT_PTR Add(
   CObject* newElement 
);

参数

newElement
要添加的 CObject 指针到此数组。

返回值

添加了元素的索引。

备注

如果 SetSize 使用了显着 nGrowBy 值大于1，则可以分配额外的内存。但是，这个上限只将增加1。

下表显示类似于 CObArray::Add的其他成员函数。

类	成员函数
CByteArray	INT_PTR Add( BYTE newElement); *引发异常(CMemoryException);**
CDWordArray	INT_PTR Add( DWORD newElement ); *引发异常(CMemoryException);**
CPtrArray	INT_PTR Add( void* newElement ); *引发异常(CMemoryException);**
CStringArray	INT_PTR Add( LPCTSTR newElement ); *引发异常(CMemoryException); INT_PTR Add(const CString&** newElement);
CUIntArray	INT_PTR Add( UINT newElement ); *引发异常(CMemoryException);**
CWordArray	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