Version de WDScript : 2.0.7+

Renvoie une chaîne formatée depuis une valeur numérique.

Syntaxe

<Résultat> = NumériqueVersChaîne(<Nombre> [, <Format>])

<Résultat> : Nombre retourné sous forme d'une chaîne de caractères en fonction du format choisi. Si le paramètre <Nombre> est une chaîne, elle est restituée telle quelle. Le format est ignoré.

<Nombre> : Numérique à convertir sous forme de chaîne de caractères (selon le format spécifié).

<Format> : Format de la chaîne de caractères, exprimé sous la forme :
[<Cadrage>][<Signe>][<Zéro>][<Taille>][<.Précision>] <Type>[<Millier>]

<Cadrage> Si ce paramètre est spécifié, justifie le nombre à gauche (<Cadrage> = "-"). Par défaut, l'alignement est à droite.

<Signe> Si ce paramètre est spécifié, force le signe pour les chiffres positifs (<Signe> = "+"). Ce signe apparaîtra à gauche du premier chiffre significatif. Par défaut, seuls les chiffres négatifs ont un signe "-" à gauche du premier chiffre significatif. Cas particulier : si ce paramètre est spécifié et si le nombre vaut 0, le signe "+" sera affiché. De même si un nombre négatif devient égal à 0.

<Zéro> Si ce paramètre est spécifié (<Zéro> ="0"), le nombre sera complété par des zéro à gauche du premier chiffre significatif si la partie significative du nombre est plus petite que la taille demandée et si le nombre est justifié à droite. Par défaut, le nombre n'est pas complété à gauche par des "0".

<Taille> Fixe la largeur totale de la chaîne résultat. La largeur totale correspond aux éléments suivants : signe, séparateur de milliers, point décimal, exposant, parties entières et décimales du nombre. Cette taille doit être inférieure à 100.
Si la taille indiquée est trop petite pour contenir la partie significative du nombre, elle sera ignorée. Par défaut, le nombre aura la taille de sa partie significative (il ne pourra pas être complété par des zéro). Idem si <Taille> = 0 Si la taille indiquée est plus grande que la partie significative du nombre :
- la chaîne résultat sera complétée par des espaces à droite si le nombre est justifié à gauche,
- la chaîne résultat sera complétée par des espaces ou zéros à gauche si le nombre est justifié à droite.

<Précision> Fixe le séparateur décimal et le nombre de décimales (uniquement pour les <Types> flottant ("f") et exposant ("e"). Le nombre de décimal doit être inférieur à 100. Si le nombre de décimales du nombre est plus grand que <Précision>, la partie décimale sera arrondie au nombre de décimales demandées. Si le nombre de décimales du nombre est plus petit que <Précision>, la partie décimale sera complétée par des "0" à droite. Si le séparateur des décimales est une virgule, le séparateur des décimales sera celui défini dans la configuration Windows du serveur. La valeur de <Précision> peut être plus grande que <Taille>. Dans ce cas <Taille> est ignoré.

<Type> Type du résultat, paramètre obligatoire :
d : Entier :
Un nombre réel sera arrondi à l'entier le plus proche.
e : Notation exponentielle :
Si <Précision> n'est pas indiqué, 6 chiffres par défaut.
f : Notation décimale :
Si <Précision> n'est pas indiqué, 6 chiffres par défaut.
x et X : Notation hexadécimale (X pour des lettres majuscules) :
Seule la partie entière du nombre est prise en compte (pas d'arrondi).
Cas particulier :
1. Taille non précisée et nombre négatif : 20 caractères hexadécimaux pour un monétaire, 8 caractères pour tous les autres numériques.
2. Nombre négatif : la taille de la chaîne résultat sera au minimum la taille permettant d'indiquer le bit de signe.
Par exemple : -32767 dans le format "3X" donnera "8001"
o : Notation octale :
Seule la partie entière du nombre est prise en compte (pas d'arrondi).
Cas particulier :
1. Taille non précisée et nombre négatif : 27 caractères pour un monétaire, 11 caractères pour tous les autres numériques.
2. Nombre négatif : la taille de la chaîne résultat sera au minimum la taille permettant d'indiquer le bit de signe.
Par exemple : -32767 dans le format "3o" donnera "700001"

<Millier> comme séparateur de milliers (<Millier> = "S" ou "s"). Les chiffres de la partie entière du nombre seront regroupés par 3 et séparés par le caractère séparateur de milliers défini dans Windows. Si le signe est présent, il sera toujours immédiatement à gauche du premier chiffre significatif. Il ne peut pas y avoir de séparateur des milliers entre le signe et le premier chiffre.

Remarque

En 2.0.5, vous devez utiliser VersChaine.

Exemple

<wdscript>
// Création d'un jeu de cartes
Paquet est un tableau de 52 par 2 chaînes
NumCarte est un entier
i est un entier
// Pour la question de la valeur des cartes,
// on démarre du 1 et on monte jusqu'au roi (13)
NumCarte = 1
Pour i = 1 à 13
   // Pique
   Paquet[i,1] = VersChaîne((NumCarte),"02d") + "PQE"
   NumCarte++
Fin
NumCarte = 1
Pour i = 14 à 26
   // Trefle
   Paquet[i,1] = VersChaîne((NumCarte),"02d") + "TRE"
   NumCarte++
Fin
NumCarte = 1
Pour i = 27 à 39
   // Carreau
   Paquet[i,1] = VersChaîne((NumCarte),"02d") + "CAR"
   NumCarte++
Fin
NumCarte = 1
Pour i = 40 à 52
   // Coeur
   Paquet[i,1] = VersChaîne((NumCarte),"02d") + "COR"
   NumCarte++
Fin
</wdscript>

Commentaires

Les commentaires doivent si possible être postés en anglais. Ils sont soumis à la modération avant d'être publiés.

Ajouter votre commentaire