# 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 ```