std::moneypunct_byname
| Defined in header <locale> | ||
|---|---|---|
| template< class CharT, bool Intl = false > class moneypunct_byname : public std::moneypunct<CharT, Intl>; | 
std::moneypunct_byname is a std::moneypunct facet which encapsulates monetary formatting preferences of a locale specified at its construction.
Two specializations are provided by the standard library.
| Defined in header <locale> | |
|---|---|
| std::moneypunct_byname<char, Intl> | locale-specific std::moneypunctfacet for narrow character I/O | 
| std::moneypunct_byname<wchar_t, Intl> | locale-specific std::moneypunctfacet for wide character I/O | 
Member types
| Member type | Definition | 
|---|---|
| pattern | std::money_base::pattern | 
| string_type | std::basic_string<CharT> | 
Member functions
|  (constructor) | constructs a new moneypunct_bynamefacet(public member function) | 
|  (destructor) | destroys a moneypunct_bynamefacet(protected member function) | 
std::moneypunct_byname::moneypunct_byname
| explicit moneypunct_byname( const char* name, std::size_t refs = 0 ); | ||
| explicit moneypunct_byname( const std::string& name, std::size_t refs = 0 ); | (since C++11) | 
Constructs a new std::moneypunct_byname facet for a locale with name.
refs is used for resource management: if refs == 0, the implementation destroys the facet, when the last std::locale object holding it is destroyed. Otherwise, the object is not destroyed.
Parameters
| name | - | the name of the locale | 
| refs | - | the number of references that link to the facet | 
std::moneypunct_byname::~moneypunct_byname
| protected: ~moneypunct_byname(); | 
Destroys the facet.
Inherited from std::moneypunct
Member types
| Member type | Definition | 
|---|---|
| char_type | CharT | 
| string_type | std::basic_string<CharT> | 
Member functions
| invokes do_decimal_point(public member function of std::moneypunct<CharT,International>) | |
| invokes do_thousands_sep(public member function of std::moneypunct<CharT,International>) | |
| invokes do_grouping(public member function of std::moneypunct<CharT,International>) | |
| invokes do_curr_symbol(public member function of std::moneypunct<CharT,International>) | |
| invokes do_positive_signordo_negative_sign(public member function of std::moneypunct<CharT,International>) | |
| invokes do_frac_digits(public member function of std::moneypunct<CharT,International>) | |
| invokes do_pos_format/do_neg_format(public member function of std::moneypunct<CharT,International>) | 
Protected member functions
| [virtual] | provides the character to use as decimal point (virtual protected member function of std::moneypunct<CharT,International>) | 
| [virtual] | provides the character to use as thousands separator (virtual protected member function of std::moneypunct<CharT,International>) | 
| [virtual] | provides the numbers of digits between each pair of thousands separators (virtual protected member function of std::moneypunct<CharT,International>) | 
| [virtual] | provides the string to use as the currency identifier (virtual protected member function of std::moneypunct<CharT,International>) | 
| [virtual] | provides the string to indicate a positive or negative value (virtual protected member function of std::moneypunct<CharT,International>) | 
| [virtual] | provides the number of digits to display after the decimal point (virtual protected member function of std::moneypunct<CharT,International>) | 
| [virtual] | provides the formatting pattern for currency values (virtual protected member function of std::moneypunct<CharT,International>) | 
Member constants
| Member | Definition | 
|---|---|
| const bool intl(static) | International | 
Member objects
| static std::locale::id id | id of the locale (public member object) | 
Inherited from std::money_base
| Member type | Definition | 
|---|---|
| enum part { none, space, symbol, sign, value }; | unscoped enumeration type | 
| struct pattern { char field[4]; }; | the monetary format type | 
| Enumeration constant | Definition | 
|---|---|
| none | whitespace is permitted but not required except in the last position, where whitespace is not permitted | 
| space | one or more whitespace characters are required | 
| symbol | the sequence of characters returned by moneypunct::curr_symbol is required | 
| sign | the first of the characters returned by moneypunct::positive_sign or moneypunct::negative_sign is required | 
| value | the absolute numeric monetary value is required | 
Example
This example demonistrates how to apply monetary formatting rules of another language without changing the rest of the locale.
#include <iostream>
#include <iomanip>
#include <locale>
int main()
{
    long double mon = 1234567;
    std::locale::global(std::locale("en_US.utf8"));
    std::wcout.imbue(std::locale());
    std::wcout << L"american locale : " << std::showbase
               << std::put_money(mon) << '\n';
    std::wcout.imbue(std::locale(std::wcout.getloc(),
                                 new std::moneypunct_byname<wchar_t>("ru_RU.utf8")));
    std::wcout << L"american locale with russian moneypunct: "
               << std::put_money(mon) << '\n';
}Output:
american locale : $12,345.67 american locale with russian moneypunct: 12 345.67 руб
See also
| defines monetary formatting parameters used by std::money_getandstd::money_put(class template) | 
    © cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
    http://en.cppreference.com/w/cpp/locale/moneypunct_byname