Latest web development tutorials

PHP vsprintf () function

PHP String Reference PHP String Reference

Examples

Writes a formatted string to a variable:

<?php
$number = 9;
$str = "Beijing";
$txt = vsprintf("There are %u million bicycles in %s.",array($number,$str));
echo $txt;
?>

Running instance »

Definition and Usage

vsprintf () function to write formatted string variable.

And sprintf () different, vsprintf () parameters are located in the array. Array element will be inserted into the main string percent sign (%) sign at. This function is performed on. In the first place a% sign, the first array element is inserted in the second% sign at the insertion of the second array element, and so on.

Note: If the% symbol than arg parameter, you must use placeholders.After placeholder is inserted into the% symbol, numbers and "\ $" component. See Example 2.

Tip: correlation function: fprintf () , vfprintf () , the printf () , sprintf () and vprintf ()

grammar

vsprintf( format,argarray )

参数 描述
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] （规定小数位数或最大字符串长度）

注释：如果使用多个上述的格式值，它们必须按照上面的顺序进行使用，不能打乱。
argarray 必需。带有参数的一个数组，这些参数会被插到 format 字符串中的 % 符号处。

technical details

return value: Returns a string formatted in the form of an array of values.
PHP version: 4.1.0+

More examples

Example 1

Use the format value% f:

<?php
$num1 = 123;
$num2 = 456;
$txt = vsprintf("%f%f",array($num1,$num2));
echo $txt;
?>

Running instance »

Example 2

Use placeholders:

<?php
$number = 123;
$txt = vsprintf("With 2 decimals: %1$.2f
<br>With no decimals: %1$u",array($number));
echo $txt;
?>

Running instance »

Example 3

Use sprintf () to demonstrate the value of all the possible formats:

<?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>"; // Hexadecimal number (uppercase)
echo sprintf("%%+d = %+d",$num1)."<br>"; // Sign specifier (positive)
echo sprintf("%%+d = %+d",$num2)."<br>"; // Sign specifier (negative)
?>

Running instance »

Example 4

String specifiers presentation:

<?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>";
?>

Running instance »

PHP String Reference PHP String Reference