std::put_money

Определено в заголовочном файле `<iomanip>`
template< class MoneyT > /unspecified/ put_money( const MoneyT& mon, bool intl = false );		(с C++11)

При использовании в выражении out << put_money(mon, intl), преобразует денежную величину mon в её строковое представление, как указано в манипуляторе std::money_put локали, текущей для out.

Операция вставки в out << put_money(mon, intl) ведет себя как FormattedOutputFunction.

Параметры

mon	-	денежная величина, либо `long double` либо `std::basic_string`
intl	-	использовать международные обозначения валюты, если `true`, в противном случае использовать символы валюты

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

Объект неопределённого типа, такой что

если out является объектом типа std::basic_ostream<CharT, Traits>, выражение out << put_money(mon, intl)
- имеет тип std::basic_ostream<CharT, Traits>&
- имеет значение out
- ведет себя как FormattedOutputFunction, который вызывает f(out, mon, intl)

где функция f определяется как:

template<class CharT, class Traits, class MoneyT>
void f(std::basic_ios<CharT, Traits>& str, const MoneyT& mon, bool intl)
{
    using Iter = std::ostreambuf_iterator<CharT, Traits>;
    using MoneyPut = std::money_put<CharT, Iter>;
 
    const MoneyPut& mp = std::use_facet<MoneyPut>(str.getloc());
    const Iter end = mp.put(Iter(str.rdbuf()), intl, str, str.fill(), mon);
 
    if (end.failed())
        str.setstate(std::ios_base::badbit);
}

Пример

#include <iomanip>
#include <iostream>
 
int main()
{
    long double mon = 123.45; // or std::string mon = "123.45";
 
    std::cout.imbue(std::locale("en_US.UTF-8"));
    std::cout << std::showbase
              << "en_US: " << std::put_money(mon)
              << " or " << std::put_money(mon, true) << '\n';
 
    std::cout.imbue(std::locale("ru_RU.UTF-8"));
    std::cout << "ru_RU: " << std::put_money(mon)
              << " or " << std::put_money(mon, true) << '\n';
 
    std::cout.imbue(std::locale("ja_JP.UTF-8"));
    std::cout << "ja_JP: " << std::put_money(mon)
              << " or " << std::put_money(mon, true) << '\n';
}

Возможный вывод:

en_US: $1.23 or USD  1.23
ru_RU: 1.23 руб or 1.23 RUB 
ja_JP: ￥123 or JPY  123

См. также

money_put	форматирует денежную величину для вывода в виде последовательности символов (шаблон класса)
get_money (C++11)	анализирует денежную величину (шаблон функции)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/io/manip/put_money