CArray::SetSize

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

Paramètres

nNewSize

La nouvelle taille du tableau (nombre d'éléments). Doit être supérieur ou égal à 0.

nGrowBy

Le nombre minimal d'emplacements de l'élément d'allouer si une augmentation de la taille est nécessaire.

Remarques

Établit la taille d'un tableau vide ou existante ; alloue de la mémoire si nécessaire.

Si la nouvelle taille est plus petite que la taille ancienne, puis le tableau est tronqué et toute la mémoire inutilisée est sortie.

Utilisez cette fonction pour définir la taille de votre tableau avant de commencer à l'aide du tableau. Si vous n'utilisez pas SetSize, ajout d'éléments à votre tableau provoque souvent réaffectés et copié. Fréquente réallocation et copie sont inefficaces et peuvent fragmenter la mémoire.

Le paramètre nGrowBy affecte l'allocation de mémoire interne, tandis que le tableau est en croissance. Son utilisation a jamais affecte la taille de tableau, tel que rapporté par GetSize et GetUpperBound. Si la valeur par défaut est utilisée, MFC alloue la mémoire d'une manière calculée pour éviter la fragmentation de la mémoire et optimiser l'efficacité de la plupart des cas.

Aperçu de CArray |  ; Membres de la classe | Graphique de la hiérarchie

Voir aussi  ;CArray::GetUpperBound, CArray::GetSize

Index