Mise en forme d'une valeur à virgule flottante.

Structure

FormatFloat(const Format : chaîne ; Valeur : Extended) : chaîne ;

Paramètres

Valeur de retour

Description

La fonction FormatFloat formate la valeur à virgule flottante fournie par Value à l'aide de la chaîne de format fournie par Format. Les spécificateurs de format suivants sont pris en charge dans la chaîne de format :

Le spécificateur représente un espace de réserve à 0 chiffre dans «

». Si la valeur à formater comporte un chiffre à l'emplacement où le « 0 » apparaît dans la chaîne de format, ce chiffre est alors copié dans la chaîne de sortie. Sinon, un « 0 » est enregistré à cet emplacement dans la chaîne de sortie.

Caractère de remplacement pour un chiffre. Si la valeur à formater comporte un chiffre à l'emplacement où le caractère « # » apparaît dans la chaîne de format, ce chiffre est alors copié dans la chaîne de sortie. Sinon, rien n'est enregistré à cet emplacement dans la chaîne de sortie.

. Point décimal. Le premier caractère « . » de la chaîne de format détermine l'emplacement du séparateur décimal dans la valeur formatée ; tous les caractères « . » supplémentaires sont ignorés. Le caractère utilisé comme séparateur décimal dans la chaîne de sortie est déterminé par la variable globale DecimalSeparator. La valeur par défaut de DecimalSeparator est définie dans le paramètre « Format des nombres » de la section « International » du Panneau de configuration de Windows.

, séparateur de milliers. Si la chaîne de format contient un ou plusieurs caractères « , », des séparateurs de milliers seront insérés entre chaque groupe de trois chiffres à gauche de la virgule décimale. La position et le nombre de virgules dans la chaîne de format n'ont aucune incidence sur le résultat, sauf pour indiquer que l'on souhaite utiliser des séparateurs de milliers. Le caractère utilisé pour séparer les milliers dans le résultat est déterminé par la variable globale ThousandSeparator. La valeur par défaut de « ThousandSeparator » est définie dans les options de format des nombres de la section « International » du Panneau de configuration de Windows.

E+ Notation scientifique. Si la chaîne de format contient l'une des chaînes « E+ », « E- », « e+ » ou « e- », le nombre est formaté en notation scientifique. Une suite de quatre caractères « 0 » au maximum peut suivre immédiatement les symboles « E+ », « E- », « e+ » ou « e- » pour déterminer le nombre minimal de chiffres de l'exposant. Les formats « E+ » et « e+ » permettent d'afficher un signe « + » pour les exposants positifs et un signe « - » pour les exposants négatifs. Les formats « E- » et « e- » n'affichent un signe que pour les exposants négatifs.

Les caractères « xx »/« xx » placés entre guillemets simples ou doubles sont affichés tels quels et n'ont aucune incidence sur la mise en forme.

; Sépare les sections correspondant aux nombres positifs, négatifs et nuls dans la chaîne de format.

Les positions du « 0 » le plus à gauche avant la virgule décimale et du « 0 » le plus à droite après la virgule décimale dans la chaîne de format déterminent la plage de chiffres qui apparaissent systématiquement dans la chaîne de sortie.

Le nombre mis en forme est toujours arrondi à autant de décimales qu'il y a de caractères de remplissage (« 0 » ou « # ») à droite de la virgule. Si la chaîne de format ne contient pas de point décimal, la valeur mise en forme est arrondie à l'entier le plus proche.

Si le nombre à formater comporte plus de chiffres à gauche du séparateur décimal qu'il n'y a de placeholders de chiffres à gauche du caractère « . » dans la chaîne de format, les chiffres supplémentaires sont affichés avant le premier placeholder de chiffre.

Pour permettre différents formats pour les valeurs positives, négatives et nulles, la chaîne de format peut comporter entre une et trois sections séparées par des points-virgules.

Une section : la chaîne de format s'applique à toutes les valeurs.

Deux sections : la première s'applique aux valeurs positives et aux zéros, et la seconde aux valeurs négatives.

Trois sections : la première concerne les valeurs positives, la deuxième les valeurs négatives et la troisième les zéros.

Si la section réservée aux valeurs négatives ou celle réservée aux valeurs nulles est vide, c'est-à-dire s'il n'y a rien entre les points-virgules qui délimitent la section, c'est la section réservée aux valeurs positives qui est utilisée à la place.

Si la section réservée aux valeurs positives est vide, ou si la chaîne de format est entièrement vide, la valeur est formatée selon le format général des nombres à virgule flottante avec 15 chiffres significatifs, ce qui correspond à un appel à la fonction FloatToStrF avec le format ffGeneral. Le formatage général en virgule flottante est également utilisé si la valeur comporte plus de 18 chiffres à gauche de la virgule décimale et que la chaîne de format ne spécifie pas la notation scientifique. |