CObArray::Add

添加新元素。数组的末尾,增长数组由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

要求

Header: afxcoll.h

请参见

参考

CObArray选件类

层次结构图

CObArray::SetAt

CObArray::SetAtGrow

CObArray::InsertAt

CObArray::operator [ ]