Difference between revisions of "cpp/locale/moneypunct byname"
From cppreference.com
Jhcarl0814 (Talk | contribs) m (fix spelling) |
m (c -> c/core.) |
||
| Line 1: | Line 1: | ||
| − | {{cpp/title | moneypunct_byname}} | + | {{cpp/title|moneypunct_byname}} |
{{cpp/locale/navbar}} | {{cpp/locale/navbar}} | ||
{{dcl begin}} | {{dcl begin}} | ||
| − | {{dcl header | locale}} | + | {{dcl header|locale}} |
| − | {{dcl | 1= | + | {{dcl|1= |
template< class CharT, bool Intl = false > | template< class CharT, bool Intl = false > | ||
class moneypunct_byname : public std::moneypunct<CharT, Intl>; | class moneypunct_byname : public std::moneypunct<CharT, Intl>; | ||
| Line 9: | Line 9: | ||
{{dcl end}} | {{dcl end}} | ||
| − | {{ | + | {{tt|std::moneypunct_byname}} is a {{lc|std::moneypunct}} facet which encapsulates monetary formatting preferences of a locale specified at its construction. |
| − | + | ||
| − | + | ||
| + | Two specializations are provided by the standard library: | ||
{{dsc begin}} | {{dsc begin}} | ||
{{dsc header | locale }} | {{dsc header | locale }} | ||
| − | {{dsc | {{c|std::moneypunct_byname<char, Intl>}} | locale-specific {{lc|std::moneypunct}} facet for narrow character I/O }} | + | {{dsc | {{c/core|std::moneypunct_byname<char, Intl>}} | locale-specific {{lc|std::moneypunct}} facet for narrow character I/O }} |
| − | {{dsc | {{c|std::moneypunct_byname<wchar_t, Intl>}} | locale-specific {{lc|std::moneypunct}} facet for wide character I/O }} | + | {{dsc | {{c/core|std::moneypunct_byname<wchar_t, Intl>}} | locale-specific {{lc|std::moneypunct}} facet for wide character I/O }} |
{{dsc end}} | {{dsc end}} | ||
| Line 23: | Line 22: | ||
{{dsc hitem | Member type | Definition}} | {{dsc hitem | Member type | Definition}} | ||
{{dsc | {{tt|pattern}} | {{lc|std::money_base::pattern}}}} | {{dsc | {{tt|pattern}} | {{lc|std::money_base::pattern}}}} | ||
| − | {{dsc | {{tt|string_type}} | {{c|std::basic_string<CharT>}}}} | + | {{dsc | {{tt|string_type}} | {{c/core|std::basic_string<CharT>}}}} |
{{dsc end}} | {{dsc end}} | ||
| Line 37: | Line 36: | ||
{{include | cpp/locale/moneypunct/inherit}} | {{include | cpp/locale/moneypunct/inherit}} | ||
{{include | cpp/locale/money_base/inherit}} | {{include | cpp/locale/money_base/inherit}} | ||
| − | |||
| + | ===Example=== | ||
{{example | {{example | ||
| − | + | |This example demonstrates how to apply monetary formatting rules of another language without changing the rest of the locale. | |
| − | + | |code= | |
#include <iostream> | #include <iostream> | ||
#include <iomanip> | #include <iomanip> | ||
#include <locale> | #include <locale> | ||
| + | |||
int main() | int main() | ||
{ | { | ||
| Line 57: | Line 57: | ||
<< std::put_money(mon) << '\n'; | << std::put_money(mon) << '\n'; | ||
} | } | ||
| − | + | |output= | |
american locale : $12,345.67 | american locale : $12,345.67 | ||
american locale with russian moneypunct: 12 345.67 руб | american locale with russian moneypunct: 12 345.67 руб | ||
| Line 64: | Line 64: | ||
===See also=== | ===See also=== | ||
{{dsc begin}} | {{dsc begin}} | ||
| − | {{dsc inc | cpp/locale/dsc moneypunct}} | + | {{dsc inc|cpp/locale/dsc moneypunct}} |
{{dsc end}} | {{dsc end}} | ||
| − | + | {{langlinks|de|es|fr|it|ja|pt|ru|zh}} | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
Revision as of 08:18, 21 January 2023
| 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::moneypunct facet for narrow character I/O |
| std::moneypunct_byname<wchar_t, Intl> | locale-specific std::moneypunct facet for wide character I/O |
Contents |
Member types
| Member type | Definition |
pattern
|
std::money_base::pattern |
string_type
|
std::basic_string<CharT> |
Member functions
| (constructor) |
constructs a new moneypunct_byname facet (public member function) |
| (destructor) |
destroys a moneypunct_byname facet (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_sign or do_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 std::moneypunct::curr_symbol is required |
sign
|
the first of the characters returned by std::moneypunct::positive_sign or std::moneypunct::negative_sign is required |
value
|
the absolute numeric monetary value is required |
Example
This example demonstrates how to apply monetary formatting rules of another language without changing the rest of the locale.
Run this code
#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_get and std::money_put (class template) |
