|
|
|
|
|
|
|
|
|
|
- Format détaillé de la chaîne de caractères à obtenir
- Limites
- Conversion d'une taille exprimée en octets
NumériqueVersChaîne (Fonction) En anglais : NumToString Transforme un numérique (entier, réel ou monétaire) en une chaîne de caractères selon le format spécifié.
NumériqueVersChaîne(123)
NumériqueVersChaîne(1.23)
NumériqueVersChaîne(12345.5, "+10.2f")
NumériqueVersChaîne(12345.5, "-+10.2f")
NumériqueVersChaîne(12345.5, "+010.2f")
NumériqueVersChaîne(12345.5, "010.2f")
NumériqueVersChaîne(12345.5, "10.2fS")
NumériqueVersChaîne(12345.5, "10,2fS")
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 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.
 dans la configuration Windows du serveur.     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.
 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é.
| | <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.
|
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 : wd300std.dll
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|