CObArray::Add

發行項
02/28/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