PHP vfprintf()Функция

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

Примеры

Запишите некоторый текст в текстовый файл с именем "test.txt":

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

Приведённый выше код выведет:

40

Следующий текст будет записан в файл "test.txt":

В Пекине 9 миллионов велосипедов.

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

Функция vfprintf() записывает форматированную строку в указанный выходной поток (например, файл или базу данных).

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

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

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

Синтаксис

vfprintf(stream,format,argarray)

Параметр Описание
stream Обязательный. Указывает, куда записать/вывести строку.
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: 5+

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

Пример 1

Записать текст в файл:

<?php
$num1 = 123;
$num2 = 456;
$file = fopen("test.txt","w");
vfprintf($file,"%f%f",array($num1,$num2));
?>

Следующий текст будет записан в файл "test.txt":

123.000000456.000000

Пример 2

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

<?php
$number = 123;
$file = fopen("test.txt","w");
vfprintf($file,"With 2 decimals: %1$.2f
nWith no decimals: %1$u",array($number));
?>

Следующий текст будет записан в файл "test.txt":

С 2 знаками после запятой: 123.00
Без знаков после запятой: 123

Пример 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); // Спецификатор знака (отрицательный)
?>

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

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