fprintf

Список параметров

stream

Ресурс (resource) указателя файловой системы, который обычно создают функцией fopen().

format

Строка формата состоит из нуля или большего количества директив: стандартных символов, кроме %, которые выводятся без изменений, и спецификаторов преобразования, каждому из которых требуется параметр. Спецификация преобразования соответствует прототипу: %[argnum$][flags][width][.precision]specifier.

Argnum

Целое число, за которым идёт знак доллара $. Число указывает порядковый номер аргумента, который требуется преобразовать.

Флаги

Флаг	Описание
-	Выравнивает значение по левому краю в пределах заданной ширины поля; по умолчанию значение выравнивается по правому краю.
+	Выводит знак + перед неотрицательными числами; по умолчанию только к отрицательным числам добавляется знак минус.
(пробел)	Дополняет результат пробелами, которыми также при заданной ширине значение дополняется по умолчанию.
0	Дополняет числа нулями, но только слева. Со спецификатором s и флагом левостороннего выравнивания значение дополняется нулями справа.
'символ	Дополняет результат символом, который указали после апострофа.

Ширина

Ширина задаётся либо целым числом — минимум символов, который выводится в результате преобразования, либо символом *. При передаче символа * ширина задаётся в списке аргументов дополнительным целым числом перед значением, которое относится к спецификатору.

Точность

Символ ., за которым необязательно идёт целое число или символ *. Значение точности зависит от спецификатора:

• Для спецификаторов e, E, f и F: задаёт количество цифр после десятичной запятой. Значение по умолчанию — 6.
• Для спецификаторов g,G, h и H: задаёт предельное количество значащих цифр для вывода.
• Для спецификатора s: устанавливает точку отсечения для ограничения количества символов в строке.

Замечание: При пропуске явного значения точности после точки за точность принимается значение 0. Точность задаётся дополнительным целочисленным аргументом перед значением, к которому относится спецификатор, если вместо значения точности в строке формата указали символ *.

Спецификаторы

Спецификатор	Описание
%	Символ процента. Аргументы не требуются.
b	Аргумент рассматривается как целое число и печатается в бинарном представлении.
c	Аргумент рассматривается как целое число и печатается как символ из таблицы ASCII с соответствующим кодом.
d	Аргумент рассматривается как целое число и печатается как целое число со знаком.
e	Аргумент считается за число в научной нотации (т. е. 1.2e+2).
E	Аргумент аналогичен спецификатору e, но с заглавным символом (т. е. 1.2E+2).
f	Аргумент считается за число с плавающей точкой (с учётом локали).
F	Аргумент считается за число с плавающей точкой (без учёта локали).
g	Общий формат. Пусть P равно точности, если точность не равна нулю, 6, если точность не задали, или 1, если точность равна 0. Тогда, если преобразование со стилем «E» будет иметь показатель степени X: Если P > X ≥ −4, преобразование будет в стиле «f» и точность будет P - (X + 1). Иначе преобразование будет в стиле «e» и точность будет P - 1.
G	Аргумент аналогичен спецификатору g, но использует спецификаторы E и f.
h	Аргумент аналогичен спецификатору g, но использует спецификатор F. Доступен с PHP 8.0.0.
H	Аргумент аналогичен спецификатору g, но использует спецификаторы E и F. Доступен с PHP 8.0.0.
o	Аргумент рассматривается как целое число и печатается в восьмеричном представлении.
s	Аргумент рассматривается и печатается как строка.
u	Аргумент рассматривается как целое число и печатается как беззнаковое целое число.
x	Аргумент рассматривается как целое число и печатается в шестнадцатеричном представлении (буквы будут в нижнем регистре).
X	Аргумент рассматривается как целое число и печатается в шестнадцатеричном представлении (буквы будут в верхнем регистре).

Внимание

Спецификатор c игнорирует спецификаторы преобразования дополнения и ширины.

Внимание

Попытка использовать комбинацию спецификаторов строки и ширины с кодировками, которые требуют больше одного байта на символ, иногда даёт неожиданные результаты.

Функция приведёт переменные к типу, который соответствует спецификатору:

Обработка типов

Тип	Спецификатор
string	s
int	d, u, c, o, x, X, b
float	e, E, f, F, g, G, h, H

values