header
<locale>Localization library
A locale is a set of features that are culture-specific, which can be used by programs to be more portable internationally.In C++, locales are represented by an object of the locale class. Each of these locale objects contains all the information needed to use a set of culture-dependent features. But locale objects do not contain the features directly themselves as member functions: instead, a locale object contains information about which facet objects it selects, and is each one of these facet objects that implements specific features as member functions. This allows for features that are common to several locales to be shared by using the same facet objects, and makes them extensible, allowing custom facets to be added to locale objects.
Facets are divided into six standard categories:
category facet member functions collate collate compare, hash, transform ctype ctype is, narrow, scan_is, scan_not, tolower, toupper, widen codecvt always_noconv, encoding, in, length, max_length, out, unshift monetary moneypunct curr_symbol, decimal_point, frac_digits, grouping, negative_sign, neg_format, positive_sign, pos_format, thousands_sep money_get get money_put put numeric numpunct decimal_point, falsename, grouping, thousands_sep, truename num_get get num_put put time time_get date_order, get_date, get_monthname, get_time, get_weekday, get_year (and get, since C++11) time_put put messages messages close, get, openThus, the core of the localization functionality in C++ is implemented in the different facets. Facets are objects. These objects are managed automatically by the locale engine, therefore facet objects are generally neither constructed nor copied locally in a program (in fact a program is prevented to do so by their protected destructors). The most general way of accessing a particular feature of a facet associated with a locale is with the function use_facet:
1
2
3
4
5
6
// using facet member directly:
myvar = use_facet < numpunct<char> > (mylocale).decimal_point();
// alias facet:
const numpunct<char>& myfacet = use_facet < numpunct<char> > (mylocale);
myvar = myfacet.decimal_point();
All facet constructors include as second parameter (called refs in this reference) that defines whether the class deallocation is delegated to the locale engine, and hence it is automatically deleted when the last locale object where it is present is destroyed, or whether the program is in charge of its deletion at some point.
Some facet have an equivalent but ending with "_byname"
. These facet types are used by the localization engine to construct the appropriate facet objects when a named locale object is constructed.
All the standard facets are designed with public members that call virtual protected members with the same name, but preceded with "do_"
. The implementation of the operation itself lies in the virtual protected member function (so that derived class can easily overwrite it), while the non-virtual public function may implement platform-specific functionality not related to the operation itself, but necessary to allow the feature to work properly on the system.
All library implementations provide at least all the facets by default for the char
and wchar_t
types as template parameters for the facet's character type.
All library implementations provide at least all the facets by default for the
char
and
wchar_t
types as template parameters for the
facet's character type. Additionally, the
codecvtfacet is also required to support
char16_t
and
char32_t
.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4