.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 2001, Andries E. Brouwer <aeb@cwi.nl>
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH asprintf 3 "8 février 2026" "Pages du manuel de Linux 6.18" 
.SH NOM
asprintf, vasprintf \- Écriture formatée dans une chaîne allouée
.SH BIBLIOTHÈQUE
Bibliothèque C standard (\fIlibc\fP,\ \fI\-lc\fP)
.SH SYNOPSIS
.nf
\fB#define _GNU_SOURCE\fP         /* Consultez feature_test_macros(7) */
\fB#include <stdio.h>\fP
.P
\fBint asprintf(char **restrict \fP\fIstrp\fP\fB, const char *restrict \fP\fIfmt\fP\fB, ...);\fP
\fBint vasprintf(char **restrict \fP\fIstrp\fP\fB, const char *restrict \fP\fIfmt\fP\fB,\fP
\fB              va_list \fP\fIap\fP\fB);\fP
.fi
.SH DESCRIPTION
Les fonctions \fBasprintf\fP() et \fBvasprintf\fP() sont similaires à
\fBsprintf\fP(3) et \fBvsprintf\fP(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 (\[aq]\[rs]0\[aq]), et qu'elles renvoient un pointeur vers cette
chaîne à l’aide du premier paramètre. Ce pointeur devra être passé en
paramètre à \fBfree\fP(3) afin de libérer la zone allouée lorsqu'elle ne sera
plus nécessaire.
.SH "VALEUR RENVOYÉE"
En cas de succès, ces fonctions renvoient le nombre de caractères imprimés,
tout comme \fBsprintf\fP(3). En cas d'erreur, \fB\-1\fP est renvoyé, \fIerrno\fP est
défini pour indiquer l'erreur, et le contenu de \fIstrp\fP est indéfini.
.SH ERREURS
Voir \fBsprintf\fP(3) et \fBmalloc\fP(3).
.SH ATTRIBUTS
Pour une explication des termes utilisés dans cette section, consulter
\fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
Interface	Attribut	Valeur
T{
.na
.nh
\fBasprintf\fP(),
\fBvasprintf\fP()
T}	Sécurité des threads	MT\-Safe locale
.TE
.SH VERSIONS
L'implémentation de FreeBSD définit \fIstrp\fP à NULL en cas d'erreur.
.SH NORMES
GNU, BSD.
.SH "VOIR AUSSI"
\fBfree\fP(3), \fBmalloc\fP(3), \fBprintf\fP(3)
.PP
.SH 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>
.
.PP
Cette traduction est une documentation libre ; veuillez vous reporter à la
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License version 3
.UE
concernant les conditions de copie et 
de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.
.PP
Si vous découvrez un bogue dans la traduction de cette page de manuel, 
veuillez envoyer un message à
.MT debian-l10n-french@lists.debian.org
.ME .