# std::put_money

From cppreference.com
< cpp‎ | io‎ | manip

Defined in header `<iomanip>` |  |
template< class MoneyT > /*unspecified*/ put_money( const MoneyT& mon, bool intl = false ); |  | (since C++11)

When used in an expression out << put_money(mon, intl), converts the monetary value mon to its character representation as specified by the std::money_put facet of the locale currently imbued in out.

The insertion operation in out << put_money(mon, intl) behaves as a FormattedOutputFunction.

### Parameters

mon | - | a monetary value, either long double or std::basic_string
intl | - | use international currency strings if true, use currency symbols otherwise

### Return value

An object of unspecified type such that

- if out is an object of type std::basic_ostream<CharT, Traits>, the expression out << put_money(mon, intl)
  - has type std::basic_ostream<CharT, Traits>&
  - has value out
  - behaves as a FormattedOutputFunction that calls f(out, mon, intl)

where the function f is defined as:

    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);
    }

### Example

Run this code

    #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';
    }

Possible output:

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

### See also

money_put | formats a monetary value for output as a character sequence (class template)
get_money (C++11) | parses a monetary value (function template)

Retrieved from "https://en.cppreference.com/mwiki/index.php?title=cpp/io/manip/put_money&oldid=159178"