Format

Les possibilités de format sont les mêmes que pour un champ. Le format peut être défini de deux manières :

Par un chiffre

Cela fixe le nombre de caractères d'une chaîne ou d'une date :

Par exemple :

Date madate("lib",8)       // date sur 8 caractères
Chaine machaine("lib",10)  // chaîne sur 10 caractères

Par un format complexe

C'est une suite de caractère entre guillemets conformément aux règles suivantes :

Format des variables numériques

Le format définit la manière d'éditer la variable (en particulier, indication du nombre de chiffres avant et après la virgule).

L'affichage et la saisie se feront en fonction des spécificités du pays, même si le format les représente en version américaine. Le séparateur des milliers et le format monétaire dépendent de celui choisi dans Windows.

Les données numériques sont toujours cadrées à droite dans la zone.

Le format est constitué d'une séquence de caractères « 0 », « # », « . », « , » « + » ou « $ » à utiliser comme suit :

• les caractères « 0 » indique des chiffres qui seront affichés même s'ils font partie des 0 à gauche.

• les caractères « # » (placés obligatoirement en tête à la place de caractères « 0 ») ont pour effet d'éviter l'édition des 0 à gauche.

• le caractère « . » permet d'indiquer le début de la partie décimale.

• les caractères « , » permettent d'obtenir un espacement des chiffres. Par exemple, mis tous les trois chiffres à gauche de la virgule, ils permettent d'obtenir un espacement des chiffres par milliers, afin d'améliorer la lisibilité.

• le caractère « - » placé en début de format permet d'afficher (et autoriser à la saisie) le signe pour les nombres négatifs.

• le caractère « + » placé en début de format permet d'afficher (et autoriser à la saisie) le signe pour toute valeur, positive ou négative.

• le caractère « $ » placé en début de format, permet d'afficher le nombre en format monétaire (format monétaire défini par Windows). Ce caractère ne peut pas être utilisé avec les caractères « + » ou « - ».

Si le signe est affiché, il ne prend pas la place d'un « # » ou d'un « 0 », mais s'ajoute à gauche.

Exemples :

Si le format n'est pas spécifié, le format par défaut utilisé dépend du type :

• type Entier: format -#####

• type Simple: format -#####0.00

• type Double: format -#########0.00

Lorsqu'une valeur ne peut pas être éditée dans le format demandé (trop de chiffres avant le point décimal), le format est rempli par des caractères « * ».

Format des variables alphanumériques

Ce format définit la manière d'éditer la variable (en particulier, indication des séparateurs et des caractères autorisés).

Le format est constitué d'une séquence d'informations à utiliser comme suit :

• « A » une lettre.

• « N » une lettre ou un chiffre.

• « 9 » un chiffre.

• « # » un chiffre ou un blanc.

• « X » un caractère quelconque.

• « ! » un caractère quelconque, converti en majuscule à la saisie.

• [mini-maxi] autorise les caractères entre mini et maxi.
  Par exemple, [A-D] autorise A, B, C ou D.

• [!mini-maxi] interdit les caractères entre mini et maxi.
  Par exemple, [!X-Z] autorise tout sauf X, Y, Z.

• l'un des précédents suivi de (nombre) équivaut à nombre fois le caractère (taille maximale non obligatoire). Par exemple A(5) équivaut à AAAAA

• 'texte' texte à insérer tel quel.

Cas particulier : le format Date sera de la forme :

[0-3][0-9]'/'[0-1][0-9]'/'[0-9][0-9][0-9][0-9]   ou

[0-3][0-9]'/'[0-1][0-9]'/'[0-9][0-9]

Exemples