PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • Format détaillé de la chaîne de caractères à obtenir
  • Limites
  • Conversion en octets
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
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é.
PHP Dans cette version, le numérique à transformer doit être de type entier ou réel.
Versions 15 et supérieures
Android Cette fonction est désormais disponible pour les applications Android.
Nouveauté 15
Android Cette fonction est désormais disponible pour les applications Android.
Android Cette fonction est désormais disponible pour les applications Android.
Versions 17 et supérieures
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Nouveauté 17
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Versions 18 et supérieures
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Nouveauté 18
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Versions 21 et supérieures
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Nouveauté 21
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
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é.
PHP Si le paramètre <Nombre> est une chaîne, cette chaîne est transformée comme s'il s'agissait d'un nombre.
<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 ou constante
  • Format de la chaîne de caractères, exprimé sous la forme :
    "[<Cadrage>][<Signe>][<Zéro>][<Taille>][<.Précision>]<Type>[<Millier>]"

    PHP La chaîne est exprimée sous la forme :
    "[<Zéro>][<Cadrage>][<Taille>][<.Précision>]<Type>"

    Pour plus de détails, consultez les remarques.
  • Versions 17 et supérieures
    WINDEVWEBDEV - Code ServeuriPhone/iPadWindows MobileUniversal Windows 10 App 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.
    Nouveauté 17
    WINDEVWEBDEV - Code ServeuriPhone/iPadWindows MobileUniversal Windows 10 App 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.
    WINDEVWEBDEV - Code ServeuriPhone/iPadWindows MobileUniversal Windows 10 App 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>]"
PHP Le format est exprimé sous la forme :
"[<Zéro>][<Cadrage>][<Taille>][<.Précision>]<Type>"
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.
PHP Fixe la largeur totale de la chaîne résultat ou de la partie entière si le nombre est complété par des zéros. 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.
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 (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.
    • WEBDEV - Code Serveur dans la configuration Windows du serveur.
    • iPhone/iPad 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.
  • WEBDEV - Code Navigateur La syntaxe <,Précision> ne peut pas être utilisée : il faut utiliser <.Précision>.
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é.
PHP Fixe le nombre de décimales (uniquement pour les <Types> flottant ("f") et exposant ("e")).
  • 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é si le nombre est complété par des espaces.
<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.
WEBDEV - Code Navigateur Le séparateur de milliers est toujours un espace (' ').
WINDEVWEBDEV - Code ServeurWEBDEV - Code NavigateurEtats et RequêtesiPhone/iPadWindows MobileUniversal Windows 10 AppAjaxCode Utilisateur (MCU)

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.
  • WEBDEV - Code Serveur Comment utiliser une virgule pour le séparateur de décimales ?
    Si la configuration Windows sur le serveur n'utilise pas une virgule comme séparateur de décimales, il est possible pour obtenir le formatage voulu :
    • d'utiliser un champ de saisie numérique (caché si nécessaire). La valeur affichée peut alors être récupérée avec la propriété ..ValeurAffichée.
    • d'utiliser un champ de type Affichage formaté.

Conversion en octets

Versions 16 et supérieures
Pour convertir une taille en octets, utilisez la fonction TailleVersChaîne.
Nouveauté 16
Pour convertir une taille en octets, utilisez la fonction TailleVersChaîne.
Pour convertir une taille en octets, utilisez la fonction TailleVersChaîne.
Composante : wd240std.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire