Parses the sequence of characters between s and end for a monetary expression, and stores it into either units or digits.

The function reads characters until the character read cannot be part of a valid sequence in the format or end is reached. The next character after the last one processed by the function is pointed by the iterator returned by the function.

If successful, the first version (1) stores a floating-point value with the interpretation of the monetary expression in units. The second version (2) stores the digits extracted into digits as a basic_string object.

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

The next character in the sequence right after where the extraction operation ended.
Member type iter_type is the facet's iterator type (defined as an alias of money_get's second template parameter, InputIterator).