PHP fprintf()Функции

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

Примеры

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

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

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

40

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

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

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

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

Параметры arg1, arg2, ++ будут вставлены в основную строку в месте знака процента (%). Функция выполняется шаг за шагом. При первом знаке % вставляется arg1, при втором знаке % вставляется arg2 и так далее.

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

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

Синтаксис

fprintf(stream,format,arg1,arg2,arg++)

Parameters Описание
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] (Задаёт количество знаков после запятой или максимальную длину строки)

Примечание:Если используется несколько из вышеуказанных значений формата, они должны использоваться в указанном выше порядке, и их нельзя переставлять.
arg1 Обязательный. Указывает параметр, который нужно вставить вместо первого знака % в строке формата.
arg2 Необязательный. Указывает параметр, который нужно вставить вместо второго знака % в строке формата.
arg++ Необязательный. Указывает параметры, которые нужно вставить вместо третьего, четвертого и т. д. знаков % в строке формата.

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

Возвращаемое значение: Возвращает длину записанной строки.
Версия PHP: 5+

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

Пример 1

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

<?php
$number = 123;
$file = fopen("test.txt","w");
fprintf($file,"%f",$number);
?>

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

123.000000

Пример 2

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

<?php
$number = 123;
$file = fopen("test.txt","w");
fprintf($file,"С 2 знаками после запятой: %1$.2f
nБез знаков после запятой: %1$u",$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 Другие расширения