CObArray::SetSize
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 |
|---|---|
void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); jet (CMemoryException*) ; |
|
void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); jet (CMemoryException*) ; |
|
void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); jet (CMemoryException*) ; |
|
void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); jet (CMemoryException*) ; |
|
void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); jet (CMemoryException*) ; |
|
void SetSize( INT_PTR nNewSize, int nGrowBy = -1 ); jet (CMemoryException*) ; |
Exemple
Consultez l'exemple pour CObArray::GetData.
Configuration requise
Header: afxcoll.h