class template
<locale>
std::moneypunct
template <class charT, bool International = false> class moneypunct;
Monetary punctuation facet
The moneypunct standard facet provides information about the format of monetary values.
The moneypunct class template has a protected destructor: Programs shall only construct objects of derived classes, or use those installed in locale objects (through use_facet).
All standard locale objects support at least the following facet instantiations of the moneypunct class template as part of the money category:
| facets in locale objects | description |
|---|
moneypunct<char> | narrow characters |
moneypunct<wchar_t> | wide characters |
moneypunct<char,true> | narrow characters, international representation |
moneypunct<wchar_t,true> | wide characters, international representation |
Template parameters
- charT
- Character type.
This is the type of characters used to produce the representation.
Aliased as member char_type.
- International
- If
true, the representation uses an international format (such as using the three-letter code USD for the US dollar)
If false (the default value), the representation may use a non-international format (such as using the dollar sign, $, for the US dollar).
Member types
| member type | definition | description |
|---|
| char_type | The template parameter (charT) | Character type |
| string_type | basic_string<charT> | The basic_string instantiation for characters of type charT (such as string for char).
|
The class also inherits member types part and pattern from money_base.
Member constants
The following member constants are inherited from money_base (as labels of enum type money_base::part); They are used as the possible values of the elements in the pattern objects returned by members moneypunct::pos_format and moneypunct::neg_format.
| member constant | type | value | description |
|---|
| none | money_base::part | 0 | None |
| space | money_base::part | 1 | A single space character |
| symbol | money_base::part | 2 | Currency symbol |
| sign | money_base::part | 3 | Sign: + for positive, - for negative |
| value | money_base::part | 4 | Monetary value |
The class also contains a two public static constants:
| member constant | type | description |
|---|
| intl | bool | Alias of the second class template argument: Internation |
| id | locale::id | Value that uniquely identifies facets with moneypunct semantics |
Public member functions
- (constructor)
- moneypunct constructor (public member function)
- decimal_point
- Return decimal point character (public member function)
- thousands_sep
- Return thousands separator character (public member function)
- grouping
- Return grouping of digits (public member function)
- curr_symbol
- Return currency symbol (public member function)
- positive_sign
- Return positive sign string (public member function)
- negative_sign
- Return negative sign string (public member function)
- frac_digits
- Return fractional digits (public member function)
- pos_format
- Return format for positive monetary expressions (public member function)
- neg_format
- Return format of negative monetary expressions (public member function)
Virtual protected member functions
The class defines the virtual protected members which implement the behavior by default of their respective public member functions:
- do_decimal_point
- Return decimal point character [virtual] (protected virtual member function)
- do_thousands_sep
- Return thousands separator character [virtual] (protected virtual member function)
- do_grouping
- Return grouping of digits [virtual] (protected virtual member function)
- do_curr_symbol
- Return currency symbol [virtual] (protected virtual member function)
- do_positive_sign
- Return positive sign string [virtual] (protected virtual member function)
- do_negative_sign
- Return negative sign string [virtual] (protected virtual member function)
- do_frac_digits
- Return fractional digits [virtual] (protected virtual member function)
- do_pos_format
- Return format for positive monetary expressions [virtual] (protected virtual member function)
- do_neg_format
- Return format for negative monetary expressions [virtual] (protected virtual member function)
Along with the class destructor
- (destructor)
- moneypunct destructor (protected member function)
Specializations
At least the following specializations of this template are provided in all library implementations:
| specialization |
|---|
moneypunct<char> |
moneypunct<wchar_t> |
moneypunct<char,true> |
moneypunct<wchar_t,true> |