CObArray::SetSize

Статья
02/20/2013

Задает размер пустого или существующего массива; выделяет память, если требуемый.

void SetSize(
   INT_PTR nNewSize,
   INT_PTR nGrowBy = -1 
);

Параметры

nNewSize
Новый размер массива (количество элементов).Должна быть не ниже 0.
nGrowBy
Минимальное число слотов элемента, который необходимо выбрать, если увеличение размера требуется.

Заметки

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

Параметр nGrowBy влияет на внутреннее выделение памяти, в то время как массив.Его использование не влияет на размер массива, как отмечено GetSize и GetUpperBound.

Если размер массива увеличивается, то все вновь выделенные указатели CObject * устанавливаются в значение NULL.

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

Класс	Функция-член
CByteArray	void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); *выполнение (CMemoryException);**
CDWordArray	void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); *выполнение (CMemoryException);**
CPtrArray	void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); *выполнение (CMemoryException);**
CStringArray	void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); *выполнение (CMemoryException);**
CUIntArray	void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); *выполнение (CMemoryException);**
CWordArray	void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); *выполнение (CMemoryException);**

Пример

См. пример для CObArray::GetData.

Требования

Header: afxcoll.h

См. также

Ссылки

Класс CObArray

Диаграмма иерархии

Поделиться через