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