1 <!DOCTYPE html PUBLIC
"-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2 <html xmlns=
"http://www.w3.org/1999/xhtml">
4 <meta http-equiv=
"Content-Type" content=
"text/xhtml;charset=UTF-8"/>
5 <meta http-equiv=
"X-UA-Compatible" content=
"IE=9"/>
6 <meta name=
"generator" content=
"Doxygen 1.8.6"/>
7 <title>Boost.Locale: Getting information about the current locale
</title>
8 <link href=
"tabs.css" rel=
"stylesheet" type=
"text/css"/>
9 <script type=
"text/javascript" src=
"jquery.js"></script>
10 <script type=
"text/javascript" src=
"dynsections.js"></script>
11 <link href=
"navtree.css" rel=
"stylesheet" type=
"text/css"/>
12 <script type=
"text/javascript" src=
"resize.js"></script>
13 <script type=
"text/javascript" src=
"navtree.js"></script>
14 <script type=
"text/javascript">
15 $(document).ready(initResizable);
16 $(window).load(resizeHeight);
18 <link href=
"doxygen.css" rel=
"stylesheet" type=
"text/css" />
21 <div id=
"top"><!-- do not remove this div, it is closed by doxygen! -->
23 <table cellspacing=
"0" cellpadding=
"0">
25 <tr style=
"height: 56px;">
26 <td id=
"projectlogo"><img alt=
"Logo" src=
"boost-small.png"/></td>
27 <td style=
"padding-left: 0.5em;">
28 <div id=
"projectname">Boost.Locale
35 <!-- end header part -->
36 <!-- Generated by Doxygen 1.8.6 -->
37 <div id=
"navrow1" class=
"tabs">
39 <li><a href=
"index.html"><span>Main
 Page
</span></a></li>
40 <li class=
"current"><a href=
"pages.html"><span>Related
 Pages
</span></a></li>
41 <li><a href=
"modules.html"><span>Modules
</span></a></li>
42 <li><a href=
"namespaces.html"><span>Namespaces
</span></a></li>
43 <li><a href=
"annotated.html"><span>Classes
</span></a></li>
44 <li><a href=
"files.html"><span>Files
</span></a></li>
45 <li><a href=
"examples.html"><span>Examples
</span></a></li>
49 <div id=
"side-nav" class=
"ui-resizable side-nav-resizable">
51 <div id=
"nav-tree-contents">
52 <div id=
"nav-sync" class=
"sync"></div>
55 <div id=
"splitbar" style=
"-moz-user-select:none;"
56 class=
"ui-resizable-handle">
59 <script type=
"text/javascript">
60 $(document).ready(function(){initNavTree('locale_information.html','');});
62 <div id=
"doc-content">
64 <div class=
"headertitle">
65 <div class=
"title">Getting information about the current locale
</div> </div>
67 <div class=
"contents">
68 <div class=
"textblock"><p>The
<code>std::locale::name
</code> 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,
<code>name()
</code> returns the same value as
<code>name()
</code> for
<code>std::locale::classic()
</code>.
</p>
69 <p>Thus an additional facet was created, giving more precise information:
<a class=
"el" href=
"classboost_1_1locale_1_1info.html" title=
"a facet that holds general information about locale ">boost::locale::info
</a>. It has the following member functions:
</p>
71 <li><a class=
"el" href=
"classboost_1_1locale_1_1info.html#af8181bf226f369548c030220932323b9">std::string name()
</a> – the full name of the locale, for example
<code>en_US.UTF-
8</code> </li>
72 <li><a class=
"el" href=
"classboost_1_1locale_1_1info.html#a7c56b9df3aba82649afc66c06192c7df">std::string language()
</a> – the ISO-
639 language code of the current locale, for example
"en".
</li>
73 <li><a class=
"el" href=
"classboost_1_1locale_1_1info.html#a249c20e36da6827a8dc8b12a8342a7dc">std::string country()
</a> – the ISO-
3199 country code of the current locale, for example
"US".
</li>
74 <li><a class=
"el" href=
"classboost_1_1locale_1_1info.html#a2e949e4362c8f0195e2a645fe875f1b4">std::string variant()
</a> – the variant of current locale, for example
"euro".
</li>
75 <li><a class=
"el" href=
"classboost_1_1locale_1_1info.html#a1979a5d7b90604c45e856a139c68f5ba">std::string encoding()
</a> – the encoding used for
<code>char
</code> based strings, for example
"UTF-8"</li>
76 <li><a class=
"el" href=
"classboost_1_1locale_1_1info.html#aafbbb5c291f60ce6fc3bc056859ba181">bool utf8()
</a> – a fast way to check whether the encoding is UTF-
8.
</li>
79 <div class=
"fragment"><div class=
"line">cout
<< <span class=
"stringliteral">"The language code is
"</span> << std::use_facet
<boost::locale::info
>(some_locale).language()
<< endl;
</div>
80 </div><!-- fragment --> </div></div><!-- contents -->
81 </div><!-- doc-content -->
84 © Copyright
2009-
2012 Artyom Beilis, Distributed under the
<a href=
"http://www.boost.org/LICENSE_1_0.txt">Boost Software License
</a>, Version
1.0.