PHP printf()— функция

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

Примеры

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

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

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

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

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

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

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

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


Синтаксис

printf(format,arg1,arg2,arg++)

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

Примечание:Если используется несколько приведённых выше значений формата, их нужно использовать в указанном выше порядке, не путая.

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

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

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


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

Пример 1

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

<?php
$number = 123;
printf("%f",$number);
?>

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

Пример 2

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

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

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

Пример 3

Демонстрация всех возможных значений формата:

<?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 = "Привет, мир!";

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

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


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