CObArray::SetSize

Article
03/04/2013

Génère la taille d'un tableau vide ou existante ; alloue de la mémoire si nécessaire.

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

Paramètres

nNewSize
La nouvelle taille du tableau (nombre d'éléments).Doit être supérieure ou égale à 0.
nGrowBy
Le nombre minimal de emplacements d'élément à allouer si une augmentation de la taille est nécessaire.

Notes

Si la nouvelle taille est inférieure à la taille ancienne, le tableau est tronquée et toute la mémoire non utilisée est libérée.Pour des raisons d'efficacité, appelez SetSize pour définir la taille du tableau avant de l'utiliser.Cela empêché la nécessité de réaffecter et copier le tableau chaque fois qu'un élément est ajouté.

Le paramètre d' nGrowBy affecte l'allocation de mémoire interne pendant que le tableau augmente.Son utilisation n'affecte jamais la taille du tableau telles qu'enregistrées par GetSize et GetUpperBound.

Si la taille du tableau est développée, tous les pointeurs nouvellement alloué de CObject * sont définis avec la valeur NULL.

Le tableau suivant indique les autres fonctions membres similaires à CObArray::SetSize.

Classe	Fonction membre
CByteArray	void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); *jet (CMemoryException) ;**
CDWordArray	void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); *jet (CMemoryException) ;**
CPtrArray	void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); *jet (CMemoryException) ;**
CStringArray	void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); *jet (CMemoryException) ;**
CUIntArray	void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); *jet (CMemoryException) ;**
CWordArray	void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); *jet (CMemoryException) ;**

Exemple

Consultez l'exemple pour CObArray::GetData.

Configuration requise

Header: afxcoll.h

Voir aussi

Référence

Classe de CObArray

Graphique de la hiérarchie

Share via