CHAR

Charpermet de déclarer des variables du type chaîne de caractères.

Syntaxe

  Char       liste_chr_dim

   Local Charliste_chr_dim

   GlobalCharliste_chr_dim

   ExternCharliste_chr_dim

Paramètres

Elément	Description	Restrictions
liste_chr_dim	Liste dechr_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 deexp_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)
ExternChar TABLIB (5)(8)

# Déclaration d'un tableau de 8 chaînes de 1caractè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 80caractères
   DateDTE           : # Déclarationd'une variable de type Date
   DTE = [9/10/1992] : # Affectation d'uneconstante 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 dechaines de 10 caratères
Char MAT(10)(I, J, K, L)

Description et commentaires

Charpermet 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)	Variableinexistante (Extern).
ERMODE(10)	- Les dimensions données ne sont pas numériques. - La variable est de type incorrect (Extern).
ERINDI( 8)	L'unedes 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

SOMMAIRE