fprintf, _fprintf_l, fwprintf, _fwprintf_lfprintf, _fprintf_l, fwprintf, _fwprintf_l

Envoient les données mises en forme vers un flux.Print formatted data to a stream. Il existe des versions plus sécurisées de ces fonctions. Consultez fprintf_s, _fprintf_s_l, fwprintf_s, _fwprintf_s_l.More secure versions of these functions are available; see fprintf_s, _fprintf_s_l, fwprintf_s, _fwprintf_s_l.

SyntaxeSyntax

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ètresParameters

streamstream
Pointeur désignant la structure FILE.Pointer to FILE structure.

formatformat
Chaîne de contrôle de format.Format-control string.

argumentargument
Arguments facultatifs.Optional arguments.

localelocale
Paramètres régionaux à utiliser.The locale to use.

Valeur de retourReturn Value

fprintf retourne le nombre d’octets écrits.fprintf returns the number of bytes written. fwprintf retourne le nombre de caractères larges écrits.fwprintf returns the number of wide characters written. Chacune de ces fonctions retourne une valeur négative à la place en cas d’erreur de sortie.Each of these functions returns a negative value instead when an output error occurs. Si Stream ou format a la valeur null, ces fonctions appellent le gestionnaire de paramètres non valides, comme décrit dans validation de paramètre.If stream or format is NULL, these functions invoke the invalid parameter handler, as described in Parameter Validation. Si l’exécution est autorisée à se poursuivre, les fonctions retournent-1 et attribuent à errno la valeur EINVAL.If execution is allowed to continue, the functions return -1 and set errno to EINVAL. La chaîne de format n’est pas vérifiée pour les caractères de mise en forme valides, comme c’est le cas lors de l’utilisation de fprintf_s ou fwprintf_s.The format string is not checked for valid formatting characters as it is when using fprintf_s or fwprintf_s.

Pour plus d’informations sur ces codes d’erreur et les autres, consultez _doserrno, errno, _sys_errlist et _sys_nerr.See _doserrno, errno, _sys_errlist, and _sys_nerr for more information on these, and other, error codes.

NotesRemarks

fprintf met en forme et imprime une série de caractères et de valeurs dans le fluxde sortie.fprintf formats and prints a series of characters and values to the output stream. Chaque argument de fonction (le cas échéant) est converti et sorti selon la spécification de format correspondante au format.Each function argument (if any) is converted and output according to the corresponding format specification in format. Pour fprintf, l’argument de format a la même syntaxe et utilise dans printf.For fprintf, the format argument has the same syntax and use that it has in printf.

fwprintf est une version à caractères larges de fprintf; dans fwprintf, format est une chaîne de caractères larges.fwprintf is a wide-character version of fprintf; in fwprintf, format is a wide-character string. Ces fonctions se comportent de la même façon si le flux est ouvert en mode ANSI.These functions behave identically if the stream is opened in ANSI mode. fprintf ne prend pas actuellement en charge la sortie dans un flux Unicode.fprintf does not currently support output into a UNICODE stream.

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.The versions of these functions with the _l suffix are identical except that they use the locale parameter passed in instead of the current thread locale.

Important

Assurez-vous que format n'est pas une chaîne définie par l'utilisateur.Ensure that format is not a user-defined string.

Mappages de routines de texte génériqueGeneric-Text Routine Mappings

Routine TCHAR.HTCHAR.H routine _UNICODE et _MBCS non définis_UNICODE & _MBCS not defined _MBCS défini_MBCS defined _UNICODE défini_UNICODE defined
_ftprintf_ftprintf fprintffprintf fprintffprintf fwprintffwprintf
_ftprintf_l_ftprintf_l _fprintf_l_fprintf_l _fprintf_l_fprintf_l _fwprintf_l_fwprintf_l

Pour plus d'informations, consultez Spécifications de format.For more information, see Format Specifications.

Configuration requiseRequirements

FonctionFunction En-tête requisRequired header
fprintf, _fprintf_lfprintf, _fprintf_l <stdio.h><stdio.h>
fwprintf, _fwprintf_lfwprintf, _fwprintf_l <stdio.h> ou <wchar.h><stdio.h> or <wchar.h>

Pour plus d'informations sur la compatibilité, voir Compatibilité.For additional compatibility information, see Compatibility.

ExemplesExample

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

E/S de fluxStream I/O
_cprintf, _cprintf_l, _cwprintf, _cwprintf_l_cprintf, _cprintf_l, _cwprintf, _cwprintf_l
fscanf, _fscanf_l, fwscanf, _fwscanf_lfscanf, _fscanf_l, fwscanf, _fwscanf_l
sprintf, _sprintf_l, swprintf, _swprintf_l, __swprintf_lsprintf, _sprintf_l, swprintf, _swprintf_l, __swprintf_l
Syntaxe de spécification de format : fonctions printf et wprintfFormat Specification Syntax: printf and wprintf Functions