NOM

       asprintf, vasprintf - Écriture formatée dans une chaîne allouée

BIBLIOTHÈQUE

       Bibliothèque C standard (libc, -lc)

SYNOPSIS

       #define _GNU_SOURCE         /* Consultez feature_test_macros(7) */
       #include <stdio.h>

       int asprintf(char **restrict strp, const char *restrict fmt, ...);
       int vasprintf(char **restrict strp, const char *restrict fmt,
                     va_list ap);

DESCRIPTION

       Les fonctions asprintf() et vasprintf() sont similaires à sprintf(3) et vsprintf(3), si ce n'est qu'elles
       allouent  une  chaîne  de caractères de taille suffisante pour contenir la sortie, y compris l'octet NULL
       final ('\0'), et qu'elles renvoient un pointeur vers cette chaîne  à  l’aide  du  premier  paramètre.  Ce
       pointeur devra être passé en paramètre à free(3) afin de libérer la zone allouée lorsqu'elle ne sera plus
       nécessaire.

VALEUR RENVOYÉE

       En  cas  de  succès,  ces fonctions renvoient le nombre de caractères imprimés, tout comme sprintf(3). Si
       l'allocation mémoire n'a pas été possible, ou qu'une autre erreur est survenue, ces  fonctions  renvoient
       -1 et la valeur de strp est indéfinie.

ATTRIBUTS

       Pour une explication des termes utilisés dans cette section, consulter attributes(7).
       ┌───────────────────────────────────────────────────────────────┬──────────────────────┬────────────────┐
       │ Interface                                                     │ Attribut             │ Valeur         │
       ├───────────────────────────────────────────────────────────────┼──────────────────────┼────────────────┤
       │ asprintf(), vasprintf()                                       │ Sécurité des threads │ MT-Safe locale │
       └───────────────────────────────────────────────────────────────┴──────────────────────┴────────────────┘

STANDARDS

       Ces fonctions sont des extensions GNU et sont absentes des normes C et POSIX. Elles sont également dispo‐
       nibles sous *BSD. L'implémentation FreeBSD affecte à strp la valeur NULL en cas d'erreur.

VOIR AUSSI

       free(3), malloc(3), printf(3)

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  <tvi‐
       gnaud@mandriva.com>,  François  Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe Guérard <fe‐
       vrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-luc.coulon@wanadoo.fr>, Julien Cristau  <jcristau@de‐
       bian.org>,   Thomas   Huriaux   <thomas.huriaux@gmail.com>,  Nicolas  François  <nicolas.francois@centra‐
       liens.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   <fhan‐
       trais@gmail.com> et Jean-Pierre Giraud <jean-pierregiraud@neuf.fr>

       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 à  de‐
       bian-l10n-french@lists.debian.org.

Pages du manuel de Linux 6.03                    5 février 2023                                      asprintf(3)