asprintf, vasprintf - Écriture formatée dans une chaîne
allouée
Bibliothèque C standard (
libc,
-lc)
#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);
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.
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.
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 |
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.
free(3),
malloc(3),
printf(3)
La traduction française de cette page de manuel a été
créée par Christophe Blaess
<
https://www.blaess.fr/christophe/>, Stéphan Rafin
<
[email protected]>, Thierry Vignaud
<
[email protected]>, François Micaux, Alain Portal
<
[email protected]>, Jean-Philippe Guérard
<
[email protected]>, Jean-Luc Coulon (f5ibh)
<
[email protected]>, Julien Cristau
<
[email protected]>, Thomas Huriaux <
[email protected]>,
Nicolas François <
[email protected]>, Florentin
Duneau <
[email protected]>, Simon Paillard
<
[email protected]>, Denis Barbier
<
[email protected]>, David Prévot <
[email protected]>,
Frédéric Hantrais <
[email protected]> et Jean-Pierre
Giraud <
[email protected]>
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 à
[email protected]