vsprintf

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

format

Строка формата состоит из нуля или более директив: обычные символы (за исключением %), которые просто выводятся без изменения и спецификаторы преобразования, каждый из которых требует передачи своего параметра.

Спецификаторы преобразования имеют следующий формат: %[argnum$][flags][width][.precision]specifier.

Argnum

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

Флаги

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

Ширина

Целое число, определяющее минимальное количество символов, которое будет напечатано.

Точность

Точка . с последующим целым числом, работающая по разному для разных спецификаторов:

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

Замечание: Если указана точка без последующего значения точности, то точность будет считаться за 0.

Замечание: Попытка использовать спецификатор позиции со значением больше, чем PHP_INT_MAX приведет к выводу предупреждения.

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

Спецификатор	Описание
%	Символ процента. Аргументы не требуются.
b	Аргумент рассматривается как целое число и печатается в бинарном представлении.
c	Аргумент рассматривается как целое число и печатается как символ из таблицы ASCII с соответствующим кодом.
d	Аргумент рассматривается как целое число и печатается как целое число со знаком.
e	Аргумент считается за число в научной нотации (т.е. 1.2e+2). Начиная с PHP 5.2.1, спецификатор точности задает количество цифр после десятичной запятой. В более ранних версиях он задавал общее количество значащих цифр (т.е. после запятой выводилось на 1 символ меньше).
E	Аналогично спецификатору e, но использует заглавные символы (т.е. 1.2E+2).
f	Аргумент считается за число с плавающей точкой (с учетом локали).
F	Аргумент считается за число с плавающей точкой (без учета локали). Доступно с PHP 5.0.3.
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
integer	d, u, c, o, x, X, b
double	g, G, e, E, f, F

values