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 │
       └───────────────────────────────────────────────────────────────┴──────────────────────┴────────────────┘

VERSIONS

       L'implémentation de FreeBSD définit strp à NULL en cas d'erreur.

STANDARDS

       GNU, BSD.

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

Pages du manuel de Linux 6.9.1                    15 juin 2024                                       asprintf(3)