PHP vprintf()Функции

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

Примеры

Выводит форматированную строку:

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

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

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

Функция vprintf() выводит форматированную строку.

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

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

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

Синтаксис

vprintf(format,argarray)

Parameters Описание
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;
vprintf("%f%f",array($num1,$num2));
?>

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

Пример 2

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

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

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

Пример 3

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

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

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

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

Пример 4

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

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

vprintf("[%s]<br>",array($str1));
vprintf("[%8s]<br>",array($str1));
vprintf("[%-8s]<br>",array($str1));
vprintf("[%08s]<br>",array($str1));
vprintf("[%'*8s]<br>",array($str1));
vprintf("[%8.8s]<br>",array($str2));
?>

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

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