std::money_get::get

Parameters

s, end

Iterators pointing to the beginning and end characters of the sequence. The range used is [s,end), which contains all the characters between s and end, including the character pointed by s but not the character pointed by end.
Member type iter_type is the facet's iterator type (defined as an alias of money_get's second template parameter, InputIterator). By default, this is an istreambuf_iterator, allowing implicit conversions from basic_istream objects.

intl

true for international representation, false otherwise.
This is used to select the proper instatiation of moneypunct.

str

Object of a class derived from ios_base (generally an input stream object). It is only used to obtain formatting information.

err

Stream error state object, of type ios_base::iostate where the error states are stored when set.

units

The function stores in this variable the floating point value equivalent to the monetary expression read.

digits

The function stores in this variable a string value with the digits successfully extracted (only the digits, no punctuation marks).
Member type string_type is an instantiation of basic_string with the same character type as the facet (defined as an alias of basic_string<charT>, where charT is money_get's first template parameter).

Return value

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

// money_get example
#include <iostream>       // std::cin, std::cout, std::ios
#include <locale>         // std::locale, std::money_get, std::use_facet

int main ()
{
  std::locale loc("");    // default locale
  std::ios::iostate state;
  long double price;

  std::cout << "Please, enter the price: ";
  std::use_facet<std::money_get<char> >(loc).get
    (std::cin, std::money_get<char>::iter_type(), false, std::cin, state, price);

  if ((state & std::ios::failbit)==std::ios::failbit)
    std::cout << "ERROR: failed to read price\n";
  else
    std::cout << "The price of three items is " << (price*3.0) << '\n';

  return 0;
}

Please, enter the price: $12.95
ERROR: failed to read price

Data races

Exception safety

See also

money_put::put

Format monetary expression (public member function)

num_get

Facet to parse numeric values (class template)