DIM

Sommaire


dimpermet 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ésireconnaître la dimension sous la  forme :
classe nom_de_variable

Aucune.

no_dim

Expression entière donnant le numéro dela dimension à retourner,  précédé ou non du signe '-'. Par  défautcette valeur vaut 1.

De 0 à nombre de  dimensions de la
variable.

 

Exemples

   # Test d'existence d'une variable
   Ifdim([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 Todim (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 et commentaires

dimrenvoie un code correspondant à la première dimension de la variable donnée enparamè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éroest positif, la valeur retournée est le nombre d'éléments de la dimensiondonnée. Sinon, il s'agit de l'indice de  début de cette dimension. Cettesyntaxe n'est utile que pour une variable ayant plusieurs dimensions. Si ledeuxiè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.

 

Remarque

dimrenvoie -1 si la variable est inexistante. Ceci permet de tester l'existenced'une variable.

 

Erreurs associées

Erreur

Description

ERDOM(50)

L'argumentne correspond pas à une variable. no_dim dépasse le nombre de dimensions ou a unevaleur négative.

Mots-clés associés

TYPE


SOMMAIRE

Adonix X3(r) L4G
Copyright (c) Adonix 1999 - All rights reserved