Bloc Fonctionnel STR_FORMAT

Le bloc fonctionnel STR_FORMAT retourne une chaîne de caractères formatée.

Ce bloc fonctionnel correspond à la fonction sprintf en C++.

Remarque: Ce bloc fonctionnel peut avoir plus de deux entrées. Vous pouvez cliquer avec le bouton droit de la souris sur le bloc fonctionnel pour ajouter une autre entrée.

Entrée Format

L'entrée définit le formatage. Celui-ci se compose d'aucun ou plusieurs instructions : des caractères normaux (à l'exception de %), qui sont directement copiés dans le résultat et des instructions de conversion, qui appellent chacune leurs propres paramètres.

Dans ce cas, l'instruction de conversion suit le prototype suivant :

%[ArgNum$][Flags][Weite][.Präzision]Spezifizierer.
ArgNum

Un entier suivi d'un signe dollar $, qui indique le numéro de l'entrée STR# à utiliser pour la conversion.

Flags
Flag Description
- Aligné à gauche dans la largeur de champ spécifiée ; aligné à droite est la valeur par défaut
+ Les nombres positifs avec un signe plus + ; par défaut, seuls les nombres négatifs sont affichés avec des signes négatifs
(Espace) Remplit le résultat avec des espaces. C'est la valeur par défaut.
0 Remplit à gauche avec des zéros. Avec le spécificateur s, cela peut également remplir à droite avec des zéros.
'(Caractère) Remplit le résultat avec le caractère spécifié.
Weite

Un entier qui indique combien de caractères (minimum) le résultat de la conversion doit avoir.

Präzision

La signification d'un point . suivi d'un entier dépend du spécificateur :

  • Pour les spécificateurs e, E, f et F : cela indique le nombre de décimales à afficher après le séparateur décimal (par défaut, il s'agit de 6).
  • Pour les spécificateurs g et G : le nombre maximal de décimales significatives à afficher.
  • Pour le spécificateur s : se comporte comme un point de coupure, qui indique un nombre maximal de caractères dans la chaîne de caractères.

Remarque: Si le point est spécifié sans une valeur explicite pour la précision, 0 est supposé.

Spezifizierer
Spezifizierer Description
% Un signe de pourcentage. Aucun paramètre nécessaire.
b Le paramètre est traité comme un entier et affiché en tant que nombre binaire.
c Le paramètre est traité comme un entier et affiché en tant que caractère du jeu de caractères ASCII.
d Le paramètre est traité comme un entier et affiché en tant que nombre décimal (signé).
e Le paramètre est traité comme un nombre en notation scientifique (par exemple, 1.2e+2). La précision indique le nombre de caractères après le point décimal.
E Comme le spécificateur e, mais écrit une lettre majuscule (par exemple, 1.2E+2).
f Le paramètre est considéré comme un nombre à virgule flottante et affiché en tant que nombre à virgule flottante (dépendant de la locale).
F Le paramètre est considéré comme un nombre à virgule flottante et affiché en tant que nombre à virgule flottante (indépendamment de la locale).
g Format général.
Soit P la précision, si non nulle, 6 si la précision n'est pas spécifiée ou 1 si la précision est nulle. Alors, si une conversion au moyen de E aurait un exposant de X :
Si P > X ≥ -4, la conversion se fait avec le spécificateur f et une précision de P - (X + 1). Sinon, comme avec le spécificateur e et une précision de P - 1.
G Comme le spécificateur g, mais E et F sont utilisés.
o Le paramètre est considéré comme un entier et affiché en tant que nombre octal.
s Le paramètre est considéré comme une chaîne de caractères et affiché.
u Le paramètre est considéré comme un entier et affiché en tant que nombre décimal non signé.
x Le paramètre est considéré comme un entier et affiché en tant que nombre hexadécimal (avec des minuscules).
X Le paramètre est considéré comme un entier et affiché en tant que nombre hexadécimal (avec des majuscules).

Attention: Le spécificateur c ignore le remplissage et la largeur.

Avertissement: La tentative d'utiliser la combinaison de chaînes de caractères avec une spécification de largeur et des jeux de caractères qui s'attendent à plus d'un octet par caractère conduit à des résultats imprévisibles.

Les variables sont converties en un type approprié pour le spécificateur :

Type Spezifizierer
Chaîne de caractères s
Entier d, u, c, o, x, X, b
Float g, G, e, E, f, F

Entrée STR1..STR#

L'entrée ou les multiples entrées définissent la valeur respective à remplacer dans la chaîne de caractères spécifiée à l'entrée FORMAT.

Sortie

Retourne la chaîne de caractères générée.