NOM¶

SYNOPSIS¶

#include <monetary.h>

ssize_t strfmon(char *s, size_t max, const char *format,
...);

ssize_t strfmon_l(char *s, size_t max, locale_t locale,
const char *" format , ...);

DESCRIPTION¶

La fonction strfmon_l() réalise la même fonction mais se base sur les paramètres régionaux indiqués par locale. Le comportement de strfmon_l() est non défini si locale est l’objet de paramètres régionaux LC_GLOBAL_LOCALE (consultez duplocale(3)) ou n’est pas un identifiant d’objet de paramètres régionaux valable.

Les caractères ordinaires de format sont copiés dans s sans conversion. Les indicateurs de conversion sont introduits par un caractère « % ». Immédiatement à sa suite, il peut y avoir zéro ou plusieurs drapeaux parmi les suivants :

=f

Le caractère unique f sert comme caractère numérique de remplissage (à utiliser avec une précision à gauche, voir plus bas). Sans indication, il s'agit du caractère espace.

^

Ne pas utiliser les caractères de regroupement (par milliers par exemple) qui peuvent être définis pour la localisation en cours. Par défaut, le groupement est actif.

( or +

L'attribut « ( » indique que les valeurs négatives doivent être encadrées entre parenthèses. L'attribut « + » indique que le signe doit être traité de la manière par défaut, c'est-à-dire les valeurs précédées de l'indication locale de signe. Par exemple, rien pour les valeurs positives et « - » pour les négatives.

!

Omettre le symbole monétaire.

-

Justifier tous les champs à gauche. Par défaut, la justification est à droite.

Ensuite, peut venir un champ de largeur : un chiffre décimal indiquant la largeur minimale en octets. Par défaut, elle vaut 0. Un résultat plus petit que cette largeur est complété avec des espaces (à gauche à moins que la justification soit à gauche).

Ensuite, il peut y avoir une précision à gauche de la forme « # » suivie par une chaîne de chiffres décimaux. Si le nombre de chiffres à gauche de la virgule est inférieur à cette valeur, la représentation est complétée à gauche avec le caractère de remplissage. Les caractères de groupement ne sont pas comptés dans la largeur du champ.

Ensuite, il peut y avoir une précision à droite de la forme « . » suivie par une chaîne de chiffres décimaux. La valeur est arrondie à ce nombre de décimales avant d'être mise en forme. La valeur par défaut est précisée dans les champs frac_digits et int_frac_digits de la localisation en cours. Si la précision à droite est 0, aucun symbole décimal n'est affiché (le symbole décimal est déterminé par LC_MONETARY, et peut différer de celui indiqué dans LC_NUMERIC).

Finalement, la spécification de conversion doit se terminer par un caractère de conversion. Les trois caractères disponibles sont :

%

(Dans ce cas, la spécification entière doit être exactement « %% »). Placer un caractère « % » dans la chaîne de résultat.

i

Un argument de type double est converti en utilisant les formats internationaux des monnaies dans la localisation en cours.

n

Un argument de type double est converti en utilisant les formats nationaux des monnaies dans la localisation en cours.

VALEUR RENVOYÉE¶

ATTRIBUTS¶

CONFORMITɶ

EXEMPLE¶

strfmon(buf, sizeof(buf), "[%^=*#6n] [%=*#6i]",
        1234.567, 1234.567);

affiche

[€ **1234,57] [EUR **1 234,57]

dans la locale nl_NL. Les locales de_DE, de_CH, en_AU et en_GB donnent pour résultat

[ **1234,57 €] [ **1.234,57 EUR]
[ Fr. **1234.57] [ CHF **1'234.57]
[ $**1234.57] [ AUD**1,234.57]
[ £**1234.57] [ GBP**1,234.57]

VOIR AUSSI¶

COLOPHON¶

TRADUCTION¶

Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à <debian-l10n-french@lists.debian.org>.