std::moneypunct

 

C++

Language

Concepts

Utilities library

Strings library

Containers library

Algorithms library

Iterators library

Numerics library

Input/output library

Localizations library

Regular expressions library (C++11)

Atomic operations library (C++11)

Thread support library (C++11)

 

Localizations library

Locales and facets
locale
use_facet	has_facet
Character classification
isspace isblank (C++11) iscntrl isupper islower isalpha	isdigit ispunct isxdigit isalnum isprint isgraph
Conversions
toupper tolower	wstring_convert (C++11) wbuffer_convert (C++11)
Facet category base classes
ctype_base codecvt_base messages_base	time_base money_base
Facet categories
ctype ctype<char> codecvt collate messages time_get time_put	num_get num_put numpunct money_get money_put moneypunct
Locale-specific facets
ctype_byname ctype_byname<char> codecvt_byname messages_byname collate_byname	time_get_byname time_put_byname numpunct_byname moneypunct_byname
Code conversion facets
codecvt_utf8 (C++11) codecvt_utf16 (C++11)	codecvt_utf8_utf16 (C++11) codecvt_mode (C++11)
C locale
setlocale localeconv lconv	LC_ALL LC_COLLATE LC_CTYPE LC_MONETARY LC_NUMERIC LC_TIME

 

std::moneypunct

Member functions

moneypunct::moneypunct

moneypunct::~moneypunct

moneypunct::decimal_point moneypunct::do_decimal_point

moneypunct::thousands_sep moneypunct::do_thousands_sep

moneypunct::grouping moneypunct::do_grouping

moneypunct::curr_symbol moneypunct::do_curr_symbol

moneypunct::frac_digits moneypunct::do_frac_digits

moneypunct::positive_sign moneypunct::do_positive_sign

moneypunct::negative_sign moneypunct::do_negative_sign

moneypunct::pos_format moneypunct::do_pos_format

moneypunct::neg_format moneypunct::do_neg_format

 

Defined in header <locale>
template< class charT, bool International = false > class moneypunct : public std::locale::facet, public std::money_base;

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.

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

Member types

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

Member constants

Member	Definition
const bool intl (static)	International

Member objects

Member	Type
id (static)	std::locale::id

Member functions

(constructor)	constructs a new moneypunct facet (public member function)
(destructor)	destructs a moneypunct facet (protected member function)
decimal_point	invokes do_decimal_point (public member function)
thousands_sep	invokes do_thousands_sep (public member function)
grouping	invokes do_grouping (public member function)
curr_symbol	invokes do_curr_symbol (public member function)
positive_sign	invokes do_positive_sign (public member function)
negative_sign	invokes do_negative_sign (public member function)
frac_digits	invokes do_frac_digits (public member function)
pos_format	invokes do_pos_format (public member function)
neg_format	invokes do_neg_format (public member function)

Protected member functions

do_decimal_point [virtual]	provides the character to use as decimal point (virtual protected member function)
do_thousands_sep [virtual]	provides the character to use as thousands separator (virtual protected member function)
do_grouping [virtual]	provides the numbers of digits between each pair of thousands separators (virtual protected member function)
do_curr_symbol [virtual]	provides the string to use as the currency identifier (virtual protected member function)
do_positive_sign [virtual]	provides the string to indicate a positive value (virtual protected member function)
do_negative_sign [virtual]	provides the string to indicate a negative value (virtual protected member function)
do_frac_digits [virtual]	provides the number of digits to display after the decimal point (virtual protected member function)
do_pos_format [virtual]	provides the formatting pattern for positive values (virtual protected member function)
do_neg_format [virtual]	provides the formatting pattern for negative values (virtual protected member function)

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

#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

money_base	defines monetary formatting patterns (class)
moneypunct_byname	extends std::moneypunct for the specified locale (class template)
money_get	parses and constructs a monetary value from an input character sequence (class template)
money_put	formats a monetary value for output as a character sequence (class template)