Partilhar via


CArray::SetSize

Estabelece o tamanho de uma matriz vazia ou existente; aloca memória se necessário.

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

Parâmetros

  • nNewSize
    O novo tamanho da matriz (número de elementos).Deve ser maior ou igual a 0.

  • nGrowBy
    O número mínimo de slots do elemento para atribuir se um aumento de tamanho é necessário.

Comentários

Se o novo tamanho é menor do que o tamanho antigo, então a matriz será truncada e qualquer memória é liberada não usado.

Use esta função para definir o tamanho da matriz antes de começar a usar a matriz.Se você não usar SetSize, adicione os elementos a sua matriz freqüentemente faz com que ele manipule a ser realocada e copiado.A realocação freqüentes e copiar e são não podem fragmentar a memória.

O parâmetro de nGrowBy afeta a alocação de memória quando a matriz interna crescer.Seu uso não afeta o tamanho da matriz como relatado por GetSize e por GetUpperBound.Se o valor padrão é usado, o MFC aloca memória em uma maneira calculada para evitar a fragmentação de memória e otimizar a eficiência para a maioria dos casos.

Exemplo

Consulte o exemplo para GetData.

Requisitos

Cabeçalho: afxtempl.h

Consulte também

Referência

Classe de CArray

Gráfico de hierarquia

CArray::GetUpperBound

CArray::GetSize

CArray::GetCount