dim
dim permet de retrouver les dimensions d'une variable.
Syntaxe
dim( variable [, [ '-' ] no_dim ] )
Paramètres
Elément | Description | Restrictions |
variable | Nom de la variable dont on désire connaître la dimension sous la forme : | Aucune. |
no_dim | Expression entière donnant le numéro de la dimension à retourner, précédé ou non du signe '-'. Par défaut cette valeur vaut 1. | De 0 à nombre de dimensions de la |
Exemples
# Test d'existence d'une variable
If dim([M:TOTO]VAR1) < 0
Errbox "Variable inexistante !" Endif#Déclaration d'un tableau 2*3*4 de chaînes de longueur maximale 8
Char TOTO(8) (5..16,3,4)
Infbox num$(type(TOTO))-num$(dim(TOTO))
For I=1 To dim (TOTO, 0)
Infbox num$(dim(TOTO, I))-num$(dim(TOTO, -I))
Next I # Ce programme affiche : # 18 12 # 12 5 3 0 4 0
Description
dim renvoie un code correspondant à la première dimension de la variable donnée en paramètre, si un seul paramètre est donné.
Lorsqu'on utilise deux paramètres, le deuxième est le numéro d'une dimension (de 1 à 4 maximum) de la variable, précédé ou non du signe '-'. Si ce numéro est positif, la valeur retournée est le nombre d'éléments de la dimension donnée. Sinon, il s'agit de l'indice de début de cette dimension. Cette syntaxe n'est utile que pour une variable ayant plusieurs dimensions. Si le deuxième argument est nul, on obtient le nombre de dimensions de la variable (de 1 à 4 maximum).
Le type du résultat de cette fonction est Integer.
Remarques
dim renvoie -1 si la variable est inexistante. Ceci permet de tester l'existence d'une variable.