std::put_money
| 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
Returns an object of unspecified type such that if out is the name of an output stream of type std::basic_ostream<CharT, Traits>, then the expression out << put_money(mon, intl) behaves as if the following code was executed:
typedef std::ostreambuf_iterator<CharT, Traits> Iter;
typedef std::money_put<CharT, Iter> MoneyPut;
const MoneyPut& mp = std::use_facet<MoneyPut>(out.getloc());
const Iter end = mp.put(Iter(out.rdbuf()), intl, out, out.fill(), mon);
if (end.failed())
out.setstate(std::ios::badbit);
Example
#include <iostream> #include <iomanip> int main() { long double mon = 123.45; // or std::string mon = "123.45"; std::cout.imbue(std::locale("en_US.utf8")); std::cout << std::showbase << "en_US: " << std::put_money(mon) << " or " << std::put_money(mon, true) << '\n'; std::cout.imbue(std::locale("ru_RU.utf8")); std::cout << "ru_RU: " << std::put_money(mon) << " or " << std::put_money(mon, true) << '\n'; std::cout.imbue(std::locale("ja_JP.utf8")); std::cout << "ja_JP: " << std::put_money(mon) << " or " << std::put_money(mon, true) << '\n'; }
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
| formats a monetary value for output as a character sequence (class template) | |
| (C++11) |
parses a monetary value (function template) |