CObArray::Add

Artikel
02/26/2013

Fügt ein neues Element am Ende eines Arrays hinzu und nimmt das Array von 1.

INT_PTR Add(
   CObject* newElement 
);

Parameter

newElement
Der zu diesem Array hinzugefügt werden CObject Zeiger.

Rückgabewert

Der Index des hinzugefügten Elements.

Hinweise

Wenn SetSize mit einem nGrowBy-Wert verwendet wurde, der größer als 1 ist, dann wird zusätzlicher Arbeitsspeicher zugeordnet werden.verwendet jedoch die Obergrenze um nur 1. zu.

In der folgenden Tabelle werden andere Memberfunktionen auf, die mit CObArray::Add ähneln.

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

Beispiel

Siehe CObList::CObList für Listen der CAge-Klasse, die in allen Auflistungsbeispielen verwendet wird.

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

Die Ergebnisse dieses Programms sind, wie folgt:

Add example: A CObArray with 2 elements

[0] = a CAge at $442A 21

[1] = a CAge at $4468 40