fprintf_s, _fprintf_s_l, fwprintf_s, _fwprintf_s_l

Článek
03/04/2013

Tisk formátovaná data do datového proudu.Tyto verze jsou fprintf, _fprintf_l, fwprintf, _fwprintf_l s vylepšení zabezpečení popsaným v Funkce zabezpečení v CRT.

int fprintf_s( 
   FILE *stream,
   const char *format [,
   argument ]...
);
int _fprintf_s_l( 
   FILE *stream,
   const char *format,
   locale_t locale [,
   argument ]...
);
int fwprintf_s( 
   FILE *stream,
   const wchar_t *format [,
   argument ]...
);
int _fwprintf_s_l( 
   FILE *stream,
   const wchar_t *format,
   locale_t locale [,
   argument ]…
);

Parametry

stream
Ukazatel na FILE struktury.
format
Řetězec formátu řízení.
argument
Volitelné argumenty.
locale
Národní prostředí použít.

Vrácená hodnota

fprintf_sVrátí počet zapsaných bajtů.fwprintf_sVrátí počet široké znaky.Každá z těchto funkcí vrátí zápornou hodnotu místo při výskytu chyby výstupu.

Poznámky

fprintf_sformáty a vytiskne řadu znaků a hodnot na výstup stream*.* Každá funkce argument (pokud existuje) převedena a výstup podle odpovídající specifikaci formátu v format*.* Pro fprintf_s, format argument má stejné syntaxe a použití, které má v printf_s.

fwprintf_sje verze celého znaku fprintf_s; v fwprintf_s, format je řetězec znaků wide.Tyto funkce chovat stejně, pokud datový proud je otevřen v režimu ANSI.fprintf_snepodporuje aktuálně výstup do datového proudu UNICODE.

Verze těchto funkcí se _l přípony jsou shodné s výjimkou, že používají národní prostředí parametr předaný namísto aktuální národní prostředí.

Poznámka k zabezpečení
Zajistit, aby format není uživatelem definovaný řetězec.

Podobně jako verze-secure (viz fprintf, _fprintf_l, fwprintf, _fwprintf_l), tyto funkce ověření jejich parametry a vyvolat popisovač neplatný parametr, jak je popsáno v Ověření parametrů, pokud stream nebo format je nulový ukazatel.Tyto funkce se liší od verze-secure, že vlastní řetězec formátu také ověřena.Pokud jsou všechny specifikátory neznámá nebo chybně zformulovaný formátování, tyto funkce generovat výjimku neplatného parametru.Ve všech případech, pokud je povoleno spuštění pokračovat, funkce vrátí -1 a errno na EINVAL.Viz _doserrno, kód chyby, _sys_errlist a _sys_nerr Další informace o těchto a jiných kódů chyb.

Obecný Text rutinní mapování

TCHAR.Rutina H	_UNICODE & _MBCS není definován	_MBCS, definice	_UNICODE, definice
_ftprintf_s	fprintf_s	fprintf_s	fwprintf_s
_ftprintf_s_l	_fprintf_s_l	_fprintf_s_l	_fwprintf_s_l

Další informace naleznete v tématu Specifikace formátu.

Požadavky

Function	Požadované záhlaví
fprintf_s, _fprintf_s_l	<stdio.h>
fwprintf_s, _fwprintf_s_l	<stdio.h> nebo <wchar.h>

Další informace o kompatibilitě, viz Compatibility v úvodu.

Příklad

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