Scroll to navigation

std::moneypunct::curr_symbol,do_curr_symbol(3) C++ Standard Libary std::moneypunct::curr_symbol,do_curr_symbol(3)

NAME

std::moneypunct::curr_symbol,do_curr_symbol - std::moneypunct::curr_symbol,do_curr_symbol

Synopsis


Defined in header <locale>
public: (1)
string_type curr_symbol() const;
protected: (2)
virtual string_type do_curr_symbol() const;


1) Public member function, calls the member function do_curr_symbol of the most
derived class.
2) Returns the string used as the currency identifier by this locale. If
International (the second template parameter of std::moneypunct) is false, the
identifier is usually a single (wide) character, such as "¥" or "$". If
International is true, the identifier is usually a four-character string holding the
three-character ISO 4217 currency code followed by a space ("JPY " or "USD ").

Return value


The object of type string_type holding the currency symbol or code.

Example

// Run this code


#include <iostream>
#include <locale>


void show_ccy(const char* locname)
{
std::locale loc(locname);
std::cout << locname << " currency symbol is "
<< std::use_facet<std::moneypunct<char, true>>(loc).curr_symbol()
<< "or " << std::use_facet<std::moneypunct<char>>(loc).curr_symbol()
<< " for short\n";
}


int main()
{
show_ccy("en_US.utf8");
show_ccy("ja_JP.utf8");
show_ccy("sv_SE.utf8");
show_ccy("ru_RU.utf8");
show_ccy("vi_VN.utf8");
}

Output:


en_US.utf8 currency symbol is USD or $ for short
ja_JP.utf8 currency symbol is JPY or ¥ for short
sv_SE.utf8 currency symbol is SEK or kr for short
ru_RU.utf8 currency symbol is RUB or руб for short
vi_VN.utf8 currency symbol is VND or ₫ for short


Defect reports


The following behavior-changing defect reports were applied retroactively to
previously published C++ standards.


DR Applied to Behavior as published Correct behavior
LWG 666 C++98 the length of the identifier string was required not required
to be 4 if International is true

See also


do_pos_format provides the formatting pattern for currency values
do_neg_format (virtual protected member function)
[virtual]

2024.06.10 http://cppreference.com