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: Working with multiple locales
</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('working_with_multiple_locales.html','');});
62 <div id=
"doc-content">
64 <div class=
"headertitle">
65 <div class=
"title">Working with multiple locales
</div> </div>
67 <div class=
"contents">
68 <div class=
"textblock"><p>Boost.Locale allows you to work safely with multiple locales in the same process. As we mentioned before, the locale generation process is not a cheap one. Thus, when we work with multiple locales and need to switch between them, we recommend that you create all the locales you need when the program starts.
</p>
69 <p>To simplify this process, the
<a class=
"el" href=
"classboost_1_1locale_1_1generator.html" title=
"the major class used for locale generation ">boost::locale::generator
</a> class has an option to cache all generated locales. With this option, when you create a locale that was previously generated, it would be fetched from the existing locale set instead. This operation is thread safe.
</p>
70 <p>This option must be explicitly enabled by calling the
<a class=
"el" href=
"classboost_1_1locale_1_1generator.html#ac2d152e2803cd96f4acc646943f2df51">locale_cache_enabled
</a> member function of
<a class=
"el" href=
"classboost_1_1locale_1_1generator.html" title=
"the major class used for locale generation ">boost::locale::generator
</a> with
<code>true
</code> as the parameter.
</p>
72 <div class=
"fragment"><div class=
"line">generator gen;
</div>
73 <div class=
"line">gen.
<a class=
"code" href=
"classboost_1_1locale_1_1generator.html#ac2d152e2803cd96f4acc646943f2df51">locale_cache_enabled
</a>(
<span class=
"keyword">true
</span>);
</div>
74 <div class=
"line">gen(
<span class=
"stringliteral">"en_US.UTF-
8"</span>);
</div>
75 <div class=
"line">gen(
<span class=
"stringliteral">"de_DE.UTF-
8"</span>);
</div>
76 <div class=
"line">gen(
<span class=
"stringliteral">"ja_JP.UTF-
8"</span>);
</div>
77 <div class=
"line"><span class=
"comment">// Create all locales
</span></div>
78 <div class=
"line"></div>
79 <div class=
"line">std::locale en=gen(
<span class=
"stringliteral">"en_US.UTF-
8"</span>);
</div>
80 <div class=
"line"><span class=
"comment">// Fetch an existing locale from the cache
</span></div>
81 <div class=
"line">std::locale ar=gen(
<span class=
"stringliteral">"ar_EG.UTF-
8"</span>);
</div>
82 <div class=
"line"><span class=
"comment">// Because ar_EG not in the cache, a new locale is generated (and cached)
</span></div>
83 </div><!-- fragment --><p>Then these locales can be imbued to
<code>iostreams
</code> or used directly as parameters to various functions.
</p>
84 </div></div><!-- contents -->
85 </div><!-- doc-content -->
88 © 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.