Namespaces
Variants
Views
Actions

Difference between revisions of "cpp/locale/moneypunct"

From cppreference.com
< cpp‎ | locale
(move dsc items to templates)
(+missing)
Line 35: Line 35:
 
{{dsc inc | cpp/locale/moneypunct/dsc destructor}}
 
{{dsc inc | cpp/locale/moneypunct/dsc destructor}}
 
{{dsc inc | cpp/locale/moneypunct/dsc decimal_point}}
 
{{dsc inc | cpp/locale/moneypunct/dsc decimal_point}}
 +
{{dsc inc | cpp/locale/moneypunct/dsc thousands_sep}}
 
{{dsc inc | cpp/locale/moneypunct/dsc grouping}}
 
{{dsc inc | cpp/locale/moneypunct/dsc grouping}}
 
{{dsc inc | cpp/locale/moneypunct/dsc curr_symbol}}
 
{{dsc inc | cpp/locale/moneypunct/dsc curr_symbol}}
Line 47: Line 48:
 
{{dsc begin}}
 
{{dsc begin}}
 
{{dsc inc | cpp/locale/moneypunct/dsc do_decimal_point}}
 
{{dsc inc | cpp/locale/moneypunct/dsc do_decimal_point}}
 +
{{dsc inc | cpp/locale/moneypunct/dsc do_thousands_sep}}
 
{{dsc inc | cpp/locale/moneypunct/dsc do_grouping}}
 
{{dsc inc | cpp/locale/moneypunct/dsc do_grouping}}
 
{{dsc inc | cpp/locale/moneypunct/dsc do_curr_symbol}}
 
{{dsc inc | cpp/locale/moneypunct/dsc do_curr_symbol}}

Revision as of 18:51, 5 June 2013

 
C++
 
Localization library
 
std::moneypunct
 
Defined in header <locale>
template< class CharT, bool International = false >
class moneypunct;

The facet std::moneypunct encapsulates monetary value format preferences. Stream I/O manipulators std::get_money and std::put_money use std::moneypunct through std::money_get and std::money_put for parsing monetary value input and formatting monetary value output.

cpp/locale/money basecpp/locale/locale/facetstd-moneypunct-inheritance.svg

Inheritance diagram

Four specializations are provided by the standard library

Defined in header <locale>
std::moneypunct<char> provides equivalents of the "C" locale preferences
std::moneypunct<wchar_t> provides wide character equivalents of the "C" locale preferences
std::moneypunct<char, true> provides equivalents of the "C" locale preferences, with international currency symbols
std::moneypunct<wchar_t, true> provides wide character equivalents of the "C" locale preferences, with international currency symbols

Contents

Member types

Member type Definition
char_type charT
string_type std::basic_string<charT>

Member functions

 constructs a new moneypunct facet
(public member function) [edit]
destructs a moneypunct facet
(protected member function) [edit]
invokes do_decimal_point
(public member function) [edit]
invokes do_thousands_sep
(public member function) [edit]
invokes do_grouping
(public member function) [edit]
invokes do_curr_symbol
(public member function) [edit]
invokes do_positive_sign or do_negative_sign
(public member function) [edit]
invokes do_negative_sign
(public member function) [edit]
invokes do_frac_digits
(public member function) [edit]
invokes do_pos_format/do_neg_format
(public member function) [edit]
invokes do_neg_format
(public member function) [edit]

Protected member functions

[virtual]
 provides the character to use as decimal point
(virtual protected member function) [edit]
[virtual]
 provides the character to use as thousands separator
(virtual protected member function) [edit]
[virtual]
 provides the numbers of digits between each pair of thousands separators
(virtual protected member function) [edit]
[virtual]
 provides the string to use as the currency identifier
(virtual protected member function) [edit]
[virtual]
 provides the string to indicate a positive or negative value
(virtual protected member function) [edit]
[virtual]
 provides the string to indicate a negative value
(virtual protected member function) [edit]
[virtual]
 provides the number of digits to display after the decimal point
(virtual protected member function) [edit]
[virtual]
 provides the formatting pattern for currency values
(virtual protected member function) [edit]
[virtual]
 provides the formatting pattern for negative values
(virtual protected member function) [edit]

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

Run this code
#include <iostream>
#include <locale>
int main()
{
    std::locale jp("ja_JP.UTF-8");
    std::cout << "japanese currency symbol is "
              << std::use_facet<std::moneypunct<char, true>>(jp).curr_symbol()
              << "or "
              << std::use_facet<std::moneypunct<char>>(jp).curr_symbol()
              << " for short\n";
}

Output: 

japanese currency symbol is JPY or ￥ for short

See also

 defines monetary formatting patterns
(class) [edit]
represents the system-supplied std::moneypunct for the named locale
(class template) [edit]
parses and constructs a monetary value from an input character sequence
(class template) [edit]
formats a monetary value for output as a character sequence
(class template) [edit]
Retrieved from "https://en.cppreference.com/mwiki/index.php?title=cpp/locale/moneypunct&oldid=61505"