функция printf в php

Строковые функции PHP

Предыдущая

Следующая

Функции форматного вывода. Спецификаторы преобразования

printf() и sprintf()

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

С одной стороны этими функциями можно пользоваться просто как функциями вывода:

Но использовать их только так, как мы сейчас продемонстрировали – простое расточительство, так как эти функции способны на большее. Дело в том, что аргумент format этих функций представляет собой строку, содержащую специальные символы, использующиеся при форматировании данных, содержащихся в списке аргументов. Эти спецсимволы называются спецификаторами преобразования, а символы, которые остаются неизменными при форматировании строки, называют директивами.

Спецификация определяется символом «%«, за которым может следовать до пяти спецификаторов в следующем порядке:

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

По умолчанию дополнение строки до минимальной ширины производится с левого края (т.е., строка выравнивается по правому краю). Если добавлен символ дефиса, то строка выравнивается по левому краю

Представляет собой целое число, задающее минимальный размер форматированной строки. Если переданная строка меньше, то она дополняется символами, указанными в спецификаторе заполнения

Предназначен для указания количества десятичных знаков в представлении чисел с плавающей точкой. При применении этого спецификатора для форматирования строк, он определяет максимальное количество символов, которое нужно взять из переданной строки

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

Теперь, после разговора о спецификаторах типа, выведем с помощью функции printf() строку в формате даты dd/mm/yyyy. Следующий код выводит в результате строку «02/03/2003«:

В этом примере, месяц и день мы форматируем как двузначные числа, а год – как четырехзначное. При этом мы указываем, что целые числа дополняются до минимальной длины нулями слева: %04d

Первый символ – спецификатор заполнения и он равен нулю. Так как дополнение дописывается к началу числа, спецификатор выравнивания отсутствует. Спецификатор минимальной ширины равен двум. Спецификатор точности также отсутствует, так как мы форматируем целое число. Спецификатор типа представлен символом d, так как мы форматируем число как десятичное целое.

Приведем еще один пример.

Этот скрипт выводит число 19 в виде 19.000

Еще одна форматная функция

функция sscanf()

Эта функция является полной противоположностью функции printf(). Она интерпретирует строку str согласно формату format, аналогично спецификации printf(). При указании только двух аргументов полученные значения возвращаются как массив.

Давайте рассмотрим такой пример. Пусть у нас есть строка, в которой находится информация о названии и серийном номере изделия в виде «maxtor/203-5505» и нам надо вытащить из нее серийный номер. Пишем вот такой скриптик:

Не забывайте, что если не указываете в функции необязательные аргументы, то на выходе получите массив, и поэтому при выводе мы работаем со значениями массива.

Давайте поработаем еще с датой изготовления этого изделия, которая нам явилась в виде «august 10 2003«, а нам надо чтоб она выводилась в виде » 10 aug 2003«. Работаем.

Важное замечание: при указании необязательных параметров их надо передавать по ссылке (ссылка обозначается указанием символа «&» перед переменной).

Пример, в котором используются дополнительные необязательные параметры:

	Предыдущая	Следующая

Если Вам нужна частная профессиональная консультация от авторов многих книг Кузнецова М.В. и Симдянова И.В., добро пожаловать в наш Консультационный Центр SoftTime.

Источник

fprintf

fprintf — Записывает отформатированную строку в поток

Описание

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

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

Argnum

Ширина

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

Точность

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

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

Если P > X ≥ −4, преобразование будет в стиле «f» и точность будет P − (X + 1). В обратном случае, преобразование будет в стиле «e» и точность будет P − 1.

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

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

Возвращаемые значения

Возвращает длину записанной строки.

Примеры

Пример #1 fprintf() : заполнение нулями

Пример #2 fprintf() : форматирование денежных величин

Смотрите также

Источник

sprintf

(PHP 4, PHP 5, PHP 7, PHP 8)

sprintf — Возвращает отформатированную строку

Описание

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

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

Argnum

Ширина

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

Точность

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

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

Если P > X ≥ −4, преобразование будет в стиле «f» и точность будет P − (X + 1). В обратном случае, преобразование будет в стиле «e» и точность будет P − 1.

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

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

Возвращаемые значения

Список изменений

Примеры

Пример #1 Argument swapping

Строка формата поддерживает нумерацию и перемешивание аргументов.

Результат выполнения данного примера:

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

Дополнительным приятным моментом является то, что мы можем использовать один параметр для нескольких подстановок.

При использовании нумерованных аргументов, спецификатор позиции n$ должен стоять сразу же за символом процента ( % ), до любого другого спецификатора, как показано ниже.

Пример #2 Использование символа заполнения

Результат выполнения данного примера:

Пример #3 Спецификатор позиции в комбинации с другими спецификаторами

Результат выполнения данного примера:

Пример #4 sprintf() : целое с лидирующими нулями

Пример #5 sprintf() : форматирование денежных единиц

Результат выполнения данного примера:

Пример #6 sprintf() : научная нотация

Результат выполнения данного примера:

Смотрите также

User Contributed Notes 36 notes

With printf() and sprintf() functions, escape character is not backslash ‘\’ but rather ‘%’.

1. A plus sign (‘+’) means put a ‘+’ before positive numbers while a minus sign (‘-‘) means left justify. The documentation incorrectly states that they are interchangeable. They produce unique results that can be combined:

2. Padding with a ‘0’ is different than padding with other characters. Zeros will only be added at the front of a number, after any sign. Other characters will be added before the sign, or after the number:

There are already some comments on using sprintf to force leading leading zeros but the examples only include integers. I needed leading zeros on floating point numbers and was surprised that it didn’t work as expected.

This threw me a little off. To get the desired result, one needs to add the precision (2) and the length of the decimal seperator «.» (1). So the correct pattern would be

Please see http://stackoverflow.com/a/28739819/413531 for a more detailed explanation.

Here is how to print a floating point number with 16 significant digits regardless of magnitude:

$format = ‘There are %1$d monkeys in the %s and %s ‘;
printf($format, 100, ‘Chennai’, ‘Bangalore’);

Expecting to output
«There are 100 monkeys in the Chennai and bangalore»

But, this will output
«There are 100 monkeys in the 100 and Chennai»

Because, the second and Third specifiers takes 1rst and 2nd arguments. Because it is not assigned with any arguments.

Using argument swapping in sprintf() with gettext: Let’s say you’ve written the following script:

#: file.php:9
#, ycp-format
msgid «The %2\\$s contains %1\\$d monkeys»
msgstr «»

Notice how an extra backslash has been added by xgettext.

Once you’ve translated the string, you must remove all backslashes from the ID string as well as the translation, so the po file will look like this:

#: file.php:9
#, ycp-format
msgid «The %2$s contains %1$d monkeys»
msgstr «Der er %1$d aber i %2$s»

If you use the default padding specifier (a space) and then print it to HTML, you will notice that HTML does not display the multiple spaces correctly. This is because any sequence of white-space is treated as a single space.

To overcome this, I wrote a simple function that replaces all the spaces in the string returned by sprintf() with the character entity reference » » to achieve non-breaking space in strings returned by sprintf()

The old «monkey» example which helped me a lot has sadly disappeared.

I’ll Re-post it in comment as a memory.

/*
%b = ‘10100111101010011010101101’
%c = ‘A’
%d = ‘43951789’
%e = ‘4.395179e+7’
%u = ‘43951789’
%u = ‘18446744073665599827’
%f = ‘43951789.000000’
%o = ‘247523255’
%s = ‘43951789’
%x = ’29ea6ad’
%X = ’29EA6AD’
%+d = ‘+43951789’
%+d = ‘-43951789’
*/

$s = ‘monkey’ ;
$t = ‘many monkeys’ ;

Note that when using the argument swapping, you MUST number every argument, otherwise sprintf gets confused. This only happens if you use number arguments first, then switch to a non-numbered, and then back to a numbered one.

I had a nightmare trying to find the two’s complement of a 32 bit number.

This worked magic for me. previously I was trying to use

Hope this helps someone fighting with two’s complement in PHP.

A more complete and working version of mb_sprintf and mb_vsprintf. It should work with any «ASCII preserving» encoding such as UTF-8 and all the ISO-8859 charsets. It handles sign, padding, alignment, width and precision. Argument swapping is not handled.

$newformat = «» ; // build a new format in UTF-8
$newargv = array(); // unhandled args in unchanged encoding

If you use argument numbering, then format specifications with the same number get the same argument; this can save repeating the argument in the function call.

Just wanted to add that to get the remaining text from the string, you need to add the following as a variable in your scanf

Here’s a clean, working version of functions to allow using named arguments instead of numeric ones. ex: instead of sprintf(‘%1$s’, ‘Joe’);, we can use sprintf(‘%name$s’, array(‘name’ => ‘Joe’));. I’ve provided 2 different versions: the first uses the php-like syntax (ex: %name$s), while the second uses the python syntax (ex: %(name)s).

Источник

• ← функция print r php
• функция render template php →