CObArray::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.Para eficiência, chame SetSize para definir o tamanho da matriz antes de usá-lo.Isso evita a necessidade de realocar e copiar a matriz cada vez que um item é adicionado.
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 tamanho da matriz cresceu, todos os ponteiros recentemente atribuído de CObject * são definidas PARA ANULAR.
A tabela a seguir mostra outras funções de membro que são semelhantes a CObArray::SetSize.
Classe |
Função de membro |
|---|---|
void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); throw( CMemoryException* ); |
|
void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); throw( CMemoryException* ); |
|
void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); throw( CMemoryException* ); |
|
void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); throw( CMemoryException* ); |
|
void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); throw( CMemoryException* ); |
|
void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); throw( CMemoryException* ); |
Exemplo
Consulte o exemplo para CObArray::GetData.
Requisitos
Cabeçalho: afxcoll.h