std::put_money
From cppreference.com
C++
Feature test macros (C++20)
Concepts library (C++20)
Metaprogramming library (C++11)
Ranges library (C++20)
Filesystem library (C++17)
Concurrency support library (C++11)
Execution control library (C++26)
Input/output library
Print functions (C++23)
Buffers
(C++23)
(C++98/26*)
(C++20)
Streams
Abstractions
File I/O
String I/O
Array I/O
(C++23)
(C++23)
(C++23)
(C++98/26*)
(C++98/26*)
(C++98/26*)
Synchronized Output
(C++20)
Types
Error category interface
(C++11)
(C++11)
Input/output manipulators
Floating-point formatting
(C++11)(C++11)
Integer formatting
Boolean formatting
Field width and fill control
Other formatting
Whitespace processing
Output flushing
(C++20)(C++20)
Status flags manipulation
Time and money I/O
Quoted manipulator
(C++14)
Defined in header
<iomanip>
template< class MoneyT >
/*unspecified*/ put_money( const MoneyT& mon, bool intl = false );
(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.
Contents
[edit] Parameters
mon
-
a monetary value, either long double or std::basic_string
intl
-
use international currency strings if true, use currency symbols otherwise
[edit] 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 ); }
[edit] 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