Partager via


fprintf, _fprintf_l, fwprintf, _fwprintf_l

imprimer des données mises en forme dans les flux Des versions plus 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 FILE.

  • format
    Chaîne de contrôle de format.

  • argument
    Arguments facultatifs.

  • locale
    Paramètres régionaux à utiliser.

Valeur de retour

fprintfretourne le nombre d'octets écrit. fwprintf retourne le nombre de caractères larges entrés. 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ètres non valides, comme décrit dans NULL. Si l'exécution est autorisée à se poursuivre, cette fonction renvoient -1 et définie 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 tels qu'on le rencontre en utilisant fprintf_s ou fwprintf_s.

Consultez _doserrno, errno, _sys_errlist et _sys_nerr pour plus d'informations sur ces éléments et autres codes d'erreur.

Notes

La fonction fprintf met en forme et retourne une série de caractères et de valeurs en sortue <parameterReference>3stream4</parameterReference>3<legacyItalic>5.</legacyItalic> Chaque fonction argument (le cas échéant) est convertie et sortie selon la spécification de format correspondante dans <parameterReference>format</parameterReference><legacyItalic>.</legacyItalic> Pour fprintf, l'argument format a la même syntaxe et utilisation 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 actuellement la sortie dans un flux 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.

Note de sécuritéNote de sécurité

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 & _MBCS non définis

_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 plus d'informations sur la compatibilité, 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" );
}
  

Équivalent .NET Framework

System::IO::StreamWriter::Write

Voir aussi

Référence

E/S de flux

_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 : fonctions printf et wprintf