вы можете поинтересоваться: «Нужно ли мне на самом деле выяснять, как использовать все эти сведения, просто для форматирования денежного значения?» К счастью, ответом является «нет». [140] Функция
Мы так же счастливы, как и вы, поскольку нам не нужно представлять код, использующий эту полнофункциональную структуру — Примеч. автора.
Эта функция во многом подобна
strftime
(см. раздел 6.1.3.2 «Сложное форматирование времени:
strftime
»), используя
format
для копирования символов букв и форматированных числовых значений в
s
, помещая в нее не более max символов. Следующая простая программа,
ch13-strfmon.c
, демонстрирует работу
strfmon
:
/* ch13-strfmon.c --- демонстрация strfmon */
#include <stdio.h>
#include <locale.h>
#include <monetary.h>
int main(void) {
char buf[BUFSIZ];
double val = 1234.567;
setlocale(LC_ALL, "");
strfmon(buf, sizeof buf, "You owe me %n (%i)\n", val, val);
fputs(buf, stdout);
return 0;
}
При запуске в двух различных локалях она выдает такой результат:
$ LC_ALL=en_US ch13-strfmon /* В Соединенных Штатах */
You owe me $1,234.57 (USD 1,234.57)
$ LC_ALL=it_IT ch13-strfmon /* В Италии */
You owe me EUR 1.235 (EUR 1.235)
Как вы можете видеть,
strfmon
подобна
strftime
, копируя обычные символы в буфер назначения без изменений и форматируя аргументы в соответствии со своими собственными спецификациями форматирования. Их всего три.
%n
Вывести национальное (т.е. местное) представление значения валюты.
%i
Вывести международное представление значения валюты.
%%
Вывести символ '
%
'.
Форматируемые значения должны иметь тип
double
. Разницу между
%n
и
%i
мы видим в локали "
en_US
":
%n
использует символ
$
, тогда как
%i
использует USD, которая означает «доллары США».
Гибкость — и соответственно определенная сложность — сопровождают многие функции API, разработанные для POSIX, и
strfmon
не является исключением. Как и с
printf
, несколько необязательных элементов, которые могут быть между
%
и
i
или
n
, обеспечивают повышенный контроль. Полные формы следующие:
%% /* Не допускаются поля флагов, ширины и т.д. */
Флаги перечислены в табл. 13.2.
Таблица 13.2. Флаги для
strfmon
Флаг
Значение
=с
Использовать символ с в качестве символа числового заполнения слева. Символом по умолчанию является пробел. Обычной альтернативой является 0
^
Запретить использование символа группировки (например, запятой в Соединенных Штатах)
(
Отрицательные значения заключать в скобки. Несовместим с флагом
+
+
Обрабатывать положительные/отрицательные значения обычным образом. Использовать положительные и отрицательные знаки локали. Несовместим с флагом
(
!
Не включать символ валюты. Этот флаг полезен, если вы хотите использовать
strfmon
для более гибкого форматирования обычных чисел, чем это предусматривает
sprintf
–
Выровнять результат слева. По умолчанию используется выравнивание справа. Этот флаг не действует без указания ширины поля
Ширина поля является строкой десятичных цифр, представляющих минимальную ширину. По умолчанию использует столько символов, сколько необходимо, основываясь на оставшейся части спецификации. Значения, меньшие ширины поля, дополняются пробелами слева (или справа, если указан флаг '
–
').
Точность слева состоит из символа
#
и строки десятичных цифр. Она указывает минимальное число цифр, которые должны быть слева от десятичного символа-разделителя дробной части [141] ; если преобразованное значение меньше этого, результат выравнивается символом числового заполнения. По умолчанию используется пробел, однако для его изменения можно использовать флаг
=
. Символы группировки не включаются в общий счет.
141
В стандарте используется технический термин radix point (позиционный разделитель), поскольку числа с другим основанием счисления также могут иметь дробные части. Однако, для денежных значений можно довольно безопасно использовать термин 'decimal point' (десятичный разделитель) — Примеч. автора.
