NOM¶
asprintf, vasprintf - Écriture formatée dans une chaîne
allouée
SYNOPSIS¶
#define _GNU_SOURCE /* Consultez
feature_test_macros(7) */
#include <stdio.h>
int asprintf(char **strp, const char *fmt,
...);
int vasprintf(char **strp, const char *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 nul final ('\0') et qu'elles renvoient un pointeur
vers cette chaîne via le 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.
Ces fonctions sont des extensions GNU et sont absentes des standards 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)
COLOPHON¶
Cette page fait partie de la publication 3.65 du projet
man-pages Linux.
Une description du projet et des instructions pour signaler des anomalies
peuvent être trouvées à l'adresse
http://www.kernel.org/doc/man-pages/.
TRADUCTION¶
Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a
<
http://po4a.alioth.debian.org/> par l'équipe de traduction
francophone au sein du projet perkamon
<
http://perkamon.alioth.debian.org/>.
Stéphan Rafin (2002), Alain Portal
<
http://manpagesfr.free.fr/> (2006). Florentin Duneau et
l'équipe francophone de traduction de Debian (2006-2009).
Veuillez signaler toute erreur de traduction en écrivant à
<debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
paquet
manpages-fr.
Vous pouvez toujours avoir accès à la version anglaise de ce
document en utilisant la commande «
man -L C
<section>
<page_de_man> ».
