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: wconversions.cpp
</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><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('wconversions_8cpp-example.html','');});
62 <div id=
"doc-content">
64 <div class=
"headertitle">
65 <div class=
"title">wconversions.cpp
</div> </div>
67 <div class=
"contents">
68 <p>Example of using various text conversion functions with wide strings.
</p>
69 <div class=
"fragment"><div class=
"line"><span class=
"comment">//
</span></div>
70 <div class=
"line"><span class=
"comment">// Copyright (c)
2009-
2011 Artyom Beilis (Tonkikh)
</span></div>
71 <div class=
"line"><span class=
"comment">//
</span></div>
72 <div class=
"line"><span class=
"comment">// Distributed under the Boost Software License, Version
1.0. (See
</span></div>
73 <div class=
"line"><span class=
"comment">// accompanying file LICENSE_1_0.txt or copy at
</span></div>
74 <div class=
"line"><span class=
"comment">// http://www.boost.org/LICENSE_1_0.txt)
</span></div>
75 <div class=
"line"><span class=
"comment">//
</span></div>
76 <div class=
"line"></div>
77 <div class=
"line"><span class=
"comment">//
</span></div>
78 <div class=
"line"><span class=
"comment">// ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! !
</span></div>
79 <div class=
"line"><span class=
"comment">//
</span></div>
80 <div class=
"line"><span class=
"comment">// BIG FAT WARNING FOR Microsoft Visual Studio Users
</span></div>
81 <div class=
"line"><span class=
"comment">//
</span></div>
82 <div class=
"line"><span class=
"comment">// YOU NEED TO CONVERT THIS SOURCE FILE ENCODING TO UTF-
8 WITH BOM ENCODING.
</span></div>
83 <div class=
"line"><span class=
"comment">//
</span></div>
84 <div class=
"line"><span class=
"comment">// Unfortunately MSVC understands that the source code is encoded as
</span></div>
85 <div class=
"line"><span class=
"comment">// UTF-
8 only if you add useless BOM in the beginning.
</span></div>
86 <div class=
"line"><span class=
"comment">//
</span></div>
87 <div class=
"line"><span class=
"comment">// So, before you compile
"wide
" examples with MSVC, please convert them to text
</span></div>
88 <div class=
"line"><span class=
"comment">// files with BOM. There are two very simple ways to do it:
</span></div>
89 <div class=
"line"><span class=
"comment">//
</span></div>
90 <div class=
"line"><span class=
"comment">//
1. Open file with Notepad and save it from there. It would convert
</span></div>
91 <div class=
"line"><span class=
"comment">// it to file with BOM.
</span></div>
92 <div class=
"line"><span class=
"comment">//
2. In Visual Studio go File-
>Advances Save Options... and select
</span></div>
93 <div class=
"line"><span class=
"comment">// Unicode (UTF-
8 with signature) Codepage
65001</span></div>
94 <div class=
"line"><span class=
"comment">//
</span></div>
95 <div class=
"line"><span class=
"comment">// Note: once converted to UTF-
8 with BOM, this source code would not
</span></div>
96 <div class=
"line"><span class=
"comment">// compile with other compilers, because no-one uses BOM with UTF-
8 today
</span></div>
97 <div class=
"line"><span class=
"comment">// because it is absolutely meaningless in context of UTF-
8.
</span></div>
98 <div class=
"line"><span class=
"comment">//
</span></div>
99 <div class=
"line"><span class=
"comment">// ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! !
</span></div>
100 <div class=
"line"><span class=
"comment">//
</span></div>
101 <div class=
"line"><span class=
"preprocessor">#include
<boost/locale.hpp
></span></div>
102 <div class=
"line"><span class=
"preprocessor">#include
<boost/algorithm/string/case_conv.hpp
></span></div>
103 <div class=
"line"><span class=
"preprocessor">#include
<iostream
></span></div>
104 <div class=
"line"></div>
105 <div class=
"line"><span class=
"preprocessor">#include
<ctime
></span></div>
106 <div class=
"line"></div>
107 <div class=
"line"></div>
108 <div class=
"line"><span class=
"keywordtype">int
</span> main()
</div>
109 <div class=
"line">{
</div>
110 <div class=
"line"> <span class=
"keyword">using namespace
</span>boost::locale;
</div>
111 <div class=
"line"> <span class=
"keyword">using namespace
</span>std;
</div>
112 <div class=
"line"> <span class=
"comment">// Create system default locale
</span></div>
113 <div class=
"line"> <a name=
"_a0"></a><a class=
"code" href=
"classboost_1_1locale_1_1generator.html">generator
</a> gen;
</div>
114 <div class=
"line"> locale loc=gen(
<span class=
"stringliteral">""</span>);
</div>
115 <div class=
"line"> locale::global(loc);
</div>
116 <div class=
"line"> wcout.imbue(loc);
</div>
117 <div class=
"line"></div>
118 <div class=
"line"> <span class=
"comment">// This is needed to prevent C library to
</span></div>
119 <div class=
"line"> <span class=
"comment">// convert strings to narrow
</span></div>
120 <div class=
"line"> <span class=
"comment">// instead of C++ on some platforms
</span></div>
121 <div class=
"line"> std::ios_base::sync_with_stdio(
<span class=
"keyword">false
</span>);
</div>
122 <div class=
"line"></div>
123 <div class=
"line"> </div>
124 <div class=
"line"> wcout
<<L
<span class=
"stringliteral">"Correct case conversion can
't be done by simple, character by character conversion
"</span><<endl;
</div>
125 <div class=
"line"> wcout
<<L
<span class=
"stringliteral">"because case conversion is context sensitive and not
1-to-
1 conversion
"</span><<endl;
</div>
126 <div class=
"line"> wcout
<<L
<span class=
"stringliteral">"For example:
"</span><<endl;
</div>
127 <div class=
"line"> wcout
<<L
<span class=
"stringliteral">" German grüßen correctly converted to
"</span><<<a name=
"a1"></a><a class=
"code" href=
"group__convert.html#ga2ceae621801e8cf4f77c60d1e3047ae8">to_upper
</a>(L
<span class=
"stringliteral">"grüßen
"</span>)
<<L
<span class=
"stringliteral">", instead of incorrect
"</span></div>
128 <div class=
"line"> <<boost::to_upper_copy(std::wstring(L
<span class=
"stringliteral">"grüßen
"</span>))
<<endl;
</div>
129 <div class=
"line"> wcout
<<L
<span class=
"stringliteral">" where ß is replaced with SS
"</span><<endl;
</div>
130 <div class=
"line"> wcout
<<L
<span class=
"stringliteral">" Greek ὈΔΥΣΣΕΎΣ is correctly converted to
"</span><<<a name=
"a2"></a><a class=
"code" href=
"group__convert.html#ga4a3eb15f42f5cbae7bdd00c9e9cac222">to_lower
</a>(L
<span class=
"stringliteral">"ὈΔΥΣΣΕΎΣ
"</span>)
<<L
<span class=
"stringliteral">", instead of incorrect
"</span></div>
131 <div class=
"line"> <<boost::to_lower_copy(std::wstring(L
<span class=
"stringliteral">"ὈΔΥΣΣΕΎΣ
"</span>))
<<endl;
</div>
132 <div class=
"line"> wcout
<<L
<span class=
"stringliteral">" where Σ is converted to σ or to ς, according to position in the word
"</span><<endl;
</div>
133 <div class=
"line"> wcout
<<L
<span class=
"stringliteral">"Such type of conversion just can
't be done using std::toupper that work on character base, also std::toupper is
"</span><<endl;
</div>
134 <div class=
"line"> wcout
<<L
<span class=
"stringliteral">"not fully applicable when working with variable character length like in UTF-
8 or UTF-
16 limiting the correct
"</span><<endl;
</div>
135 <div class=
"line"> wcout
<<L
<span class=
"stringliteral">"behavoir to BMP or ASCII only
"</span><<endl;
</div>
136 <div class=
"line"> </div>
137 <div class=
"line">}
</div>
138 <div class=
"line"></div>
139 <div class=
"line"><span class=
"comment">// vim: tabstop=
4 expandtab shiftwidth=
4 softtabstop=
4</span></div>
140 <div class=
"line"></div>
141 <div class=
"line"><span class=
"comment">// boostinspect:noascii
</span></div>
142 </div><!-- fragment --> </div><!-- contents -->
143 </div><!-- doc-content -->
146 © 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.