Если выполнить программу примера 13.6, можно получить следующий результат.
Dollars: $100
Euros: EUR77,54
Фасеты money_put
и money_get
записывают форматированные денежные значения в поток и считывают их из потока. Они работают почти так же, как фасеты даты/времени и числовые фасеты, описанные в предыдущих рецептах. Стандарт требует, чтобы были их реализации для стандартных символов и расширенного набора символов, например money_put
и money_put
. Как и для других фасетов, функции записи и чтения многословны, но, применив их несколько раз, легко запоминаешь параметры. money_get
и money_put
используют класс moneypunct
, содержащий информацию о форматировании.
Сначала рассмотрим запись денежных значений в поток. Отображение денежной суммы состоит из нескольких частей: знака валюты, знака плюс или минус, разделителя тысяч и десятичной точки. Все они, кроме десятичной точки, могут отсутствовать.
Вы создаете объект money_put
с типом символа и локализацией следующим образом.
const money_put
use_facet
Стандарт требует наличия версий как для char
, так и для wchar_t
. Разумно использовать локализацию потока, в который осуществляется запись, чтобы избежать несогласованности, возникающей при попытке синхронизации потока и объекта money_put
. На следующем шаге вызовите метод put для записи денежного значения в поток вывода.
if (moneyWriter.put(out, // Итератор вывода
intl, // bool: использовать формат intl?
out, // ostream&
out.fill(), // использовать символ заполнителя
val) // денежное значение, тип long double
.failed()) throw "Couldn't write money!\n";
Функция money_put::put
записывает денежное значение в переданный ей поток вывода, используя локализацию, с которой был создан объект money_put
. money_put::put
возвращает итератор ostreambuf_iterator
, который ссылается на позицию за последним выведенным символом; этот итератор имеет функцию-член failed
, позволяющую зафиксировать ситуацию, когда итератор оказывается испорченным.
Все параметры money_put::put
не требуют дополнительных пояснений, кроме, возможно, второго (аргумент intl
в примере). Он имеет тип bool
и показывает, будет использоваться символ валюты (например, $, €) или трехбуквенное международное обозначение валюты (например, USD, EUR). Для использования символа валюты установите его в значение false
, а для использования международного обозначения валюты — в значение true
.
При записи денежных значений в поток вывода можно задавать некоторые параметры потока, которые управляют форматированием. Ниже описывается каждый параметр и объясняется его воздействие на вывод денежного значения.
ios_base::internal
Если при форматировании денежного значения задается пробел или пустое значение, будет использован символ заполнителя (а не пробел). Ниже при обсуждении moneypunct
приводятся дополнительные сведения по шаблонам форматирования.
ios_base::left
и ios_base::right
Выравнивает денежное значение влево или вправо; при этом остальные позиции в пределах заданной ширины заполняются символом заполнителя (см. описание следующего параметра, width
). Это удобно, потому что облегчает табуляцию денежного значения.
ios_base::width
Значения, выдаваемые функцией money_put
, подчиняются стандартным правилам управления шириной поля потока. По умолчанию эти значения выравниваются влево. Если поле больше, чем размер значения, используется символ заполнителя, указанный при вызове функции money_put
.
ios_base::showbase
Если этот флаг имеет значение «истина», символ валюты выводится, в противном случае он не выводится.
Как я говорил ранее, функции money_get
и money_put
используют класс moneypunct
, в котором фактически хранится информация о форматировании. Вам не стоит беспокоиться о классе moneypunct
, если вы не заняты реализацией стандартной библиотеки, но вы можете использовать его для исследования параметров форматирования, применяемых в конкретной локализации, moneypunct
содержит такие сведения, как используемый символ валюты, символ, используемый в качестве десятичной точки, формат положительных и отрицательных значений и т.д. В примере 13.7 представлена короткая программа, печатающая информацию о формате денежных значений, который используется в заданной локализации.