CObArray::Add

Статья
02/20/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);**

Пример

См. перечисление CObList::CObList для класса CAge, используемого во всех примерах коллекции.

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