PHP vsprintf()Функции

PHP String 参考手册Справочное руководство по строкам PHP

Примеры

Записать форматированную строку в переменную:

<?php
$number = 9;
$str = "Beijing";
$txt = vsprintf("Есть %u миллион велосипедов в %s.",array($number,$str));
echo $txt;
?>

Запустить пример »

Определение и использование

Функция vsprintf() записывает форматированную строку в переменную.

В отличие от sprintf(), аргументы в vsprintf() помещаются в массив. Элементы массива будут вставлены в места знаков процента (%) в основной строке. Эта функция выполняется шаг за шагом. На первом знаке % вставляется первый элемент массива, на втором знаке % — второй элемент массива, и так далее.

Примечание:Если знаков % больше, чем параметров arg, необходимо использовать заполнители. Заполнитель вставляется после знака % и состоит из числа и "\$". См. Пример 2.

Совет:Связанные функции:fprintf()、 vfprintf()、 printf()、 sprintf()иvprintf()

Синтаксис

vsprintf(format,argarray)

Параметр Описание
format Обязательный. Указывает строку и способ форматирования переменных в ней.

Возможные значения формата:

  • %% - Возвращает знак процента %
  • %b - Двоичное число
  • %c - Символ, соответствующий значению ASCII
  • %d - знаковое десятичное число (отрицательное, нулевое, положительное)
  • %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 Обязательно. Массив с аргументами, которые будут вставлены на места знаков % в строке формата.

Технические детали

Возвращаемое значение: Возвращает значения массива в виде форматированной строки.
Версия PHP: 4.1.0+

Другие примеры

Пример 1

Использование значения формата %f:

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

Запустить пример »

Пример 2

Использование заполнителей:

<?php
$number = 123;
$txt = vsprintf("С 2 десятичными знаками: %1$.2f
<br>Без десятичных знаков: %1$u",array($number));
echo $txt;
?>

Запустить пример »

Пример 3

Использование sprintf() для демонстрации всех возможных значений формата:

<?php
$num1 = 123456789;
$num2 = -123456789;
$char = 50; // ASCII-символ 50 — это 2

// Примечание: значение формата "%%" возвращает знак процента
echo sprintf("%%b = %b",$num1)."<br>"; // Двоичное число
echo sprintf("%%c = %c",$char)."<br>"; // Символ ASCII
echo sprintf("%%d = %d",$num1)."<br>"; // Знаковое десятичное число
echo sprintf("%%d = %d",$num2)."<br>"; // Знаковое десятичное число
echo sprintf("%%e = %e",$num1)."<br>"; // Экспоненциальная запись (нижний регистр)
echo sprintf("%%E = %E",$num1)."<br>"; // Экспоненциальная запись (верхний регистр)
echo sprintf("%%u = %u",$num1)."<br>"; // Беззнаковое десятичное число (положительное)
echo sprintf("%%u = %u",$num2)."<br>"; // Беззнаковое десятичное число (отрицательное)
echo sprintf("%%f = %f",$num1)."<br>"; // Число с плавающей запятой (учитывает локальные настройки)
echo sprintf("%%F = %F",$num1)."<br>"; // Число с плавающей запятой (не учитывает локальные настройки)
echo sprintf("%%g = %g",$num1)."<br>"; // Более короткая из %e и %f
echo sprintf("%%G = %G",$num1)."<br>"; // Более короткая из %E и %f
echo sprintf("%%o = %o",$num1)."<br>"; // Восьмеричное число
echo sprintf("%%s = %s",$num1)."<br>"; // Строка
echo sprintf("%%x = %x",$num1)."<br>"; // Шестнадцатеричное число (нижний регистр)
echo sprintf("%%X = %X",$num1)."<br>"; // Шестнадцатеричное число (верхний регистр)
echo sprintf("%%+d = %+d",$num1)."<br>"; // Спецификатор знака (положительный)
echo sprintf("%%+d = %+d",$num2)."<br>"; // Спецификатор знака (отрицательный)
?>

Запустить пример »

Пример 4

Демонстрация спецификаторов строк:

<?php
$str1 = "Привет";
$str2 = "Привет, мир!";

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 String 参考手册Справочное руководство по строкам PHP Другие расширения