fprintf, _fprintf_l, fwprintf, _fwprintf_l

 

Pour obtenir la dernière documentation sur Visual Studio 2017 RC, consultez Documentation Visual Studio 2017 RC.

Imprimer des données mises en forme dans un flux. Des versions plus sécurisées de ces fonctions sont disponibles. consultez la page fprintf_s, _fprintf_s_l, fwprintf_s, _fwprintf_s_l.

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.

fprintfRetourne le nombre d’octets écrits. fwprintfRetourne le nombre de caractères larges. Chacune de ces fonctions retourne une valeur négative à la place lorsque se produit une erreur de sortie. Si stream ou format est NULL, ces fonctions appellent le Gestionnaire de paramètre non valide, comme décrit dans Validation de paramètre. 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 est désactivée pour les caractères de mise en forme valides comme c’est le cas d’utilisation fprintf_s ou fwprintf_s.

Consultez la page _doserrno, errno, _sys_errlist et _sys_nerr pour plus d’informations sur les autres codes d’erreur.

fprintfmet en forme et imprime une série de caractères et de valeurs à la sortie stream . Chaque fonction argument (le cas échéant) est converti et sorti selon la spécification de format correspondante dans format . Pour fprintf, le format argument a la même syntaxe et utilisation de printf.

fwprintfest une version à caractère élargi de fprintf; dans fwprintf, format est une chaîne à caractères larges. Ces fonctions se comportent comme si le flux est ouvert en mode ANSI. fprintfne prend pas en charge sortie dans un flux de données UNICODE.

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.

System_CAPS_ICON_important.jpg Important

Assurez-vous que format n'est pas une chaîne définie par l'utilisateur.

Mappages de routines de texte générique

Routine TCHAR.H_UNICODE et _MBCS non définis_MBCS défini_UNICODE défini
_ftprintffprintffprintffwprintf
_ftprintf_l_fprintf_l_fprintf_l_fwprintf_l

Pour plus d'informations, consultez Spécifications de format.

FonctionEn-tête requis
fprintf, _fprintf_l<stdio.h>
fwprintf, _fwprintf_l<stdio.h> ou <wchar.h>

Pour plus d'informations sur la compatibilité, voir Compatibilité dans l'introduction.

// 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  

System::IO::StreamWriter::Write

Flux d’e/s
_cprintf, _cprintf_l, _cwprintf, _cwprintf_l
fscanf, _fscanf_l, fwscanf, _fwscanf_l
sprintf, _sprintf_l, swprintf, _swprintf_l, __swprintf_l
Syntaxe de spécification de format : les fonctions printf et wprintf

Afficher: