std::locale(3) Library Functions Manual std::locale(3) NAME std::locale - Container class for localization functionality. SYNOPSIS #include Classes class facet Localization functionality base class. class id Facet ID class. Public Types typedef int category Definition of locale::category. Public Member Functions locale () throw () Default constructor. locale (const char *__s) Named locale constructor. locale (const locale &__base, const char *__s, category __cat) Construct locale with facets from another locale. locale (const locale &__base, const locale &__add, category __cat) Construct locale with facets from another locale. locale (const locale &__base, const std::string &__s, category __cat) Construct locale with facets from another locale. locale (const locale &__other) throw () Copy constructor. template locale (const locale &__other, _Facet *__f) Construct locale with another facet. locale (const std::string &__s) Named locale constructor. ~locale () throw () Locale destructor. template locale combine (const locale &__other) const Construct locale with another facet. string name () const Return locale name. template bool operator() (const basic_string< _Char, _Traits, _Alloc > &__s1, const basic_string< _Char, _Traits, _Alloc > &__s2) const Compare two strings according to collate. template bool operator() (const basic_string< _CharT, _Traits, _Alloc > &__s1, const basic_string< _CharT, _Traits, _Alloc > &__s2) const const locale & operator= (const locale &__other) throw () Assignment operator. bool operator== (const locale &__other) const throw () Locale equality. Static Public Member Functions static const locale & classic () Return reference to the C locale. static locale global (const locale &__loc) Set global locale. Static Public Attributes static const category none Category values. static const category ctype Category values. static const category numeric Category values. static const category collate Category values. static const category time Category values. static const category monetary Category values. static const category messages Category values. static const category all Category values. Friends template const _Facet * __try_use_facet (const locale &) noexcept template struct __use_cache class _Impl class facet template bool has_facet (const locale &) throw () Test for the presence of a facet. template const _Facet & use_facet (const locale &) Return a facet. Detailed Description Container class for localization functionality. The locale class is first a class wrapper for C library locales. It is also an extensible container for user-defined localization. A locale is a collection of facets that implement various localization features such as money, time, and number printing. Constructing C++ locales does not change the C library locale. This library supports efficient construction and copying of locales through a reference counting implementation of the locale class. Member Typedef Documentation typedef int std::locale::category Definition of locale::category. Constructor & Destructor Documentation std::locale::locale () Default constructor. Constructs a copy of the global locale. If no locale has been explicitly set, this is the C locale. Referenced by combine(). std::locale::locale (const locale & __other) Copy constructor. Constructs a copy of other. Parameters __other The locale to copy. std::locale::locale (const char * __s) [explicit] Named locale constructor. Constructs a copy of the named C library locale. Parameters __s Name of the locale to construct. Exceptions std::runtime_error if __s is null or an undefined locale. std::locale::locale (const locale & __base, const char * __s, category __cat) Construct locale with facets from another locale. Constructs a copy of the locale base. The facets specified by cat are replaced with those from the locale named by s. If base is named, this locale instance will also be named. Parameters __base The locale to copy. __s Name of the locale to use facets from. __cat Set of categories defining the facets to use from __s. Exceptions std::runtime_error if __s is null or an undefined locale. std::locale::locale (const std::string & __s) [inline], [explicit] Named locale constructor. Constructs a copy of the named C library locale. Parameters __s Name of the locale to construct. Exceptions std::runtime_error if __s is an undefined locale. std::locale::locale (const locale & __base, const std::string & __s, category __cat) [inline] Construct locale with facets from another locale. Constructs a copy of the locale base. The facets specified by cat are replaced with those from the locale named by s. If base is named, this locale instance will also be named. Parameters __base The locale to copy. __s Name of the locale to use facets from. __cat Set of categories defining the facets to use from __s. Exceptions std::runtime_error if __s is an undefined locale. std::locale::locale (const locale & __base, const locale & __add, category __cat) Construct locale with facets from another locale. Constructs a copy of the locale base. The facets specified by cat are replaced with those from the locale add. If base and add are named, this locale instance will also be named. Parameters __base The locale to copy. __add The locale to use facets from. __cat Set of categories defining the facets to use from add. template std::locale::locale (const locale & __other, _Facet * __f) Construct locale with another facet. Constructs a copy of the locale __other. The facet __f is added to __other, replacing an existing facet of type Facet if there is one. If __f is null, this locale is a copy of __other. Parameters __other The locale to copy. __f The facet to add in. std::locale::~locale () Locale destructor. Member Function Documentation static const locale & std::locale::classic () [static] Return reference to the C locale. template locale std::locale::combine (const locale & __other) const Construct locale with another facet. Constructs and returns a new copy of this locale. Adds or replaces an existing facet of type Facet from the locale other into the new locale. Template Parameters _Facet The facet type to copy from other Parameters __other The locale to copy from. Returns Newly constructed locale. Exceptions std::runtime_error if __other has no facet of type _Facet. References locale(), and std::forward(). static locale std::locale::global (const locale & __loc) [static] Set global locale. This function sets the global locale to the argument and returns a copy of the previous global locale. If the argument has a name, it will also call std::setlocale(LC_ALL, loc.name()). Parameters __loc The new locale to make global. Returns Copy of the old global locale. string std::locale::name () const Return locale name. Returns Locale name or '*' if unnamed. template bool std::locale::operator() (const basic_string< _Char, _Traits, _Alloc > & __s1, const basic_string< _Char, _Traits, _Alloc > & __s2) const Compare two strings according to collate. Template operator to compare two strings using the compare function of the collate facet in this locale. One use is to provide the locale to the sort function. For example, a vector v of strings could be sorted according to locale loc by doing: std::sort(v.begin(), v.end(), loc); Parameters __s1 First string to compare. __s2 Second string to compare. Returns True if collate<_Char> facet compares __s1 < __s2, else false. const locale & std::locale::operator= (const locale & __other) Assignment operator. Set this locale to be a copy of other. Parameters __other The locale to copy. Returns A reference to this locale. bool std::locale::operator== (const locale & __other) const Locale equality. Parameters __other The locale to compare against. Returns True if other and this refer to the same locale instance, are copies, or have the same name. False otherwise. References operator==(). Referenced by operator==(). Friends And Related Symbol Documentation template bool has_facet (const locale &) [friend] Test for the presence of a facet. has_facet tests the locale argument for the presence of the facet type provided as the template parameter. Facets derived from the facet parameter will also return true. Template Parameters _Facet The facet type to test the presence of. Parameters __loc The locale to test. Returns true if __loc contains a facet of type _Facet, else false. template const _Facet & use_facet (const locale &) [friend] Return a facet. use_facet looks for and returns a reference to a facet of type Facet where Facet is the template parameter. If has_facet(locale) is true, there is a suitable facet to return. It throws std::bad_cast if the locale doesn't contain a facet of type Facet. Template Parameters _Facet The facet type to access. Parameters __loc The locale to use. Returns Reference to facet of type Facet. Exceptions std::bad_cast if __loc doesn't contain a facet of type _Facet. Member Data Documentation const category std::locale::all [static] Category values. The standard category values are none, ctype, numeric, collate, time, monetary, and messages. They form a bitmask that supports union and intersection. The category all is the union of these values. NB: Order must match _S_facet_categories definition in locale.cc const category std::locale::collate [static] Category values. The standard category values are none, ctype, numeric, collate, time, monetary, and messages. They form a bitmask that supports union and intersection. The category all is the union of these values. NB: Order must match _S_facet_categories definition in locale.cc const category std::locale::ctype [static] Category values. The standard category values are none, ctype, numeric, collate, time, monetary, and messages. They form a bitmask that supports union and intersection. The category all is the union of these values. NB: Order must match _S_facet_categories definition in locale.cc const category std::locale::messages [static] Category values. The standard category values are none, ctype, numeric, collate, time, monetary, and messages. They form a bitmask that supports union and intersection. The category all is the union of these values. NB: Order must match _S_facet_categories definition in locale.cc const category std::locale::monetary [static] Category values. The standard category values are none, ctype, numeric, collate, time, monetary, and messages. They form a bitmask that supports union and intersection. The category all is the union of these values. NB: Order must match _S_facet_categories definition in locale.cc const category std::locale::none [static] Category values. The standard category values are none, ctype, numeric, collate, time, monetary, and messages. They form a bitmask that supports union and intersection. The category all is the union of these values. NB: Order must match _S_facet_categories definition in locale.cc const category std::locale::numeric [static] Category values. The standard category values are none, ctype, numeric, collate, time, monetary, and messages. They form a bitmask that supports union and intersection. The category all is the union of these values. NB: Order must match _S_facet_categories definition in locale.cc const category std::locale::time [static] Category values. The standard category values are none, ctype, numeric, collate, time, monetary, and messages. They form a bitmask that supports union and intersection. The category all is the union of these values. NB: Order must match _S_facet_categories definition in locale.cc Author Generated automatically by Doxygen for libstdc++ from the source code. libstdc++ std::locale(3)