NAME¶

std::put_money - std::put_money

Synopsis¶

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

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 parses a monetary value
(C++11) (function template)