CObArray::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.Para maior eficiência, ligue para SetSize Para conjunto o dimensionar da matriz antes de usá-lo. Isso evita a necessidade de realocar e copiar a matriz sempre que um item for adicionado.

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 e GetUpperBound.

Se o dimensionar da matriz cresceu, todos os recém-alocado CObject * ponteiros são definidos como nulo.

A tabela a seguir mostra outras funções de membro semelhantes a CObArray::SetSize.

Classe

Função de membro

CByteArray

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

    Lançar (CMemoryException *);

CDWordArray

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

    Lançar (CMemoryException *);

CPtrArray

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

    Lançar (CMemoryException *);

CStringArray

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

    Lançar (CMemoryException *);

CUIntArray

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

    Lançar (CMemoryException *);

CWordArray

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

    Lançar (CMemoryException *);

Exemplo

Consulte o exemplo para CObArray::GetData.

Requisitos

Cabeçalho: afxcoll.h

Consulte também

Referência

Classe CObArray

Gráfico de hierarquia

Outros recursos

CObArray membros