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


CObArray::SetSize

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

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

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