PHP vsprintf() 函数

定义和用法

vsprintf() 函数把格式化字符串写入变量中。

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()printf()sprintf()vfprintf() 以及 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