# PHP vsprintf() 函数 ## 定义和用法 vsprintf() 函数把格式化字符串写入变量中。 与 [sprintf()](/php/func_string_sprintf.asp "PHP sprintf() 函数") 不同，vsprintf() 中的 _arg_ 参数位于数组中。数组的元素会被插入主字符串的百分比 (%) 符号处。该函数是逐步执行的。在第一个 % 符号中，插入 arg1，在第二个 % 符号处，插入 arg2，依此类推。 ### 语法 ``` vsprintf(format,argarray) ``` | 参数 | 描述 | | --- | --- | | format | 必需。转换格式。 | | argarray | 必需。带有参数的一个数组，这些参数会被插到 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 - 十六进制数（大写字母） ## 提示和注释 注释：如果 % 符号多于 _arg_ 参数，则您必须使用占位符。占位符插到 % 符号后面，由数字和 "\$" 组成。请参见例子 3。 提示： 相关函数： [fprintf()](/php/func_string_fprintf.asp "PHP fprintf() 函数")、 [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() 函数")。 ## 例子 ### 例子 1 ``` <?php $str = "Hello"; $number = 123; $txt = vsprintf("%s world. Day number %u",array($str,$number)); echo $txt; ?> ``` 输出： ``` Hello world. Day number 123 ``` ### 例子 2 ``` <?php $num1 = 123; $num2 = 456; $txt = vsprintf("%f%f",array($num1,$num2)); echo $txt; ?> ``` 输出： ``` 123.000000456.000000 ``` ### 例子 3 使用占位符： ``` <?php $number = 123; $txt = vsprintf("With 2 decimals: %1\$.2f <br />With no decimals: %1\$u",array($number)); echo $txt; ?> ``` 输出： ``` With 2 decimals: 123.00 With no decimals: 123 ```