1. NOM

asprintf, vasprintf - Écriture formatée dans une chaîne allouée

2. 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);

3. 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.

4. 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.

5. CONFORMITÉ

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.

6. VOIR AUSSI

free(3), malloc(3), printf(3)

7. COLOPHON

Cette page fait partie de la publication 3.52 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/.

8. 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 à <>.

Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « LC_ALL=C man <section> <page_de_man> ».