1234567891011121314151617181920212223242526272829303132333435 |
- //
- // Copyright (c) 2009-2011 Artyom Beilis (Tonkikh)
- //
- // Distributed under the Boost Software License, Version 1.0. (See
- // accompanying file LICENSE_1_0.txt or copy at
- // http://www.boost.org/LICENSE_1_0.txt)
- //
- // vim: tabstop=4 expandtab shiftwidth=4 softtabstop=4 filetype=cpp.doxygen
- /*!
- \page locale_information Getting information about the current locale
- The \c std::locale::name function provides very limited information about a locale. Such a name is platform-
- and compiler-dependent, and is useless for Boost.Locale. There is no way to change it, so for all locales
- created by Boost.Locale, \c name() returns the same value as \c name() for \c std::locale::classic().
- Thus an additional facet was created, giving more precise information: boost::locale::info. It has the following member functions:
- - \ref boost::locale::info::name() "std::string name()" -- the full name of the locale, for example \c en_US.UTF-8
- - \ref boost::locale::info::language() "std::string language()" -- the ISO-639 language code of the current locale, for example "en".
- - \ref boost::locale::info::country() "std::string country()" -- the ISO-3199 country code of the current locale, for example "US".
- - \ref boost::locale::info::variant() "std::string variant()" -- the variant of current locale, for example "euro".
- - \ref boost::locale::info::encoding() "std::string encoding()" -- the encoding used for \c char based strings, for example "UTF-8"
- - \ref boost::locale::info::utf8() "bool utf8()" -- a fast way to check whether the encoding is UTF-8.
- For example:
- \code
- cout << "The language code is " << std::use_facet<boost::locale::info>(some_locale).language() << endl;
- \endcode
- */
|