DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion des chaînes
  • Format détaillé de la chaîne de caractères à obtenir
  • Limites
  • Conversion d'une taille exprimée en octets
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Transforme un numérique (entier, réel ou monétaire) en une chaîne de caractères selon le format spécifié.
Exemple
NumériqueVersChaîne(123) // Renvoie "123"
NumériqueVersChaîne(1.23) // Renvoie "1.23"
NumériqueVersChaîne(12345.5, "+10.2f") // Renvoie " +12345.50"
NumériqueVersChaîne(12345.5, "-+10.2f") // Renvoie "+12345.50 "
NumériqueVersChaîne(12345.5, "+010.2f") // Renvoie "+012345.50"
NumériqueVersChaîne(12345.5, "010.2f") // Renvoie "0012345.50"

NumériqueVersChaîne(12345.5, "10.2fS")
// Renvoie " 12 345.50" (le séparateur des milliers est un " ")

NumériqueVersChaîne(12345.5, "10,2fS")
// Renvoie " 12 345,50" (le séparateur décimal est une ",")
Syntaxe
<Résultat> = NumériqueVersChaîne(<Nombre> [, <Format>])
<Résultat> : Chaîne de caractères
Nombre exprimé sous forme de chaîne de caractères en fonction du format choisi.
Si le paramètre <Nombre> est une chaîne, cette chaîne est restituée telle quelle. Le format est ignoré.
<Nombre> : Entier ou réel
Numérique à convertir sous forme de chaîne de caractères (selon le format spécifié).
<Format> : Chaîne de caractères optionnelle, constante ou variable de type FormatNumérique
  • Nouveauté 2024
    Format de la chaîne de caractères défini avec une variable de type FormatNumérique.
  • Format de la chaîne de caractères, exprimé sous la forme :
    "[<Cadrage>][<Signe>][<Zéro>][<Taille>][<.Précision>]<Type>[<Millier>]"


    Pour plus de détails, consultez les remarques.
  • Universal Windows 10 AppiPhone/iPadWidget IOSApple WatchMac Catalyst Constante permettant de définir un format système :
    maskMonétaireSystèmeUtilisation du masque monétaire utilisé par le système.
    maskNombreSystèmeUtilisation du masque numérique utilisé par le système.
Remarques

Format détaillé de la chaîne de caractères à obtenir

Pour convertir un numérique en une chaîne, il est nécessaire de spécifier le format de la chaîne de caractères à obtenir. Ce format est exprimé sous la forme :
"[<Cadrage>][<Signe>][<Zéro>][<Taille>][<.Précision>]<Type>[<Millier>]"
Les différentes valeurs possibles sont les suivantes :
<Cadrage>Si ce paramètre est spécifié, justifie le nombre à gauche (<Cadrage> = "-").
Par défaut, le nombre est justifié à 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".
Par exemple : NumériqueVersChaîne(123,"05d") donnera "00123".
<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, cette taille 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 (caractères "." ou ",") et le nombre de décimales (uniquement pour les <Types> flottant ("f") et exposant ("e")).
Le séparateur décimal :
  • Si le séparateur des décimales est une virgule, le séparateur des décimales sera celui défini :
    • dans les paramètres linguistiques de Windows.
    • iPhone/iPadWidget IOSApple WatchMac Catalyst pour l'utilisateur en cours.
  • Si le séparateur des décimales indiqué est un point, le séparateur décimal utilisé sera un point.
Remarques :
  • La fonction ChangeSéparateur n'a pas d'effet sur ce séparateur. En effet, cette fonction agit uniquement sur le masque d'affichage des numériques dans les champs.
Nombre de décimales :
  • 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.
  • 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>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.
Universal Windows 10 AppiPhone/iPadWidget IOSApple WatchMac Catalyst

Limites

  • Format "f" donne un résultat correct pour les nombres allant de -1e+17 à 1e+17.
  • Formats "x", "d" ou "o" : la partie entière ne doit pas dépasser 99 999 999 999 999 999.

Conversion d'une taille exprimée en octets

Pour convertir une taille exprimée en octets, utilisez la fonction TailleVersChaîne.
Classification Métier / UI : Code neutre
Composante : wd290std.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 23/11/2023

Signaler une erreur ou faire une suggestion | Aide en ligne locale