Método CHStringArray::SetSize (chstrarr.h)

[A classe CHStringArray faz parte do WMI Provider Framework que agora é considerado em estado final e nenhum desenvolvimento, melhoria ou atualização adicional será disponibilizada para problemas não relacionados à segurança que afetarem essas bibliotecas. As APIs de MI devem ser usadas para todos os novos desenvolvimentos.]

O método SetSize estabelece o tamanho de uma matriz vazia ou existente.

Sintaxe

void  throw(CHeap_Exception) SetSize(
  int nNewSize,
  int nGrowBy
);

Parâmetros

nNewSize

O novo tamanho da matriz (número de elementos). O valor deve ser maior ou igual a 0 (zero).

nGrowBy

O número mínimo de slots de elemento a serem alocados se um aumento de tamanho for necessário.

Retornar valor

Esse método não retorna um valor.

Comentários

O método SetSize aloca memória, se necessário. Se o novo tamanho for menor que o tamanho antigo, a matriz será truncada e toda a memória não utilizado será liberada. Para obter eficiência, chame SetSize para definir o tamanho da matriz antes de usá-la. Isso impede a necessidade de realocar e copiar a matriz sempre que um item é adicionado.

O parâmetro nGrowBy afeta a alocação de memória interna enquanto a matriz está crescendo. Seu uso nunca afeta o tamanho da matriz conforme relatado por GetSize e GetUpperBound.

Exemplos

Consulte o exemplo de CHStringArray::GetData.

Requisitos

Confira também

CHStringArray

CHStringArray::GetData

CHStringArray::GetSize

CHStringArray::GetUpperBound