fprintf_s, _fprintf_s_l, , _fwprintf_s_lfwprintf_s, _ftprintf, _ftprintf_l, , _ftprintf_s,_ftprintf_s_l

Envoient les données mises en forme vers un flux. Ces fonctions sont des versions de , , , fwprintf_fwprintf_lavec des améliorations de sécurité, comme décrit dans les fonctionnalités de sécurité dans le CRT. _fprintf_lfprintf

Pour _ftprintf_s et _ftprintf_s_l, consultez les mappages de fonctions de texte générique.

Syntaxe

int fprintf_s(
   FILE *stream,
   const char *format [,
   argument_list ]
);
int _fprintf_s_l(
   FILE *stream,
   const char *format,
   _locale_t locale [,
   argument_list ]
);
int fwprintf_s(
   FILE *stream,
   const wchar_t *format [,
   argument_list ]
);
int _fwprintf_s_l(
   FILE *stream,
   const wchar_t *format,
   _locale_t locale [,
   argument_list ]
);

Paramètres

stream
Pointeur vers la structure FILE .

format
Chaîne de contrôle de format.

argument_list
Arguments facultatifs de la chaîne de format.

locale
Paramètres régionaux à utiliser.

Valeur retournée

fprintf_s retourne le nombre d’octets écrits. fwprintf_s 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.

Notes

fprintf_s met en forme et envoie une série de caractères et de valeurs vers la sortie stream. Chaque argument dans argument_list (le cas échéant) est converti et sortie en fonction de la spécification de format correspondante dans format. L’argument format utilise la syntaxe de spécification de format pour et wprintf les printf fonctions.

fwprintf_s est une version à caractères larges de fprintf_s ; dans fwprintf_s, 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_s 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 actuels.

Important

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

À compter de Windows 10 version 2004 (build 19041), la famille de fonctions printf imprime exactement les nombres à virgule flottante pouvant être représentés en suivant les règles IEEE 754 pour l’arrondi. Dans les versions précédentes de Windows, les nombres à virgule flottante pouvant être représentés exactement qui se terminent par « 5 » sont toujours arrondis à la valeur supérieure. IEEE 754 indique qu’ils doivent être arrondis au chiffre pair le plus proche (également appelé « arrondi du banquier »). Par exemple, printf("%1.0f", 1.5) et printf("%1.0f", 2.5) doivent être arrondis à 2. Avant, 1.5 aurait été arrondi à 2 et 2.5 à 3. Ce changement affecte uniquement les nombres représentables avec précision. Par exemple, 2.35 (qui, lorsqu’il est représenté en mémoire, est plus proche de 2.35000000000000008) continue d’être arrondi à la valeur supérieure 2.4. L’arrondi effectué par ces fonctions respecte également le mode d’arrondi à virgule flottante défini par fesetround. Avant, l’arrondi choisissait toujours le comportement FE_TONEAREST. Ce changement affecte uniquement les programmes générés à l’aide de Visual Studio 2019 versions 16.2 et ultérieures. Pour utiliser le comportement d’arrondi à virgule flottante hérité, liez avec 'legacy_stdio_float_rounding.obj'.

Comme les versions non sécurisées (voir fprintf, , fwprintf_fprintf_l, ), _fwprintf_lces fonctions valident leurs paramètres et appellent le gestionnaire de paramètres non valides, comme décrit dans validation de paramètre, si l’un stream ou format l’autre est un NULL pointeur. La chaîne de format elle-même est également validée. S’il existe des spécificateurs de mise en forme inconnus ou incorrects, ces fonctions génèrent l’exception de paramètre non valide. Dans tous les cas, si l’exécution est autorisée à se poursuivre, les fonctions retournent -1 et définissent errno avec la valeur EINVAL. Pour plus d’informations sur les codes de retour, consultez , , _sys_errlist_doserrnoet _sys_nerr.errno

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.

Fonction tchar.h	_UNICODE et _MBCS non définis	_MBCS défini	_UNICODE défini
_ftprintf_s	fprintf_s	fprintf_s	fwprintf_s
_ftprintf_s_l	_fprintf_s_l	_fprintf_s_l	_fwprintf_s_l

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

Spécifications

Fonction	En-tête requis
fprintf_s, _fprintf_s_l	<stdio.h>
fwprintf_s, _fwprintf_s_l	<stdio.h> ou <wchar.h>

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

Exemple

// crt_fprintf_s.c
// This program uses fprintf_s to format various
// data and print it to the file named FPRINTF_S.OUT. It
// then displays FPRINTF_S.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_s.out", "w" );
   fprintf_s( stream, "%s%c", s, c );
   fprintf_s( stream, "%d\n", i );
   fprintf_s( stream, "%f\n", fp );
   fclose( stream );
   system( "type fprintf_s.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