DESCRIPTION.

La fonction DIM() retourne le nombre de dimension d'un tableau de données, la taille d'une de ses dimensions ou la taille d'une structure de données.

Voir l'instruction DIM pour déclarer un tableau de données.

Voir l'instruction DIM{} pour déclarer une structure de données.

Voir l'instruction DIM pour réserver une zone mémoire.

SYNTAXE.

DIM( tableau() )

DIM( tableau() , dimension )

DIM( structure{} )

REMARQUES.

tableau() doit être le nom d'un tableau de données déclaré au préalable, la paire de parenthèses est obligatoire.

dimension doit être une valeur numérique correspondante à l'une des dimensions de tableau(). dimension doit être compris entre 1 et le nombre total de dimensions du tableau de données.

structure{} doit être le nom d'une structure de données déclarée au préalable, la paire d'accolades est obligatoire.

La fonction DIM() retourne une valeur numérique. La forme : 

- DIM ( tableau() ), retourne le nombre de dimensions d'un tableau de données ;

- DIM ( tableau() , dimension ), retourne l'index du dernier d'item dans une dimension d'un tableau de données ;

- DIM ( structure{} ), retourne la taille, en octets, d'une structure de données.

La connaissance du nombre de dimensions d'un tableau de données, et du nombre d'items de chacune d'elles, peut être utile si les données de plusieurs tableaux, mais de conception différente, doivent être lues ou modifiées dans une fonction personnalisée PROC ou FN, qui doit s'adapter aux spécificités de chaque tableau de données.

Rappel : Le nombre d'items d'une dimension d'un tableau de données est égal à la taille de cette dimension plus 1. Le premier item est à l'index 0.

EXEMPLES.

DIM LST_Tableau$(15, 21, 4) 

kdimensions =  DIM (LST_Tableau$()) 

PRINT "Le tableau de données a : "; kdimensions; " dimensions."

FOR kdimension = 1 TO kdimensions

PRINT "La taille de la dimension "; kdimension; " est ";  DIM(LST_Tableau$(), kdimension) ; " items."

NEXT kdimension

retourne

Le tableau de données a : 3 dimensions.

La taille de la dimension 1 est 16 items.

La taille de la dimension 1 est 22 items.

La taille de la dimension 1 est 5 items.

DIM DCT_Donnees{article$, prix, taxe&, stock%}

PRINT DIM (DCT_Donnees{})

DCT_Donnees.article$ = "planche"

DCT_Donnees.prix = 24.15

DCT_Donnees.taxe& = 12

DCT_Donnees.stock% = 483

PRINT DIM (DCT_Donnees{})

retourne

      23

      23