PHP vfprintf() 函数
PHP vfprintf() 函数把格式化的字符串写到指定的输出流
( PHP >= 5 )
函数原型
vfprintf( stream,format,argarray)
与 fprintf() 不同,vfprintf() 中的参数位于数组中
数组元素将被插入到主字符串中的百分号(%)符号处
该函数是逐步执行的:在第一个 % 符号处,插入第一个数组元素,在第二个 % 符号处,插入第二个数组元素,依此类推
如果 % 符号多于 arg 参数,则必须使用占位符
占位符被插入到 % 符号之后,由数字和 "\$" 组成
相关函数
参数
参数 | 描述 |
---|---|
stream | 必需。规定在哪里写入/输出字符串 |
format | 必需。规定字符串以及如何格式化其中的变量 |
argarray | 必需。带有参数的一个数组,这些参数会被插到 format 字符串中的 % 符号处 |
参数 format 格式化符列表
格式化符 | 说明 |
---|---|
%% | 返回一个百分号 |
%%b | 二进制数 |
%c | ASCII 值对应的字符 |
%d | 包含正负号的十进制数(负数、0、正数) |
%e | 使用小写的科学计数法(例如 1.2e+2) |
%E | 使用大写的科学计数法(例如 1.2E+2) |
%u | 不包含正负号的十进制数(大于等于 0) |
%f | 浮点数(本地设置) |
%F | 浮点数(非本地设置) |
%g | 较短的 %e 和 %f |
%G | 较短的 %E 和 %f |
%o | 八进制数 |
%s | 字符串 |
%x | - 十六进制数(小写字母) |
%X | 十六进制数(大写字母) |
. | 附加的格式值。必需放置在 % 和字母之间(例如 %.2f) |
+ | 在数字前面加上 + 或 - 来定义数字的正负性 默认情况下,只有负数才做标记,正数不做标记) |
' | 规定使用什么作为填充,默认是空格 它必须与宽度指定器一起使用例如:%'x20s(使用 "x" 作为填充) |
- | 左调整变量值 |
[0-9] | 规定变量值的最小宽度 |
.[0-9] | 规定小数位数或最大字符串长度 |
如果使用多个上述的格式值,它们必须按照上面的顺序进行使用,不能打乱
返回值
返回被写的字符串的长度
范例 1
把一些文本写入到名为 "demo.txt" 的文本文件中
<?php$number = 9; $str = "Beijing"; $file = fopen("demo.txt","w"); echo vfprintf($file,"There are %u million bicycles in %s.",array($number,$str));
运行以上范例,输出结果如下
40
打开文件 demo.txt
可以看到以下内容
There are 9 million bicycles in Beijing.
范例 2
把一些文本写入到文件中
<?php $num1 = 123; $num2 = 456; $file = fopen("demo.txt","w"); vfprintf($file,"%f%f",array($num1,$num2));
运行以上 PHP 范例,打开文件 demo.txt
可以看到以下内容
123.000000456.000000
范例 3
使用占位符
<?php $number = 123; $file = fopen("demo.txt","w"); vfprintf($file,"With 2 decimals: %1$.2fnWith no decimals: %1$u",array($number));
运行以上 PHP 范例,可以在 demo.txt
文件中看到以下内容
With 2 decimals: 123.00 With no decimals: 123