fprintf, _fprintf_l, fwprintf, _fwprintf_l

Article
03/04/2013

Données mises en forme d'impression dans un flux.plus les versions sécurisées de ces fonctions sont disponibles ; consultez 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 d' FILE .
format
Chaîne de format.
argument
arguments facultatifs.
locale
Les paramètres régionaux à utiliser.

Valeur de retour

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 lorsqu'une erreur de sortie se produit.si stream ou format est NULL, ces fonctions appellent le gestionnaire de paramètre non valide, comme décrit dans Validation des paramètres.Si est autorisé à l'exécution de se poursuivre, les fonctions retournent -1 et errno défini à EINVAL.La chaîne de format n'est pas activée pour les caractères de mise en forme valides telle qu'elle est en utilisant fprintf_s ou fwprintf_s.

Consultez _doserrno, errno, _sys_errlist, et _sys_nerr pour plus d'informations sur ce point, ainsi que d'autres, les codes d'erreur.

Notes

fprintf met en forme et imprime un ensemble de caractères et les valeurs à la sortie stream*.* Chaque fonction argument (le cas échéant) est converti et de sortie en fonction de la spécification du format correspondante dans format*.* Pour fprintf, l'argument d' format présente la même syntaxe et utilisation qu'elle a dans printf.

fwprintf est une version à caractère élargi d' fprintf; dans fwprintf, format est une chaîne à caractères larges.Ces fonctions se comportent de la même si le flux est ouvert en mode ANSI.fprintf ne prend pas en charge actuellement la sortie dans un flux d'UNICODE.

Les versions de ces fonctions par le suffixe d' _l sont identiques mais elles utilisent le paramètre de paramètres régionaux passé au lieu des paramètres régionaux du thread courant.

Note de sécurité
assurez-vous qu' format n'est pas une chaîne définie par l'utilisateur.

mappages de routines de texte générique

routine de TCHAR.H	_MBCS & de _UNICODE non défini	_MBCS défini	_UNICODE défini
_ftprintf	fprintf	fprintf	fwprintf
_ftprintf_l	_fprintf_l	_fprintf_l	_fwprintf_l

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

Configuration requise

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

Pour des informations de compatibilité supplémentaires, consultez compatibilité dans l'introduction.

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" );
}