CObArray::SetAt

Статья
02/20/2013

Задает элемент массива по указанному индексу.

void SetAt(
   INT_PTR nIndex,
   CObject* newElement 
);

Параметры

nIndex
Индекс целое число, которое больше или равно 0 и меньше или равно значению, возвращенному GetUpperBound.
newElement
Указатель объекта, который необходимо вставить в этот массив.Значение NULL разрешено.

Заметки

Массив SetAt не приведет к увеличению.Используйте SetAtGrow если требуется массив увеличиваться автоматически.

Необходимо убедиться, что значение индекса, представляющее допустимой позиции в массиве.Если из границ, отладочная версия библиотеки assert.

В следующей таблице приведены другие функции-члены, которые похожи на CObArray::SetAt.

Класс	Функция-член
CByteArray	void SetAt( INT_PTRnIndex, BYTE newElement );
CDWordArray	void SetAt( INT_PTRnIndex, DWORD newElement );
CPtrArray	void SetAt( INT_PTRnIndex, void* newElement );
CStringArray	void SetAt( INT_PTRnIndex, LPCTSTR newElement );
CUIntArray	void SetAt( INT_PTRnIndex, UINT newElement );
CWordArray	void SetAt( INT_PTRnIndex, WORD newElement );

Пример

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

CObArray arr;
CObject* pa;

arr.Add(new CAge(21)); // Element 0
arr.Add(new CAge(40)); // Element 1
if ((pa = arr.GetAt(0)) != NULL)
{
   arr.SetAt(0, new CAge(30));  // Replace element 0.
   delete pa; // Delete the original element at 0.
}
#ifdef _DEBUG
   afxDump.SetDepth(1);
   afxDump << _T("SetAt example: ") << &arr << _T("\n");
#endif

Результаты из этой программы следующим образом:

SetAt example: A CObArray with 2 elements

[0] = a CAge at $47E0 30

[1] = a CAge at $47A0 40