Visual C++. Описание стандартных классов - Add

ОГЛАВЛЕНИЕ


Add

int Add(CObject* newElement); throw(CMemoryException);

Возвращаемое значение

Индекс добавленного в массив элемента.

Аргументы

  • newElement - указатель на объект класса CObject, добавляемый в массив.

Описание

Добавляет новый элемент в конец массива, увеличивая его размер на 1. Если в функции SetSize аргумент nGrowBy имеет значение больше 1 и увеличение размера массива на 1 привело к выходу за пределы отведенной ему памяти, то для массива выделяется дополнительная память, в которую могут быть записаны новые элементы без новой операции выделения памяти, размер которой определяется аргументом nGrowBy функции SetSize. Соответствующие функции, отличающиеся только типом своих аргументов, имеются в классах CByteArray, CDWordArray, CPtrArray, CStringArray, CUIntArray и CWordArray.