System.Str
Delphi
procedure Str(const X [: Width [:Decimals]]; var S: String);
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| procedure | public | System.pas | System | System |
Description
Formate une chaîne et la renvoie dans une variable.
Dans le code Delphi, Str convertit une expression de type entier ou réel en chaîne, selon les paramètres de formatage Width et Decimals. Width représente la longueur de la chaîne résultante. Decimals définit le nombre de positions après la virgule décimale. Ces deux paramètres sont des expressions de type entier. L'effet de cette procédure est similaire à Write, à une exception près : le résultat est passé à une variable au lieu d'être écrit dans un fichier texte.
X est une expression de type entier ou réel. Width et Decimals sont des expressions de type entier. S est une variable de type chaîne ou une variable tableau de caractères de base zéro, si la syntaxe étendue est activée.
Exemple (Delphi) :
var
aNumber: real;
myString: string;
...
aNumber := 123456.789;
Str(aNumber: 16: 6, myString); // Predefined string length: 16. Decimal places: 6.
Writeln(myString); // The output is: ' 123456.789000'
Remarques : Lors de l'utilisation de cette procédure, le compilateur peut toutefois émettre un avertissement : W1057 Transtypage de chaîne implicite de '%s' en '%s' (Delphi).
Si une chaîne de longueur minimale prédéfinie n'est pas nécessaire, essayez d'utiliser à la place la fonction IntToStr.