ReDim, instruction

Microsoft VBScript

Microsoft® Visual Basic® Scripting Edition ReDim, instruction  Référence du langage 
Version 1 


Description
Déclare les variables de tableau dynamique et attribue ou réattribue l'espace de stockage au niveau de la procédure.
Syntaxe
ReDim [Preserve] varname(subscripts) [, varname(subscripts)] . . .

La syntaxe de l'argument ReDim comprend les éléments suivants :

Élément Description
Preserve Conserve les données d'un tableau existant quand vous changez la taille de la dernière dimension.
varname Nom de la variable ; respecte les conventions standard d'affectation de nom à des variables.
subscripts Dimensions d'une variable d'un tableau ; jusqu'à 60 dimensions multiples peuvent être déclarées. L'argument subscripts utilise la syntaxe suivante :

upper [,upper] . . .

La valeur inférieure d'un tableau est toujours zéro.

Notes
L'instruction ReDim est utilisée pour dimensionner ou redimensionner un tableau dynamique qui a déjà été déclaré formellement en utilisant une instruction Private, Public ou Dim avec des parenthèses vides (sans indice de dimension). Vous pouvez utiliser l'instruction ReDim de façon itérative pour changer le nombre d'éléments et les dimensions d'un tableau.

Si vous utilisez le mot clé Preserve, vous ne pouvez modifier que la dernière dimension du tableau et, en aucun cas, le nombre de dimensions. Par exemple, si votre tableau ne comporte qu'une seule dimension, vous pouvez la modifier car c'est la dernière et seule dimension. Toutefois, si votre tableau comporte deux ou plusieurs dimensions, vous ne pouvez modifier que la dernière dimension, tout en conservant le contenu du tableau.

L'exemple suivant montre comment vous pouvez augmenter la taille de la dernière dimension d'un tableau dynamique, sans pour autant effacer les données contenues dans ce dernier.

ReDim X(10, 10, 10)
. . .
ReDim Preserve X(10, 10, 15)

Attention  Si vous réduisez la taille originale d'un tableau, les données contenues dans les éléments éliminés sont perdues.

Quand les variables sont initialisées, une variable numérique est initialisée à 0 et une variable de chaîne est initialisée avec une chaîne de longueur nulle (""). Une variable faisant référence à un objet doit être affectée à un objet existant à l'aide de l'instruction Set avant de pouvoir être utilisée. Jusqu'à ce qu'elle soit affectée à un objet, la variable objet déclarée possède la valeur spéciale Nothing.