CObArray::SetSize

Imposta la dimensione di una matrice vuota o esistente, alloca memoria se necessario.

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

Parametri

  • nNewSize
    La nuova dimensione della matrice (numero di elementi).Versione 0 o successive.

  • nGrowBy
    Il numero minimo di slot dell'elemento da allocare se un aumento delle dimensioni è necessario.

Note

Se la nuova dimensione è minore della dimensione precedente, la matrice sarà troncata e tutta la memoria inutilizzata viene rilasciata.Per maggiore efficienza, chiamare SetSize per impostare la dimensione della matrice tramite.In questo modo si evita di dover ridistribuire e copiare la matrice quando si aggiunge un elemento.

Il parametro nGrowBy influisce sull'allocazione di memoria interna durante la matrice sta crescendo.Il relativo utilizzo non influisce su mai la dimensione della matrice come indicato da GetSize e da GetUpperBound.

Se la dimensione della matrice è compilata, tutti i puntatori appena allocati CObject * sono impostati SU NULL.

Nella tabella seguente vengono illustrate altre funzioni membro che sono simili a CObArray::SetSize.

Classe

Funzione membro

CByteArray

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

    generare( CMemoryException* );

CDWordArray

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

    generare( CMemoryException* );

CPtrArray

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

    generare( CMemoryException* );

CStringArray

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

    generare( CMemoryException* );

CUIntArray

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

    generare( CMemoryException* );

CWordArray

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

    generare( CMemoryException* );

Esempio

Vedere l'esempio relativo CObArray::GetData.

Requisiti

Header: afxcoll.h

Vedere anche

Riferimenti

Classe di CObArray

Grafico della gerarchia