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