NAME¶

std::get_money - std::get_money

Synopsis¶

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

When used in an expression in >> get_money(mon, intl), parses the character input as
a monetary value, as specified by the std::money_get facet of the locale currently
imbued in in, and stores the value in mon.

The extraction operation in in >> get_money(mon, intl) behaves as a
FormattedInputFunction.

Parameters¶

mon - variable where monetary value will be written. Can be either long double or
basic_string
intl - expects to find required international currency strings if true, expects
optional currency symbols otherwise

Return value¶

Returns an object of unspecified type such that if in is the name of an input stream
of type std::basic_istream<CharT, Traits>, then the expression in >> get_money(mon,
intl) behaves as if the following code was executed:

typedef std::istreambuf_iterator<CharT, Traits> Iter;
typedef std::money_get<CharT, Iter> MoneyGet;
std::ios_base::iostate err = std::ios_base::goodbit;
const MoneyGet &mg = std::use_facet<MoneyGet>(in.getloc());
mg.get(Iter(in.rdbuf()), Iter(), intl, in, err, mon);
if (std::ios_base::goodbit != err)
out.setstate(err);

Example¶

// Run this code

#include <iostream>
#include <sstream>
#include <locale>
#include <iomanip>

int main()
{
std::istringstream in("$1,234.56 2.22 USD 3.33");
long double v1, v2;
std::string v3;
in.imbue(std::locale("en_US.UTF-8"));
in >> std::get_money(v1) >> std::get_money(v2) >> std::get_money(v3, true);
if (in) {
std::cout << std::quoted(in.str()) << " parsed as: "
<< v1 << ", " << v2 << ", " << v3 << '\n';
} else {
std::cout << "Parse failed";
}
}

Output:¶

"$1,234.56 2.22 USD 3.33" parsed as: 123456, 222, 333

See also¶

money_get parses and constructs a monetary value from an input character sequence
(class template)
put_money formats and outputs a monetary value
(C++11) (function template)