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> |