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

ОГЛАВЛЕНИЕ


Add

int Add(ARG_TYPE newElement); throw(CMemoryException);

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

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

Аргументы

  • ARG_TYPE - параметр шаблона, определяющий тип аргументов, используемых для ссылки на элементы массива.
  • newElement - элемент, добавляемый в массив.

Описание

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