Ubuntu Manpage: printf, fprintf, dprintf, sprintf, snprintf, vprintf, vfprintf, vdprintf, vsprintf,

NOM

       printf,  fprintf,  dprintf,  sprintf,  snprintf,  vprintf,  vfprintf,  vdprintf, vsprintf,
       vsnprintf - Formatage des sorties

SYNOPSIS

       #include <stdio.h>

       int printf(const char *format, ...);
       int fprintf(FILE *flux, const char *format, ...);
       int dprintf(int fd, const char *format, ...);
       int sprintf(char *chaîne, const char *format, ...);
       int snprintf(char *chaîne, size_t taille, const char *format, ...);

       #include <stdarg.h>

       int vprintf(const char *format, va_list ap);
       int vfprintf(FILE *flux, const char *format, va_list ap);
       int vdprintf(int fd, const char *format, va_list ap);
       int vsprintf(char *chaîne, const char *format, va_list ap);
       int vsnprintf(char *chaîne, size_t taille, const char *format, va_list ap);

   Exigences   de   macros   de   test   de   fonctionnalités   pour    la    glibc    (consulter
   feature_test_macros(7)) :

       snprintf(), vsnprintf() :
           _XOPEN_SOURCE >= 500 || _ISOC99_SOURCE ||
               || /* Versions de la glibc <= 2.19 : */ _BSD_SOURCE

       dprintf(), vdprintf() :
           Depuis la glibc 2.10 :
               _POSIX_C_SOURCE >= 200809L
           Avant la glibc 2.10 :
               _GNU_SOURCE

DESCRIPTION

Les fonctions de la famille printf() produisent des sorties en accord avec le format
décrit plus bas. Les fonctions printf() et vprintf() écrivent leur sortie sur stdout, le
flux de sortie standard. fprintf() et vfprintf() écrivent sur le flux flux indiqué.
sprintf(), snprintf(), vsprintf() et vsnprintf() écrivent leurs sorties dans la chaîne de
caractères chaîne.

La fonction dprintf() est équivalente à fprintf() si ce n'est qu'elle écrit dans un
descripteur de fichier fd plutôt que dans un flux stdio.

Les fonctions snprintf() et vsnprintf() écrivent au plus taille octets (octet NULL final
(« \0 ») compris) dans chaîne.

Les fonctions vprintf(), vfprintf(), vdprintf(), vsprintf() et vsnprintf() sont
équivalentes aux fonctions printf(), fprintf(), dprintf(), sprintf() et snprintf()
respectivement, mais elles emploient un tableau va_list à la place d'un nombre variable
d'arguments. Ces fonctions n'appellent pas la macro va_end. Du fait qu'elles appellent la
macro va_arg, la valeur de ap n'est pas définie après l'appel. Consultez stdarg(3).

Toutes ces fonctions écrivent leurs sorties sous le contrôle d'une chaîne de format qui
indique les conversions à apporter aux arguments suivants (ou accessibles à travers les
arguments de taille variable de stdarg(3)).

C99 et POSIX.1-2001 spécifient que les résultats ne sont pas définis si un appel à
sprintf(), snprintf(), vsprintf() ou vsnprintf() causait la copie entre des objets qui se
chevauchent (par exemple, si le tableau de la chaîne cible et un des paramètres d'entrée
se trouvent dans le même tampon). Consultez la section NOTES.

CHAÎNE DE FORMAT
La chaîne de format est une chaîne de caractères, commençant et se terminant dans son état
de décalage initial, si présent. La chaîne de format est composée de zéro ou plus
d'indicateurs : les caractères ordinaires (différents de %), qui sont copiés sans
modification sur la sortie, et les spécifications de conversion, qui chacune recherche un
ou plus d’arguments suivants. Les spécifications de conversion sont introduites par le
caractère % et se terminent par un indicateur de conversion. Entre eux peuvent se trouver
(dans l'ordre), zéro ou plusieurs attributs, une valeur optionnelle de largeur minimale de
champ, une valeur optionnelle de précision et un éventuel modificateur de longueur.

Les arguments doivent correspondre correctement (après les promotions de types) avec les
indicateurs de conversion. Par défaut les arguments sont pris dans l'ordre indiqué, où
chaque « * » (voir Largeur de champ et Précision ci-après) et chaque indicateur de
conversion réclament un nouvel argument (et l'insuffisance d’arguments est une erreur). On
peut aussi préciser explicitement quel argument prendre, en écrivant, à chaque conversion,
« %m$ » au lieu de « % », et « *m$ » au lieu de « * ». L'entier décimal m indique la
position dans la liste d'arguments, l'indexation commençant à 1. Ainsi,

printf("%*d", width, num);

printf("%2$*1$d", width, num);

sont équivalents. La seconde notation permet de répéter plusieurs fois le même argument.
Le standard C99 n'autorise pas le style utilisant « $ », qui provient des Spécifications
UNIX Single. Si le style avec « $ » est utilisé, il faut l'employer pour toutes
conversions prenant un argument et pour tous les arguments de largeur et de précision,
mais on peut le mélanger avec des formats « %% » qui ne consomment pas d'arguments. Il ne
doit pas y avoir de sauts dans les numéros des arguments spécifiés avec « $ ». Par
exemple, si les arguments 1 et 3 sont spécifiés, l'argument 2 doit aussi être mentionné
quelque part dans la chaîne de format.

Pour certaines conversions numériques, un caractère de séparation décimale (le point par
défaut) est utilisé, ainsi qu'un caractère de regroupement par milliers. Les véritables
caractères dépendent de la valeur de LC_NUMERIC dans la locale (consultez setlocale(3)).
La localisation POSIX utilise « . » comme séparateur décimal, et n'a pas de caractère de
regroupement. Ainsi,

printf("%'.2f", 1234567.89);

s'affichera comme « 1234567.89 » dans la localisation POSIX, « 1 234 567,89 » en
localisation fr_FR, et « 1.234.567,89 » en localisation da_DK.

Caractères d'attribut
Le caractère % peut être éventuellement suivi par zéro ou plusieurs des attributs
suivants :

# Indique que la valeur doit être convertie en une autre forme. Pour les conversions
o le premier caractère de la chaîne de sortie vaudra zéro (en ajoutant un préfixe 0
si ce n'est pas déjà un zéro). Pour les conversions x et X un résultat non nul
reçoit le préfixe « 0x » (ou « 0X » pour l'indicateur X). Pour les conversions a,
A, e, E, f, F, g et G, le résultat contiendra toujours un point décimal même si
aucun chiffre ne le suit (normalement, un point décimal n'est présent avec ces
conversions que si des décimales le suivent). Pour les conversions g et G, les
zéros en tête ne sont pas éliminés, contrairement au comportement habituel. Pour
les autres conversions, le résultat est indéfini.

0 Indique le remplissage avec des zéros. Pour les conversions d, i, o, u, x, X, a, A,
e, E, f, F, g et G, la valeur est complétée à gauche par des zéros plutôt que par
des espaces. Si les attributs 0 et - apparaissent ensemble, l'attribut 0 est
ignoré. Si une précision est fournie avec une conversion numérique (d, i, o, u, x
et X), l'attribut 0 est ignoré. Pour les autres conversions, le comportement est
indéfini.

- Indique que la valeur convertie doit être justifiée sur la limite gauche du champ
(par défaut elle l'est à droite). Les valeurs sont complétées à droite par des
espaces, plutôt qu'à gauche par des zéros ou des espaces. Un attribut - surcharge
un attribut 0 si les deux sont fournis.

' ' (une espace) Un blanc indique qu'une espace doit être laissée avant un nombre
positif (ou une chaîne vide) produit par une conversion signée

+ Un signe (+ ou -) doit toujours être placé avant un nombre produit par une
conversion signée. Par défaut, un signe n'est utilisé que pour les valeurs
négatives. Un attribut + surcharge un attribut « espace » si les deux sont fournis.

Les cinq caractères d'attributs ci-dessus sont définis dans la norme C99, les
Spécifications UNIX Single en ajoutent un :

' Les conversions décimales (i, d, u, f, F, g et G) indiquent que les chiffres d'un
argument numérique doivent être groupés par milliers en fonction de la localisation
(consultez setlocale(3)). Remarquez que de nombreuses versions de gcc(1)
n'acceptent pas cet attribut et déclencheront un avertissement (SUSv2 n'inclue pas
%'F, mais SUSv3 l'a ajouté).

La glibc 2.2 ajoute un caractère d'attribut supplémentaire.

I Pour les conversions décimales (i, d et u), la sortie emploie les chiffres de la
localisation alternative s'il y en a une. Par exemple, depuis la glibc 2.2.3, cela
donnera des chiffres arabes pour la localisation perse (« fa_IR »).

Largeur de champ
Un nombre optionnel ne commençant pas par un zéro, peut indiquer une largeur minimale de
champ. Si la valeur convertie occupe moins de caractères que cette largeur, elle sera
complétée par des espaces à gauche (ou à droite si l'attribut d'alignement à gauche a été
fourni). À la place de la chaîne représentant le nombre décimal, on peut écrire « * » ou
« *m$ » (m étant entier) pour indiquer que la largeur du champ est fournie dans l'argument
suivant ou dans le m-ième argument respectivement. L'argument fournissant la largeur doit
être de type int. Une largeur négative est considérée comme l'attribut « - », vu plus
haut, suivi d'une largeur positive. En aucun cas une largeur trop petite ne provoque la
troncature du champ. Si le résultat de la conversion est plus grand que la largeur
indiquée, le champ est élargi pour contenir le résultat.

Précision
Une précision optionnelle, sous la forme d'un point (« . ») suivi par une chaîne
optionnelle de nombres décimaux. À la place de la chaîne représentant le nombre décimal,
on peut écrire « * » ou « *m$ » (m étant entier) pour indiquer que la précision est
fournie dans l'argument suivant ou dans le m-ième argument respectivement, et qui doit
être de type int. Si la précision ne contient que le caractère « . », elle est considérée
comme zéro. Une précision négative est considérée comme omise. Cette précision indique un
nombre minimal de chiffres à faire apparaître lors des conversions d, i, o, u, x et X, le
nombre de décimales à faire apparaître pour les conversions a, A, e, E, f et F, le nombre
maximal de chiffres significatifs pour g et G et le nombre maximal de caractères à
imprimer depuis une chaîne pour les conversions s et S.

Modificateur de longueur
Ici, une « conversion d’entier » correspond à d, i, o, u, x ou X.

hh La conversion d’entier suivante correspond à un signed char ou à un unsigned char,
ou la conversion n suivante correspond à un pointeur sur un argument signed char.

h La conversion d’entier suivante correspond à un short ou à un unsigned short, ou la
conversion n suivante correspond à un pointeur sur un argument short.

l (lettre l) La conversion d’entier suivante correspond à un argument long ou
unsigned long, ou la conversion n suivante correspond à un pointeur sur un argument
long, ou la conversion c suivante correspond à un argument wint_t, ou encore la
conversion s suivante correspond à un pointeur sur un argument wchar_t.

ll (lettre l en double). La conversion d’entier suivante correspond à un long long ou
à un unsigned long long, ou la conversion n suivante correspond à un pointeur sur
un long long.

q Un synonyme de ll. Il s'agit d'une extension non standard, dérivée de BSD ; évitez
son utilisation dans du nouveau code.

L La conversion a, A, e, E, f, F, g ou G suivante correspond à un argument
long double (C99 autorise %LF mais pas SUSv2).

j La conversion d’entier suivante correspond à un argument intmax_t ou uintmax_t, ou
la conversion n suivante correspond à un pointeur sur un argument intmax_t.

z La conversion d’entier suivante correspond à un argument size_t ou ssize_t, ou la
conversion n suivante correspond à un pointeur sur un argument size_t.

Z Un synonyme non standard de z qui précède l'apparition de z. Ne pas l'utiliser dans
du nouveau code.

t La conversion d’entier suivante correspond à un argument ptrdiff_t, ou la
conversion n suivante correspond à un pointeur sur un argument ptrdiff_t.

SUSv3 mentionne tous les modificateurs précédents à l'exception des extensions non
standard. Les spécifications SUSv2 ne mentionnent que les modificateurs de longueur h
(dans hd, hi, ho, hx, hX et hn), l (dans ld, li, lo, lx, lX, ln, lc et ls) et L (dans Le,
LE, Lf, Lg et LG).

En tant qu’extension non standard, l'implémentation GNU traite ll et L comme des synonymes
de façon à ce qu'il soit possible, par exemple, d'écrire llg (comme synonyme conforme aux
standards de Lg) et Ld (comme synonyme conforme aux standards de lld). Une telle
utilisation n'est pas portable.

Indicateurs de conversion
Un caractère indique le type de conversion à apporter. Les indicateurs de conversion et
leurs significations sont :

d, i L'argument int est converti en un chiffre décimal signé. La précision, si elle est
mentionnée, correspond au nombre minimal de chiffres qui doivent apparaître. Si la
conversion fournit moins de chiffres, le résultat est rempli à gauche avec des
zéros. Par défaut la précision vaut 1. Lorsque 0 est converti avec une précision
valant 0, la sortie est vide.

o, u, x, X
L'argument unsigned int est converti en un chiffre octal non signé (o), un chiffre
décimal non signé (u) ou un chiffre hexadécimal non signé (x et X). Les lettres
abcdef sont utilisées pour les conversions avec x, les lettres ABCDEF sont
utilisées pour les conversions avec X. La précision, si elle est indiquée, donne un
nombre minimal de chiffres à faire apparaître. Si la valeur convertie nécessite
moins de chiffres, elle est complétée à gauche avec des zéros. La précision par
défaut vaut 1. Lorsque 0 est converti avec une précision valant 0, la sortie est
vide.

e, E L'argument, de type double, est arrondi et présenté avec la notation scientifique
[-]c.ccce±cc dans lequel se trouve un chiffre (qui n'est pas nul si l'argument
n'est pas nul) avant le point, puis un nombre de décimales égal à la précision
demandée. Si la précision n'est pas indiquée, l'affichage contiendra 6 décimales.
Si la précision vaut zéro, il n'y a pas de point décimal. Une conversion E utilise
la lettre E (plutôt que e) pour introduire l'exposant. Celui-ci contient toujours
au moins deux chiffres. Si la valeur affichée est nulle, son exposant est 00.

f, F L'argument, de type double, est arrondi et présenté avec la notation classique
[-]ccc.ccc, où le nombre de décimales est égal à la précision réclamée. Si la
précision n'est pas indiquée, l'affichage se fera avec 6 décimales. Si la précision
vaut zéro, aucun point n'est affiché. Lorsque le point est affiché, il y a toujours
au moins un chiffre devant.

SUSv2 ne mentionne pas F et dit qu'une représentation des chaînes de caractères
pour l'infini ou NaN devrait être disponible. SUSv3 ajoute l'indicateur F. La norme
C99 précise « [-]inf » ou « [-]infinity » pour les infinis, et une chaîne
commençant par « nan » pour NaN dans le cas d'une conversion f, et les chaînes
« [-]INF », « [-]INFINITY » ou « NAN* » pour une conversion F.

g, G L'argument, de type double, est converti en style f ou e (F ou E pour la conversion
G). La précision indique le nombre de décimales significatives. Si la précision est
absente, une valeur par défaut de 6 est utilisée. Si la précision vaut 0, elle est
considérée comme valant 1. La notation scientifique e est utilisée si l'exposant
est inférieur à -4 ou supérieur ou égal à la précision demandée. Les zéros en fin
de partie décimale sont supprimés. Un point décimal n'est affiché que s'il est
suivi d'au moins un chiffre.

a, A (C99, pas dans SUSv2, mais rajouté dans SUSv3). Pour la conversion a, l'argument de
type double est transformé en notation hexadécimale (avec les lettres abcdef) de
forme [-]0xh.hhhhp±d ; pour la conversion A, le préfixe 0X, les lettres ABCDEF et
le séparateur d'exposant P sont utilisés. Il y a un chiffre hexadécimal avant la
virgule et le nombre de chiffres ensuite est égal à la précision. La précision par
défaut suffit pour une représentation exacte de la valeur, si une représentation
exacte est possible en base 2. Sinon, elle est suffisamment grande pour distinguer
les valeurs de type double. Le chiffre avant le point décimal n'est pas spécifié
pour les nombres non normalisés et il est non nul mais non spécifié pour les
nombres normalisés.

c S'il n'y a pas de modificateur l, l'argument, de type int, est converti en un
unsigned char et le caractère correspondant est affiché. Si un modificateur l est
présent, l'argument de type wint_t (caractère large) est converti en séquence
multioctet par un appel à wcrtomb(3), avec un état de conversion débutant dans
l'état initial. La chaîne multioctet résultante est écrite.

s S'il n'y a pas de modificateur l, l'argument de type const char * est supposé être
un pointeur sur un tableau de caractères (pointeur sur une chaîne). Les caractères
du tableau sont écrits jusqu'à l'octet NULL final (« \0 »), non compris. Si une
précision est indiquée, seul ce nombre de caractères est écrit. Si une précision
est fournie, il n'y a pas besoin d'octet NULL. Si la précision n'est pas donnée, ou
si elle est supérieure à la longueur du tableau, l'octet NULL final est nécessaire.

Si un modificateur l est présent, l'argument de type const wchar_t * est supposé
être un pointeur sur un tableau de caractères larges. Les caractères larges du
tableau sont convertis en une séquence de caractères multioctets (chacun par un
appel de wcrtomb(3), avec un état de conversion dans l'état initial avant le
premier caractère large), cela jusqu'au caractère large NULL final compris. Les
caractères multioctets résultants sont écrits jusqu'à l’octet NULL final (non
compris). Si une précision est fournie, il n'y a pas plus d'octets écrits que la
précision indiquée, mais aucun caractère multioctet n'est écrit partiellement.
Remarquez que la précision concerne le nombre d'octets écrits et non pas le nombre
de caractères larges ou de positions d'écrans. La chaîne doit contenir un caractère
large NULL final, sauf si une précision est indiquée et est suffisamment petite
pour que le nombre d'octets écrits la remplisse avant la fin de la chaîne.

C (Ni dans C99, ni dans C11, mais dans SUSv2, SUSv3 et SUSv4). Synonyme de lc. Ne pas
utiliser.

S (Ni dans C99, ni dans C11, mais dans SUSv2, SUSv3 et SUSv4). Synonyme de ls. Ne pas
utiliser.

p L'argument pointeur, du type void * est affiché en hexadécimal, comme avec %#x ou
%#lx.

n Le nombre de caractères écrits jusqu'à présent est stocké dans l'entier pointé par
l'argument correspondant. Cet argument doit être un int * ou une variante dont la
taille correspond au modificateur de longueur d'entier optionnellement fourni.
Aucun argument n'est converti (cet indicateur n'est pas pris en charge par la
bibliothèque C Bionic). Le comportement n'est pas défini si la spécification de
conversion comporte un drapeau, une longueur de champ ou une précision.

m (extension glibc ; pris en charge par uClibc et musl) Affiche la sortie
strerror(errno). Aucun argument n'est requis.

% Un caractère « % » est écrit. Il n'y a pas de conversion. L'indicateur complet est
« %% ».

VALEUR RENVOYÉE

       En cas de succès, ces fonctions renvoient le nombre de caractères affichés  (sans  compter
       l'octet NULL final utilisé pour terminer les sorties dans les chaînes).

       Les  fonctions  snprintf()  et vsnprintf() n'écrivent pas plus de taille octets (y compris
       l'octet NULL final). Si la sortie a été tronquée à cause de la limite, la valeur de retour
       est le nombre de caractères (octet NULL final non compris) qui auraient été écrits dans la
       chaîne s'il y avait eu suffisamment de place. Ainsi, une valeur de retour taille  ou  plus
       signifie que la sortie a été tronquée (consultez aussi la section NOTES plus bas).

       Si une erreur de sortie s'est produite, une valeur négative est renvoyée.

ATTRIBUTS

       Pour une explication des termes utilisés dans cette section, consulter attributes(7).

       ┌────────────────────────┬──────────────────────┬────────────────┐
       │Interface               │ Attribut             │ Valeur         │
       ├────────────────────────┼──────────────────────┼────────────────┤
       │printf(), fprintf(),    │ Sécurité des threads │ MT-Safe locale │
       │sprintf(), snprintf(),  │                      │                │
       │vprintf(), vfprintf(),  │                      │                │
       │vsprintf(), vsnprintf() │                      │                │
       └────────────────────────┴──────────────────────┴────────────────┘

CONFORMITÉ

       fprintf(),   printf(),   sprintf(),   vprintf(),  vfprintf(),  vsprintf() :  POSIX.1-2001,
       POSIX.1-2008, C89, C99.

       snprintf(), vsnprintf() : POSIX.1-2001, POSIX.1-2008, C99.

       dprintf()  et  vdprintf()  sont  originellement  des  extensions  GNU.   Elles   ont   été
       standardisées dans POSIX.1-2008.

       En ce qui concerne la valeur de retour de snprintf(), SUSv2 et C99 sont en contradiction :
       lorsque snprintf() est appelée avec un argument taille=0,  SUSv2  précise  une  valeur  de
       retour  indéterminée,  inférieure  à  1, alors que C99 autorise chaîne à être NULL dans ce
       cas, et renvoie (comme toujours) le nombre de caractères qui auraient  été  écrits  si  la
       chaîne   de  sortie  avait  été  assez  grande.  Les  spécifications  de  snprintf()  dans
       POSIX.1-2001 et ses versions supérieures sont alignées avec C99.

       La bibliothèque glibc 2.1 ajoute les modificateurs de longueur  hh,  j,  t  et  z  et  les
       caractères de conversion a et A.

       La bibliothèque glibc 2.2 ajoute le caractère de conversion F avec la sémantique C99 et le
       caractère d'attribut I.

NOTES

       Certains programmes reposent imprudemment sur du code comme :

           sprintf(buf, "%s texte supplémentaire", buf);

       pour ajouter du texte à buf. Cependant, les normes indiquent explicitement que le résultat
       n'est  pas défini si les tampons de source et de destination se recouvrent lors d'un appel
       à sprintf(), snprintf(), vsprintf() et vsnprintf(). En fonction de la  version  de  gcc(1)
       utilisée et des options de compilation, ces appels ne produiront pas le résultat attendu.

       L'implémentation  des  fonctions  snprintf()  et  vsnprintf() de la glibc se conforme à la
       norme C99, et se  comporte  comme  décrit  plus  haut  depuis  la  glibc 2.1.  Jusqu'à  la
       glibc 2.0.6, elles renvoyaient -1 si la sortie avait été tronquée.

BOGUES

       Comme  sprintf() et vsprintf() ne font pas de suppositions sur la longueur des chaînes, le
       programme appelant doit s'assurer de ne pas déborder l'espace d'adressage.  C'est  souvent
       difficile.  Notez  que  la  longueur  des chaînes peut varier avec la localisation et être
       difficilement prévisible. Il faut alors utiliser snprintf() ou vsnprintf() à la place  (ou
       encore asprintf(3) et vasprintf(3)).

       Un  code  tel  que  printf(toto);  indique  souvent  un  bogue,  car toto peut contenir un
       caractère « % ». Si toto vient d'une saisie non sécurisée, il peut  contenir  %n,  ce  qui
       autorise printf() à écrire dans la mémoire, et crée une faille de sécurité.

EXEMPLES

       Pour afficher Pi avec cinq décimales :

           #include <math.h>
           #include <stdio.h>
           fprintf (stdout, "pi = %.5f\n", 4 * atan (1.0));

       Pour  afficher  une  date  et  une  heure  sous  la  forme  « Sunday,  July 3, 23:15 », où
       jour_semaine et mois sont des pointeurs sur des chaînes :

           #include <stdio.h>
           fprintf(stdout, "%s, %s %d, %.2d:%.2d\n",
                   jour_semaine, mois, jour, heure, minute);

       De nombreux pays utilisent un format de date différent, comme jour-mois-année. Une version
       internationale doit donc être capable d'afficher les arguments dans l'ordre indiqué par le
       format :

           #include <stdio.h>
           fprintf(stdout, format,
                   jour_semaine, mois, jour, heure, min);

       où le format dépend de la localisation et peut permuter les arguments. Avec la valeur :

           "%1$s, %3$d. %2$s, %4$d:%5$.2d"

       On peut obtenir « Dimanche, 3 juillet, 23:15 ».

       Pour allouer une chaîne de taille suffisante et écrire dedans  (code  correct  aussi  bien
       pour la glibc 2.0 que pour la glibc 2.1) :

       #include <stdio.h>
       #include <stdlib.h>
       #include <stdarg.h>

       char *
       make_message(const char *fmt, ...)
       {
           int n = 0;
           size_t size = 0;
           char *p = NULL;
           va_list ap;

           /* Déterminer la taille requise */

           va_start(ap, fmt);
           n = vsnprintf(p, size, fmt, ap);
           va_end(ap);

           if (n < 0)
               return NULL;

           /* Un octet supplémentaire pour « \0 » */

           size = (size_t) n + 1;
           p = malloc(size);
           if (p == NULL)
               renvoie NULL;

           va_start(ap, fmt);
           n = vsnprintf(p, size, fmt, ap);
           va_end(ap);

           if (n < 0) {
               free(p);
               return NULL;
           }

           return p;
       }

       En  cas de troncature dans les versions de la glibc avant la 2.0.6, c'est traité comme une
       erreur au lieu d'être traité de façon élégante.

VOIR AUSSI

       printf(1),  asprintf(3),  puts(3),  scanf(3),   setlocale(3),   strfromd(3),   wcrtomb(3),
       wprintf(3), locale(5)

COLOPHON

       Cette  page  fait partie de la publication 5.10 du projet man-pages Linux. Une description
       du projet et des instructions pour signaler des anomalies et la dernière version de  cette
       page peuvent être trouvées à l'adresse https://www.kernel.org/doc/man-pages/.

TRADUCTION

       La  traduction  française  de  cette  page  de  manuel  a  été créée par Christophe Blaess
       <https://www.blaess.fr/christophe/>, Stéphan  Rafin  <stephan.rafin@laposte.net>,  Thierry
       Vignaud  <tvignaud@mandriva.com>,  François Micaux, Alain Portal <aportal@univ-montp2.fr>,
       Jean-Philippe   Guérard   <fevrier@tigreraye.org>,   Jean-Luc   Coulon   (f5ibh)    <jean-
       luc.coulon@wanadoo.fr>,    Julien    Cristau    <jcristau@debian.org>,    Thomas   Huriaux
       <thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centraliens.net>, Florentin
       Duneau  <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-bretagne.fr>, Denis
       Barbier  <barbier@debian.org>,  David  Prévot   <david@tilapin.org>,   Frédéric   Hantrais
       <fhantrais@gmail.com> et Grégoire Scano <gregoire.scano@malloc.fr>

       Cette  traduction  est  une  documentation libre ; veuillez vous reporter à la GNU General
       Public  License  version 3  ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩   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 ⟨⟩.