fprintf, _fprintf_l, fwprintf, _fwprintf_l

將格式化資料列印至資料流。 這些函式有更安全的版本可供使用;請參閱 、、 fwprintf_s_fprintf_s_l 、 _fwprintf_s_l 。 fprintf_s

語法

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 ]...
);

參數

stream
FILE 結構的指標。

format
格式控制字串。

argument
選擇性引數。

locale
要使用的地區設定。

傳回值

fprintf 會傳回寫入的位元組數。 fwprintf 會傳回寫入的寬字元數。 發生輸出錯誤時，所有這些函式都會改為傳回負值。 如果 stream 或 format 為 NULL ，這些函式會叫用不正確參數處理常式，如參數驗證 中所述 。 若允許繼續執行，函式會傳回 -1，並將 errno 設為 EINVAL。 使用 或 fwprintf_s 時 fprintf_s ，不會檢查格式字串是否有有效的格式字元。

如需傳回碼的詳細資訊，請參閱 errno 、 _doserrno_sys_errlist 和 _sys_nerr 。

備註

fprintf 會格式化一連串的字元和值，並將其列印至輸出 stream。 每個 argument 函式 (如果有的話) 都是根據 format 中的對應格式規格進行轉換和輸出。 針對 fprintf ，自 format 變數的語法與 中的 printf 語法相同。

fwprintf 是寬字元版本的 fprintf；在 fwprintf 中，format 是寬字元字串。 如果資料流是以 ANSI 模式開啟，則這些函式的行為相同。 fprintf 目前不支援輸出至 UNICODE 資料流。

這些有 _l 尾碼的函式版本是一樣的，不同之處在於會使用傳入的地區設定，而不使用目前的執行緒地區設定。

重要

確認 format 不是使用者定義的字串。

從 Windows 10 版本 2004（組建 19041）開始，函 printf 式系列會根據 IEEE 754 規則來列印完全可代表的浮點數以進行四捨五入。 在舊版的 Windows 中，完全代表以 '5' 結尾的浮點數一律會四捨五入。 IEEE 754 指出，他們必須四捨五入到最接近的偶數數位（也稱為「銀行家的四捨五入」）。 例如， printf("%1.0f", 1.5) 和 應該 printf("%1.0f", 2.5) 四捨五入為 2。 先前，1.5 會四捨五入為 2，而 2.5 會四捨五入為 3。 這項變更只會影響確切可表示的數位。 例如，2.35 （在記憶體中表示時，其接近 2.3500000000000000008）會繼續四捨五入至 2.4。 這些函式完成的四捨五入現在也會遵守 所 fesetround 設定的浮點舍入模式。 之前，舍入一律選擇 FE_TONEAREST 行為。 這項變更只會影響使用 Visual Studio 2019 16.2 版和更新版本所建置的程式。 若要使用舊版浮點舍入行為，請連結至 'legacy_stdio_float_rounding.obj' 。

泛型文字常式對應

TCHAR.H 常規	_UNICODE 和 _MBCS 未定義	_MBCS 定義	_UNICODE 定義
_ftprintf	fprintf	fprintf	fwprintf
_ftprintf_l	_fprintf_l	_fprintf_l	_fwprintf_l

如需詳細資訊，請參閱 格式規格語法 。

需求

函式	必要的標頭
fprintf, _fprintf_l	<stdio.h>
fwprintf, _fwprintf_l	<stdio.h> 或 <wchar.h>

如需相容性詳細資訊，請參閱相容性。

範例

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

this is a string
10
1.500000

另請參閱

資料流 I/O
_cprintf, _cprintf_l, _cwprintf, _cwprintf_l
fscanf, _fscanf_l, fwscanf, _fwscanf_l
sprintf, _sprintf_l, swprintf, _swprintf_l, _swprintf_l
格式規格語法： printf 和 wprintf 函式