include/bits/locale_classes.h

52   // 22.1.1 Class locale
56    *  The locale class is first a class wrapper for C library locales.  It is
57    *  also an extensible container for user-defined localization.  A locale is
61    *  Constructing C++ locales does not change the C library locale.
64    *  through a reference counting implementation of the locale class.
66   class locale
70     /// Definition of locale::category.
83       has_facet(const locale&) throw();
87       use_facet(const locale&);
101      *  NB: Order must match _S_facet_categories definition in locale.cc
120      *  Constructs a copy of the global locale.  If no locale has been
121      *  explicitly set, this is the "C" locale.
123     locale() throw();
130      *  @param  other  The locale to copy.
132     locale(const locale& __other) throw();
135      *  @brief  Named locale constructor.
137      *  Constructs a copy of the named C library locale.
139      *  @param  s  Name of the locale to construct.
140      *  @throw  std::runtime_error if s is null or an undefined locale.
143     locale(const char* __s);
146      *  @brief  Construct locale with facets from another locale.
148      *  Constructs a copy of the locale @a base.  The facets specified by @a
149      *  cat are replaced with those from the locale named by @a s.  If base is
150      *  named, this locale instance will also be named.
152      *  @param  base  The locale to copy.
153      *  @param  s  Name of the locale to use facets from.
155      *  @throw  std::runtime_error if s is null or an undefined locale.
157     locale(const locale& __base, const char* __s, category __cat);
160      *  @brief  Construct locale with facets from another locale.
162      *  Constructs a copy of the locale @a base.  The facets specified by @a
163      *  cat are replaced with those from the locale @a add.  If @a base and @a
164      *  add are named, this locale instance will also be named.
166      *  @param  base  The locale to copy.
167      *  @param  add  The locale to use facets from.
170     locale(const locale& __base, const locale& __add, category __cat);
173      *  @brief  Construct locale with another facet.
175      *  Constructs a copy of the locale @a other.  The facet @f is added to
177      *  @f is null, this locale is a copy of @a other.
179      *  @param  other  The locale to copy.
183       locale(const locale& __other, _Facet* __f);
186     ~locale() throw();
191      *  Set this locale to be a copy of @a other.
193      *  @param  other  The locale to copy.
194      *  @return  A reference to this locale.
196     const locale&
197     operator=(const locale& __other) throw();
200      *  @brief  Construct locale with another facet.
202      *  Constructs and returns a new copy of this locale.  Adds or replaces an
203      *  existing facet of type Facet from the locale @a other into the new
204      *  locale.
207      *  @param  other  The locale to copy from.
208      *  @return  Newly constructed locale.
212       locale
213       combine(const locale& __other) const;
217      *  @brief  Return locale name.
226      *  @param  other  The locale to compare against.
227      *  @return  True if other and this refer to the same locale instance, are
231     operator==(const locale& __other) const throw ();
236      *  @param  other  The locale to compare against.
240     operator!=(const locale& __other) const throw ()
247      *  the collate facet in this locale.  One use is to provide the locale to
249      *  according to locale loc by doing:
263     // Global locale objects:
265      *  @brief  Set global locale
267      *  This function sets the global locale to the argument and returns a
268      *  copy of the previous global locale.  If the argument has a name, it
271      *  @param  locale  The new locale to make global.
272      *  @return  Copy of the old global locale.
274     static locale
275     global(const locale&);
278      *  @brief  Return reference to the "C" locale.
280     static const locale&
287     // The "C" reference locale
290     // Current global locale
293     // Names of underlying locale categories.
294     // NB: locale::global() has to know how to modify all the
316     locale(_Impl*) throw();
328     _M_coalesce(const locale& __base, const locale& __add, category __cat);
332   // 22.1.1.1.2  Class locale::facet
342   class locale::facet
345     friend class locale;
346     friend class locale::_Impl;
350     // Contains data from the underlying "C" library for the classic locale.
353     // String literal for the name of the classic locale.
368      *  facet is destroyed when the last referencing locale is destroyed.
392     // classic locale.
423   // 22.1.1.1.3 Class locale::id
428    *  Every facet class must define a public static member locale::id, or be
430    *  cannot be used in a locale.  The locale::id ensures that each class
433   class locale::id
436     friend class locale;
437     friend class locale::_Impl;
441       use_facet(const locale&);
445       has_facet(const locale&) throw ();
471   // Implementation object for locale.
472   class locale::_Impl
476     friend class locale;
477     friend class locale::facet;
481       has_facet(const locale&) throw();
485       use_facet(const locale&);
497     static const locale::id* const	_S_id_ctype[];
498     static const locale::id* const	_S_id_numeric[];
499     static const locale::id* const	_S_id_collate[];
500     static const locale::id* const	_S_id_time[];
501     static const locale::id* const	_S_id_monetary[];
502     static const locale::id* const	_S_id_messages[];
503     static const locale::id* const* const _S_facet_categories[];
547     _M_replace_category(const _Impl*, const locale::id* const*);
550     _M_replace_facet(const _Impl*, const locale::id*);
553     _M_install_facet(const locale::id*, const facet*);
565     locale::locale(const locale& __other, _Facet* __f)