.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright (C) 2001 Andries Brouwer <aeb@cwi.nl>
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\" Text fragments inspired by Martin Schulze <joey@infodrom.org>.
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH asprintf 3 "5 février 2023" "Pages du manuel de Linux 6.03" 
.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
.PP
\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]\e0\[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). Si l'allocation mémoire n'a pas été possible, ou
qu'une autre erreur est survenue, ces fonctions renvoient \fB\-1\fP et la valeur
de \fIstrp\fP est indéfinie.
.SH ATTRIBUTS
Pour une explication des termes utilisés dans cette section, consulter
\fBattributes\fP(7).
.ad l
.nh
.TS
allbox;
lbx lb lb
l l l.
Interface	Attribut	Valeur
T{
\fBasprintf\fP(),
\fBvasprintf\fP()
T}	Sécurité des threads	MT\-Safe locale
.TE
.hy
.ad
.sp 1
.SH 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 à \fIstrp\fP la valeur NULL en cas d'erreur.
.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 .