PHP vprintf() 函数
PHP vprintf() 函数输出格式化的字符串
( PHP >= 4.1.0 )
函数原型
vprintf( format,argarray)
与 printf() 不同,vprintf() 中的参数位于数组中
数组元素将被插入到主字符串中的百分号(%)符号处
该函数是逐步执行的
在第一个 % 符号处,插入第一个数组元素,在第二个 % 符号处,插入第二个数组元素,依此类推
如果 % 符号多于 arg 参数,则您必须使用占位符
占位符被插入到 % 符号之后,由数字和 "\$" 组成。请参见实例 2
相关函数
参数
参数 | 描述 |
---|---|
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
输出格式化的字符串
<?php $number = 9; $str = "Beijing"; vprintf("There are %u million bicycles in %s.",array($number,$str));
运行以上 PHP 范例,输出结果如下
There are 9 million bicycles in Beijing.
范例 2
使用格式值 %f
<?php $num1 = 123; $num2 = 456; vprintf("%f%f",array($num1,$num2));
运行以上 PHP 范例,输出结果如下
123.000000456.000000
范例 3
使用占位符
<?php $u = 123; vprintf("With 2 decimals: %1$.2f<br>With no decimals: %1$u",array($u));
运行以上 PHP 范例,输出结果如下
With 2 decimals: 123.00 With no decimals:
范例 4
使用 printf() 来演示所有可能的格式值
<?php $num1 = 123456789; $num2 = -123456789; $char = 50; // The ASCII Character 50 is 2 // Note: The format value "%%" returns a percent sign vprintf("%%b = %b<br>",$num1); // Binary number vprintf("%%c = %c<br>",$char); // The ASCII Character vprintf("%%d = %d<br>",$num1) ; // Signed decimal number vprintf("%%d = %d<br>",$num2); // Signed decimal number vprintf("%%e = %e<br>",$num1); // Scientific notation (lowercase) vprintf("%%E = %E<br>",$num1); // Scientific notation (uppercase) vprintf("%%u = %u<br>",$num1); // Unsigned decimal number (positive) vprintf("%%u = %u<br>",$num2); // Unsigned decimal number (negative) vprintf("%%f = %f<br>",$num1); // Floating-point number (local settings aware) vprintf("%%F = %F<br>",$num1); // Floating-point number (not local sett aware) vprintf("%%g = %g<br>",$num1) ; // Shorter of %e and %f vprintf("%%G = %G<br>",$num1) ; // Shorter of %E and %f vprintf("%%o = %o<br>",$num1) ; // Octal number vprintf("%%s = %s<br>",$num1) ; // String vprintf("%%x = %x<br>",$num1); // Hexadecimal number (lowercase) vprintf("%%X = %X<br>",$num1); // Hex a decimal number (uppercase) vprintf("%%+d = %+d<br>",$num1) ; // Sign specifier (positive) vprintf("%%+d = %+d<br>",$num2) ;
运行以上 PHP 范例,输出结果如下
%b = 111010110111100110100010101 %c = 2 %d = 123456789 %d = -123456789 %e = 1.234568e+8 %E = 1.234568E+8 %u = 123456789 %u = 18446744073586094827 %f = 123456789.000000 %F = 123456789.000000 %g = 1.23457e+8 %G = 1.23457E+8 %o = 726746425 %s = 123456789 %x = 75bcd15 %X = 75BCD15 %+d = +123456789 %+d = -123456789
范例 4
字符串说明符的演示
<?php $str1 = "Hello"; $str2 = "Hello world!"; vprintf("[%s]<br>",array($str1)); vprintf("[%8s]<br>",array($str1)); vprintf("[%-8s]<br>",array($str1)); vprintf("[%08s]<br>",array($str1)); vprintf("[%'*8s]<br>",array($str1)); vprintf("[%8.8s]<br>",array($str2));
运行以上 PHP 范例,输出结果如下
[Hello] [ Hello] [Hello ] [000Hello] [***Hello] [Hello wo]