DESCRIPTION.

La fonction DIM permet de réserver une zone de la mémoire de la machine hote en vue d'une utilisation particulière ultérieure.

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

Voir la fonction DIM() pour connaitre la taille d'un tableau ou d'une structure.

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

SYNTAXE.

DIM kzone%% quantite

DIM kzone%% LOCAL quantite

REMARQUES.

kzone%% sera affectée avec l'adresse mémoire, l'emplacement, où débute la zone réservée.

quantite doit être nombre entier, ou -1, indiquant le nombre d'octets que contiendra la zone mémoire, en plus de l'octet situé à kzone%%. La taille d'une zone mémoire, en octets, est donc de quantite + 1.

Il est possible de réserver temporairement une zone mémoire, pour son utilisation dans l'exécution d'une procédure ou d'une fonction personnalisée avec la forme DIM kzone%% LOCAL quantite. 

La variable spécifiée dans l'instruction DIM est définie à l'adresse de début de cette zone mémoire. Cette zone réservée peut ensuite être utilisée par les opérateurs d'indirection, le code assembleur, etc.

Rappel : avant d'utiliser une variable de portée locale dans une procédure ou une fonction personnalisée, il faut la déclarée comme LOCAL précédemment. Il faudra donc coder : LOCAL kzone%% : DIM kzone%% LOCAL quantite. 

La forme DIM kzone%% −1, réserve donc 0 octet en mémoire, mais permet de connaitre la limite d'allocation de la variable dynamique jusqu'à présent.

DIM kzone%% -1 : REM - affecte a kzone%% l'adresse du dernier octet utilisé

PRINT kzone%% : REM - affiche la valeur de kzone%% 

PRINT HIMEM - kzone%%  : REM - retourne l'espace memoire encore disponible pour les réservation de zones memoire

ATTENTION : Qu'elles soient réservées de façon permanente ou temporaire, la mémoire réservée entraîne une perte irréversible d'espace pour l'application. Il est donc fortement recommandé de réservée une seule zone mémoire plus importante, que plusieurs plus petite au fur et à mesure des besoins du programme. Le risque de mauvais fonctionnement est particulièrement accru lorsque DIM est utilisé dans une procédure ou fonction personnalisé.

EXEMPLES.

DIM kzone%% 1024