libstdc++
|
Classes | |
class | facet |
class | id |
Public Types | |
typedef int | category |
Public Member Functions | |
locale () throw () | |
locale (const locale &__other) throw () | |
locale (const char *__s) | |
locale (const locale &__base, const char *__s, category __cat) | |
locale (const std::string &__s) | |
locale (const locale &__base, const std::string &__s, category __cat) | |
locale (const locale &__base, const locale &__add, category __cat) | |
template<typename _Facet > | |
locale (const locale &__other, _Facet *__f) | |
~locale () throw () | |
template<typename _Facet > | |
locale | combine (const locale &__other) const |
_GLIBCXX_DEFAULT_ABI_TAG string | name () const |
bool | operator!= (const locale &__other) const throw () |
template<typename _CharT , typename _Traits , typename _Alloc > | |
bool | operator() (const basic_string< _CharT, _Traits, _Alloc > &__s1, const basic_string< _CharT, _Traits, _Alloc > &__s2) const |
template<typename _Char , typename _Traits , typename _Alloc > | |
bool | operator() (const basic_string< _Char, _Traits, _Alloc > &__s1, const basic_string< _Char, _Traits, _Alloc > &__s2) const |
const locale & | operator= (const locale &__other) throw () |
bool | operator== (const locale &__other) const throw () |
Static Public Member Functions | |
static const locale & | classic () |
static locale | global (const locale &__loc) |
Static Public Attributes | |
static const category | none |
static const category | ctype |
static const category | numeric |
static const category | collate |
static const category | time |
static const category | monetary |
static const category | messages |
static const category | all |
Friends | |
template<typename _Cache > | |
struct | __use_cache |
class | _Impl |
class | facet |
template<typename _Facet > | |
bool | has_facet (const locale &) throw () |
template<typename _Facet > | |
const _Facet & | use_facet (const locale &) |
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.
Definition at line 62 of file locale_classes.h.
typedef int std::locale::category |
Definition of locale::category.
Definition at line 67 of file locale_classes.h.
std::locale::locale | ( | ) | ||
throw | ( | |||
) |
Default constructor.
Constructs a copy of the global locale. If no locale has been explicitly set, this is the C locale.
Referenced by combine(), locale(), and operator!=().
std::locale::locale | ( | const locale & | __other | ) | |
throw | ( | ||||
) |
Copy constructor.
Constructs a copy of other.
__other | The locale to copy. |
|
explicit |
Named locale constructor.
Constructs a copy of the named C library locale.
__s | Name of the locale to construct. |
std::runtime_error | if __s is null or an undefined locale. |
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.
__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. |
std::runtime_error | if __s is null or an undefined locale. |
|
inlineexplicit |
Named locale constructor.
Constructs a copy of the named C library locale.
__s | Name of the locale to construct. |
std::runtime_error | if __s is an undefined locale. |
Definition at line 163 of file locale_classes.h.
|
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.
__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. |
std::runtime_error | if __s is an undefined locale. |
Definition at line 177 of file locale_classes.h.
References combine(), locale(), name(), operator=(), operator==(), and ~locale().
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.
__base | The locale to copy. |
__add | The locale to use facets from. |
__cat | Set of categories defining the facets to use from add. |
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.
__other | The locale to copy. |
__f | The facet to add in. |
Definition at line 45 of file locale_classes.tcc.
References combine().
std::locale::~locale | ( | ) | ||
throw | ( | |||
) |
Locale destructor.
Referenced by locale().
|
static |
Return reference to the C locale.
Referenced by operator!=().
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.
_Facet | The facet type to copy from other |
__other | The locale to copy from. |
std::runtime_error | if __other has no facet of type _Facet. |
Definition at line 63 of file locale_classes.tcc.
References std::basic_string< _CharT, _Traits, _Alloc >::data(), std::basic_string< _CharT, _Traits, _Alloc >::length(), locale(), and operator()().
Referenced by locale().
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()).
__loc | The new locale to make global. |
Referenced by operator!=().
_GLIBCXX_DEFAULT_ABI_TAG string std::locale::name | ( | ) | const |
|
inline |
Locale inequality.
__other | The locale to compare against. |
Definition at line 264 of file locale_classes.h.
References classic(), global(), locale(), operator()(), and operator==().
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:
__s1 | First string to compare. |
__s2 | Second string to compare. |
Referenced by combine(), and operator!=().
Assignment operator.
Set this locale to be a copy of other.
__other | The locale to copy. |
Referenced by std::locale::facet::facet(), std::locale::id::id(), and locale().
bool std::locale::operator== | ( | const locale & | __other | ) | const |
throw | ( | ||||
) |
Locale equality.
__other | The locale to compare against. |
Referenced by locale(), and operator!=().
|
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.
_Facet | The facet type to test the presence of. |
__loc | The locale to test. |
__loc
contains a facet of type _Facet, else false. Definition at line 104 of file locale_classes.tcc.
Referenced by std::locale::id::id().
|
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.
_Facet | The facet type to access. |
__loc | The locale to use. |
std::bad_cast | if __loc doesn't contain a facet of type _Facet. |
Definition at line 132 of file locale_classes.tcc.
Referenced by std::locale::id::id().
|
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
Definition at line 105 of file locale_classes.h.
|
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
Definition at line 101 of file locale_classes.h.
|
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
Definition at line 99 of file locale_classes.h.
|
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
Definition at line 104 of file locale_classes.h.
|
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
Definition at line 103 of file locale_classes.h.
|
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
Definition at line 98 of file locale_classes.h.
|
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
Definition at line 100 of file locale_classes.h.
|
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
Definition at line 102 of file locale_classes.h.