# PHP fprintf() 函數 ## 定義和用法 fprintf() 函數把格式化的字符串寫到指定的輸出流（例如：文件或數據庫）。 該函數返回被寫字符串的長度。 ### 語法 ``` fprintf(stream,format,arg1,arg2,arg++) ``` | 參數 | 描述 | | --- | --- | | stream | 可選。規定在哪里寫/輸出字符串。 | | format | 必需。轉換格式。 | | arg1 | 必需。規定插到 format 字符串中第一個 % 符號處的參數。 | | arg2 | 可選。規定插到 format 字符串中第二個 % 符號處的參數。 | | arg++ | 可選。規定插到 format 字符串中第三、四等等 % 符號處的參數。 | ### 說明 參數 _format_ 是轉換的格式，以百分比符號 ("%") 開始到轉換字符結束。下面的可能的 _format_ 值： * %% - 返回百分比符號 * %b - 二進制數 * %c - 依照 ASCII 值的字符 * %d - 帶符號十進制數 * %e - 可續計數法（比如 1.5e+3） * %u - 無符號十進制數 * %f - 浮點數(local settings aware) * %F - 浮點數(not local settings aware) * %o - 八進制數 * %s - 字符串 * %x - 十六進制數（小寫字母） * %X - 十六進制數（大寫字母） arg1, arg2, ++ 等參數將插入到主字符串中的百分號 (%) 符號處。該函數是逐步執行的。在第一個 % 符號中，插入 arg1，在第二個 % 符號處，插入 arg2，依此類推。 ## 提示和注釋 注釋：如果 % 符號多于 arg 參數，則您必須使用占位符。占位符被插入 % 符號之后，由數字和 "\$" 組成。請參見例子 3。 提示： 相關函數： [printf()](/php/func_string_printf.asp "PHP printf() 函數")、 [sprintf()](/php/func_string_sprintf.asp "PHP sprintf() 函數")、 [vfprintf()](/php/func_string_vfprintf.asp "PHP vfprintf() 函數")、 [vprintf()](/php/func_string_vprintf.asp "PHP vprintf() 函數") 以及 [vsprintf()](/php/func_string_vsprintf.asp "PHP vsprintf() 函數")。 ## 例子 ### 例子 1 ``` <?php $str = "Hello"; $number = 123; $file = fopen("test.txt","w"); echo fprintf($file,"%s world. Day number %u",$str,$number); ?> ``` 輸出： ``` 27 ``` 以下文本將寫入 "test.txt"： ``` Hello world. Day number 123 ``` ### 例子 2 ``` <?php $number = 123; $file = fopen("test.txt","w"); fprintf($file,"%f",$number); ?> ``` 輸出： ``` 123.000000 ``` ### 例子 3 使用占位符： ``` <?php $number = 123; $file = fopen("test.txt","w"); fprintf($file,"With 2 decimals: %1\$.2f\nWith no decimals: %1\$u",$number); ?> ``` 以下文本將寫入 "test.txt"： ``` With 2 decimals: 123.00 With no decimals: 123 ```