asprintf(3) Library Functions Manual asprintf(3)
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 im-
primés, tout comme sprintf(3). Si l'allocation mémoire n'a pas été pos-
sible, 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 disponibles 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 Chris-
tophe Blaess <https://www.blaess.fr/christophe/>, Stéphan Rafin <ste-
phan.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.cou-
lon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas Huriaux
<thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centra-
liens.net>, Florentin Duneau <fduneau@gmail.com>, Simon Paillard <si-
mon.paillard@resel.enst-bretagne.fr>, Denis Barbier <barbier@de-
bian.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
⟨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⟩.
Pages du manuel de Linux 6.03 5 février 2023 asprintf(3)
Generated by dwww version 1.15 on Sat Jun 29 01:33:05 CEST 2024.