money_format Форматирует число как денежную величину &warn.deprecated.function-7-4-0.removed-8-0-0; &reftitle.description; stringmoney_format stringformat floatnumber money_format форматирует число number как денежную величину. Эта функция вызывает функцию strfmon языка C, но позволяет преобразовать только одно число за один вызов. &reftitle.parameters; format Описание формата состоит из: символа % необязательных флагов необязательной ширины поля необязательной точности до запятой необязательной точности после запятой обязательного описателя преобразования Флаги Могут быть использованы следующие флаги: =f Символ =, за которым следует ещё один символ f, задаёт символ заполнения. По умолчанию пробел. ^ Отключает группировку символов (определяемую текущей локалью). + или ( Задаёт способ форматирования положительных и отрицательных значений. При использовании + будут использоваться аналоги символов + и - из текущей локали. Если указана (, отрицательные числа будут заключены в скобки. По умолчанию +. ! Подавляет вывод символа валюты. - Если этот флаг задан, поля будут выравнены влево (с отбивкой вправо), вместо используемого по умолчанию выравнивания вправо (с отбивкой влево). Ширина поля w Строка из десятичных цифр, задающая минимальную ширину поля. Поле будет выравнено вправо, если не указан флаг -. Значение по умолчанию - 0 (ноль). Точность до запятой #n Максимальное количество цифр (n), которое ожидается до запятой. Это обычно используется при выводе значений одно под другим, чтобы десятичные точки располагались в одной колонке, при этом используется символ заполнения, если число цифр меньше n. Если число цифр больше n, этот параметр игнорируется. Если группировка не была отключена флагом ^, разделители групп будут вставлены перед добавлением символов заполнения. Разделители групп не вставляются между символами заполнения, даже если заполнитель - цифра. Для обеспечения выравнивания, все символы, выводимые до или после числа, такие как символ валюты или знак, будут дополнены пробелами до одинаковой ширины. Точность после запятой .p Точка, за которой следует число знаков (p), выводимых после запятой. Если значение p равно нулю, десятичная точка и цифры после неё не будут выводиться. Если этот параметр отсутствует, число знаков после запятой определяется текущей локалью. Перед форматированием число округляется до указанного количества знаков. Описатель преобразования i Используется международный денежный формат из текущей локали (например, для американской локали: USD 1,234.56). n Используется национальный денежный формат из текущей локали (например, для локали de_DE: EU1.234,56). % Вставляет символ %. number Форматируемое число. &reftitle.returnvalues; Возвращает отформатированную строку. Символы перед и после описания формата возвращаются без изменений. Если number не является числом, то будет возвращён &null; и вызвана ошибка уровня E_WARNING. &reftitle.changelog; &Version; &Description; 7.4.0 Функция устарела. Вместо неё используйте NumberFormatter::formatCurrency. &reftitle.examples; Пример использования <function>money_format</function> Проиллюстрируем применение этой функции для различных локалей и разных описаний формата. ]]> &reftitle.notes; Функция money_format определена только если в системе присутствует функция strfmon. Например, в Windows она отсутствует, поэтому money_format не определена в Windows. На работу этой функции влияет установка категории LC_MONETARY текущей локали. Перед использованием этой функции установите нужную локаль с помощью setlocale. &reftitle.seealso; setlocale sscanf sprintf printf number_format