FORMAT

Voir également Exemple

Renvoie sous forme de chaîne de caractères une expression selon le format passé en paramètre.

Support WebVue - Oui.

Syntaxe

StrVal = FORMAT("xxxxx%FormatString yyyyy", Variable);

Type de retour : STR

Argument	Définition
xxxxx	Chaîne de caractères apparaissant avant la valeur formatée dans le champ retourné. Facultatif.
yyyyy	Chaîne de caractères apparaissant après la valeur formatée dans le champ retourné. Facultatif.
FormatString	Chaîne de caractères du paramètre qui détermine le format et la position de la valeur insérée. Cela commence avec le caractère % et contient Width, Precision et Modifier.
Width	Nombre spécifiant la longueur du champ retourné (nombre de caractères). Si celui-ci est précédé d'un signe moins, les caractères seront justifiés à gauche, autrement ils seront justifiés à droite. Optionnel.
Precision	Nombre indiquant soit le nombre maximum de caractères à retourner pour une chaîne, soit le nombre de chiffres pour un INTEGER, soit le nombre de chiffres après le point décimal pour un nombre flottant. Elle est toujours précédée d'un point. Optionnel.
Modifier	Caractère spécifiant le type de retour de la variable. Type STR.
Variable	Nom de la variable dont la valeur est à formater.

Exécution

La valeur de la variable est retournée dans la chaîne comme une sous-chaîne formatée. Le modificateur doit correspondre au type de variable.

Modifier	Type de variable	Retour
d, i	Integer	Nombre décimal.
o	Integer	Nombre octal non signé (non précédé d'un zéro).
x, X	Integer	Nombre hexadécimal non signé (non précédé de x ou X), en utilisant abcdef ou ABCDEF pour 10, ..., 15.
u	Integer	Nombre décimal non signé.
c,C	Integer	Caractère unique pour le code ASCII spécifié.
s	Str	Retourne les caractères d'une chaîne jusqu'à rencontrer un '\0' ou jusqu'à avoir retourné le nombre de caractères indiqué par la précision.
f	Double	Notion décimale de la forme [-]m.dddddd, où le nombre de d est donné par la précision (par défaut, 6).
e, E	Double	[-]m.dddddd +xx ou [d]m.ddddddE+xx, où l nombre de [-]d est donné par la précision (par défaut, 6).
g, G	Double	Equivaut à %e ou %E si l'exposant est inférieur à -4 ou supérieur ou égal à la précision; sinon, équivaut à %f. Les zéros ou les points décimaux finaux ne sont pas retournés.
ld	Long	Entier 4 octets.
lld	LongLong	Entier 8 octets.

Exemple

Pour un exemple d'affichage de différentes chaînes de caractères par la commande FORMAT, sélectionner le lien Exemple ci-dessus.