CArray::SetSize

privatevoid SetSize ( int nNewSize, int nGrowBy = -1 );
lançar ( CMemoryException );

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 de elemento para alocar se um aumento de tamanho é necessário.

Observações

Estabelece o tamanho de um vazio ou matriz existente; Aloca memória se necessário.

Se o novo tamanho for menor que o tamanho do antigo, em seguida, a matriz é truncada e toda a memória não utilizada é lançada.

Use esta função para definir o tamanho de sua matriz antes de você começar a usar a matriz. Se você não usar SetSize, adicionar elementos para sua matriz faz com que seja ser realocado com freqüência e copiados. Realocação freqüente e copiar são ineficientes e podem fragmentação de memória.

O parâmetro nGrowBy afeta a alocação de memória internos enquanto a matriz está crescendo. Seu uso nunca afeta o tamanho de matriz conforme relatado pelo GetSize e GetUpperBound. Se o valor padrão é usado, MFC aloca memória de forma calculada para evitar a fragmentação da memória e otimize a eficiência na maioria dos casos.

Visão geral de CArrayMembros de classe | Gráfico de hierarquia

Co&nsulte tambémnbsp;CArray::GetUpperBound, CArray::GetSize

Index