fprintf, _fprintf_l, fwprintf, _fwprintf_l

Článek
03/04/2013

Tisk formátovaná data do datového proudu.Bezpečnější verze tyto funkce jsou k dispozici; see 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 ]...
);

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

fprintfVrátí počet zapsaných bajtů.fwprintfVrá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.Pokud stream nebo format je NULL, tyto funkce vyvolat popisovač neplatný parametr, jak je popsáno v Ověření parametrů.Pokud je povoleno spuštění pokračovat, funkce vrátí -1 a errno na EINVAL.Formátovací řetězec není zaškrtnuto políčko pro platné znaky pro formátování jako při použití fprintf_s nebo fwprintf_s.

Viz _doserrno, kód chyby, _sys_errlist a _sys_nerr Další informace o těchto a jiných kódů chyb.

Poznámky

fprintfformá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, format argument má stejné syntaxe a použití, které má v printf.

fwprintfje verze celého znaku fprintf; v fwprintf, format je řetězec znaků wide.Tyto funkce chovat stejně, pokud datový proud je otevřen v režimu ANSI.fprintfaktuálně nepodporuje 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í podproces národní prostředí.

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

Obecný Text rutinní mapování

TCHAR.Rutina H	_UNICODE & _MBCS není definován	_MBCS, definice	_UNICODE, definice
_ftprintf	fprintf	fprintf	fwprintf
_ftprintf_l	_fprintf_l	_fprintf_l	_fwprintf_l

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

Požadavky

Function	Požadované záhlaví
fprintf, _fprintf_l	<stdio.h>
fwprintf, _fwprintf_l	<stdio.h> nebo <wchar.h>

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

Příklad

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