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 |
|---|---|
void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); generare( CMemoryException* ); |
|
void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); generare( CMemoryException* ); |
|
void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); generare( CMemoryException* ); |
|
void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); generare( CMemoryException* ); |
|
void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); generare( CMemoryException* ); |
|
void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); generare( CMemoryException* ); |
Esempio
Vedere l'esempio relativo CObArray::GetData.
Requisiti
Header: afxcoll.h