PHP sprintf()Функции
Справочное руководство по строкам PHP
Примеры
Замените знак процента (%) на переменную, переданную в качестве параметра:
<?php
$number = 9;
$str = "EXAMPLE";
$txt = sprintf("Ежедневно %u десятков тысяч человек посещают %s!", $str, $number);
echo $txt;
?>
Вывод следующий:
EXAMPLE 每天有 9 万人在访问！
Определение и использование
Функция sprintf() записывает форматированную строку в переменную.
Параметры arg1, arg2, ++ будут вставлены на месте знака процента (%) в основной строке. Эта функция выполняется пошагово. На первом знаке % вставляется arg1, на втором знаке % вставляется arg2 и так далее.
Примечание:Если знаков % больше, чем параметров arg, необходимо использовать заполнители. Заполнитель вставляется после знака % и состоит из числа и "\$". См. пример 2.
Совет:Связанные функции:printf()、
vprintf()、
vsprintf()、
fprintf()иvfprintf()
Синтаксис
sprintf(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;
$txt = sprintf("%f",$number);
echo $txt;
?>
Запустить пример »
Пример 2
Использование заполнителей:
<?php
$number = 123;
$txt = sprintf("С двумя десятичными знаками: %1\$.2f
<br>Без десятичных знаков: %1\$u",$number);
echo $txt;
?>
Запустить пример »
Пример 3
Демонстрация всех возможных значений формата:
<?php
$num1 = 123456789;
$num2 = -123456789;
$char = 50;
echo sprintf("%%b = %b",$num1)."<br>";
echo sprintf("%%c = %c",$char)."<br>";
echo sprintf("%%d = %d",$num1)."<br>";
echo sprintf("%%d = %d",$num2)."<br>";
echo sprintf("%%e = %e",$num1)."<br>";
echo sprintf("%%E = %E",$num1)."<br>";
echo sprintf("%%u = %u",$num1)."<br>";
echo sprintf("%%u = %u",$num2)."<br>";
echo sprintf("%%f = %f",$num1)."<br>";
echo sprintf("%%F = %F",$num1)."<br>";
echo sprintf("%%g = %g",$num1)."<br>";
echo sprintf("%%G = %G",$num1)."<br>";
echo sprintf("%%o = %o",$num1)."<br>";
echo sprintf("%%s = %s",$num1)."<br>";
echo sprintf("%%x = %x",$num1)."<br>";
echo sprintf("%%X = %X",$num1)."<br>";
echo sprintf("%%+d = %+d",$num1)."<br>";
echo sprintf("%%+d = %+d",$num2)."<br>";
?>
Пример 4
Демонстрация спецификаторов строк:
<?php
$str1 = "Привет";
$str2 = "Привет, мир!";
echo sprintf("[%s]",$str1)."<br>";
echo sprintf("[%8s]",$str1)."<br>";
echo sprintf("[%-8s]",$str1)."<br>";
echo sprintf("[%08s]",$str1)."<br>";
echo sprintf("[%'*8s]",$str1)."<br>";
echo sprintf("[%8.8s]",$str2)."<br>";
?>
Запустить пример »
Справочное руководство по строкам PHP Другие расширения