fprintf, , _fprintf_l, _fwprintf_lfwprintf, , _ftprintf_ftprintf_l

Envoient les données mises en forme vers un flux. Des versions plus sécurisées de ces fonctions sont disponibles ; voir , , fwprintf_s_fprintf_s_l, _fwprintf_s_l.fprintf_s

Pour _ftprintf et _ftprintf_l, consultez les mappages de fonctions de texte générique.

Syntaxe

int fprintf(
   FILE *stream,
   const char *format [,
   argument ]...
);
int _fprintf_l(
   FILE *stream,
   const char *format,
   _locale_t locale [,
   argument ]...
);
int fwprintf(
   FILE *stream,
   const wchar_t *format [,
   argument ]...
);
int _fwprintf_l(
   FILE *stream,
   const wchar_t *format,
   _locale_t locale [,
   argument ]...
);

Paramètres

stream
Pointeur vers la structure FILE .

format
Chaîne de contrôle de format.

argument
Arguments facultatifs.

locale
Paramètres régionaux à utiliser.

Valeur retournée

fprintf retourne le nombre d’octets écrits. fwprintf retourne le nombre de caractères larges écrits. Chacune de ces fonctions retourne une valeur négative à la place en cas d’erreur de sortie. Si stream ou format est NULL, ces fonctions appellent le gestionnaire de paramètres non valide, comme décrit dans la validation des paramètres. Si l'exécution est autorisée à se poursuivre, ces fonctions retournent -1 et définissent errno avec la valeur EINVAL. La chaîne de format n’est pas vérifiée pour les caractères de mise en forme valides, car elle est utilisée fprintf_s ou fwprintf_s.

Pour plus d’informations sur les codes de retour, consultez , , _sys_errlist_doserrnoet _sys_nerr.errno

Notes

fprintf met en forme et envoie une série de caractères et de valeurs vers la sortie stream. Chaque fonction argument (le cas échéant) est convertie et sortie selon la spécification de format correspondante dans format. Pour fprintf, l’argument format a la même syntaxe que dans printf.

fwprintf est une version à caractères larges de fprintf ; dans fwprintf, format est une chaîne à caractères larges. Ces fonctions se comportent de la même façon si le flux est ouvert en mode ANSI. fprintf ne prend pas en charge la sortie vers un flux UNICODE pour l’instant.

Les versions de ces fonctions avec le suffixe _l sont identiques, sauf qu'elles utilisent les paramètres régionaux passés au lieu des paramètres régionaux du thread actuel.

Mappages de fonctions de texte générique

La fonction dans la tchar.h colonne est mappée à la fonction dans les autres colonnes en fonction du jeu de caractères défini au moment de la compilation.

Pour plus d’informations, consultez Syntaxe de spécification de format.

Spécifications

Pour plus d’informations sur la compatibilité, consultez Compatibility.

Exemple

// crt_fprintf.c
/* This program uses fprintf to format various
* data and print it to the file named FPRINTF.OUT. It
* then displays FPRINTF.OUT on the screen using the system
* function to invoke the operating-system TYPE command.
*/

#include <stdio.h>
#include <process.h>

FILE *stream;

int main( void )
{
   int    i = 10;
   double fp = 1.5;
   char   s[] = "this is a string";
   char   c = '\n';

   fopen_s( &stream, "fprintf.out", "w" );
   fprintf( stream, "%s%c", s, c );
   fprintf( stream, "%d\n", i );
   fprintf( stream, "%f\n", fp );
   fclose( stream );
   system( "type fprintf.out" );
}

this is a string
10
1.500000

Voir aussi

E/S de flux
_cprintf, , _cprintf_l_cwprintf, ,_cwprintf_l
fscanf, , _fscanf_lfwscanf, ,_fwscanf_l
sprintf, , _sprintf_lswprintf, , _swprintf_l_swprintf_l
Syntaxe de spécification de format : printf et wprintf fonctions