CArray::SetSize

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

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

Parâmetros

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

  • nGrowBy
    O número mínimo de slots de elemento para alocar se for necessário um aumento de dimensionar.

Comentários

Se o novo dimensionar for menor que o dimensionar do antigo, em seguida, a matriz será truncada e toda a memória não utilizada será liberada.

Use esta função para conjunto o dimensionar de seu array antes de começar a usar a matriz.Se você não usar SetSize, adicionando elementos ao seu conjunto faz com que ela ser realocados com freqüência e copiado. Realocação freqüente e copiar são ineficientes e podem fragmentar memória.

The nGrowBy parâmetro afeta a alocação de memória interno enquanto o array está crescendo. Seu uso nunca afeta o dimensionar da matriz conforme relatado por GetSize and GetUpperBound.Se o valor padrão é usado, o MFC aloca memória de maneira calculada para evitar a fragmentação de memória e otimize 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 CArray

Gráfico de hierarquia

CArray::GetUpperBound

CArray::GetSize

Outros recursos

CArray membros