Char

Syntaxe

   Char        liste_chr_dim

   Local  Char liste_chr_dim

   Global Char liste_chr_dim

   Extern Char liste_chr_dim

 

Paramètres

Elément	Description	Restrictions
liste_chr_dim	Liste de chr_dim séparées par le caractère ','.	Aucune.
chr_dim	Nom d'une variable exprimé sous l'une des formes suivantes : nom'(' maxlen ')' nom'(' maxlen ')' '(' lis_dim ')'	Aucune.
nom	nom_de_variable.	Aucune
maxlen	Longueur maximale admissible pour la chaîne de caractères considérée	Expression entière entre 1 et MAXSTR (255).
lis_dim	Liste de exp_dim séparées par le caractère ','.	Nombre limité à 4.
exp_dim	Expression entière représentant le nombre d'éléments de la variable (de 0 à exp_dim-1) ou 2 expressions entières séparées par les 2 caractères '..' représentant l'intervalle des indices possibles pour la variable	Le nombre d'élé- ments doit apparte- nir à [1,65535]. Si un intervalle est donné, l'indice de départ doit appartenir à [-32768,32767].

 

Exemples

# Déclaration d'un tableau externe de 8 chaînes de 5 caractères
# maximum (numérotés 0 à 7)
    Extern Char TABLIB (5)(8)

# Déclaration d'un tableau de 8 chaînes de 1 caractère,
# les éléments étant numérotés de I à I+7
     I = 3
   Char TABLIB(1)( I .. I+7 )
   Char MES(80)        : # Déclaration d'une chaîne de 80 caractères
   Date DTE           : # Déclaration d'une variable de type Date
   DTE = [9/10/1992]  : # Affectation d'une constante de type Date
    # Calcul du message à afficher
      MES = "Nous sommes le "+day$(DTE)+" "+num$(day(DTE))+" "
   MES += month$(DTE)+" "+num$(year(DTE))
     # Affiche le message suivant :
   # Nous sommes le Vendredi 9 Octobre 1992
    Infbox MES

# Déclaration d'une matrice à 4 dimensions de chaines de 10 caratères
   Char MAT(10)(I, J, K, L)

 

Description

Char permet de déclarer des variables de type chaîne de caractères en les dimensionnant le cas échéant.

Dans le cas où le nombre de caractères de la chaîne n'est pas indiqué, la chaîne est créée avec une longueur maximale de 30 caractères.

Si on utilise Local, les variables seront locales au traitement ou au sous-programme, et supprimées à la fin de l'exécution du sous-programme ou du traitement.

Si on utilise Extern, la variable n'est pas créée, mais son existence et son type sont vérifiés.

Dans le cas où Extern n'est pas utilisé, une déclaration d'une variable existant précédemment dans la classe [V] ou [L] provoquera la suppression de cette variable, suivie de la recréation de la variable avec les dimensions et le type donnés. Après une déclaration, la variable est toujours initialisée (c'est-à-dire mise à "" dans le cas d'une variable de type Char, et ce pour tous les indices de la variable).

 

Erreurs associées

Erreur	Description
ERDIM (55)	Trop de dimensions sont données (>4).
ERVARI ( 6)	Variable inexistante (Extern).
ERMODE (10)	- Les dimensions données ne sont pas numériques. - La variable est de type incorrect (Extern).
ERINDI ( 8)	L'une des dimensions est nulle.
ERDOM (50)	- Les dimensions ne sont pas comprises entre -32768 et +32767. - Le nombre de caractères demandés est négatif ou supérieur à MAXSTR (255).

 

Mots-clés associés

LIBELLE - SHORTINT - DATE - INTEGER - DECIMAL - TYPE - DIM - BLBFILE- CLBFILE- GLOBAL - LOCAL - EXTERN