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"> 3<head> 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: Character conversion functions</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); 17</script> 18<link href="doxygen.css" rel="stylesheet" type="text/css" /> 19</head> 20<body> 21<div id="top"><!-- do not remove this div, it is closed by doxygen! --> 22<div id="titlearea"> 23<table cellspacing="0" cellpadding="0"> 24 <tbody> 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 29 </div> 30 </td> 31 </tr> 32 </tbody> 33</table> 34</div> 35<!-- end header part --> 36<!-- Generated by Doxygen 1.8.6 --> 37 <div id="navrow1" class="tabs"> 38 <ul class="tablist"> 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> 46 </ul> 47 </div> 48</div><!-- top --> 49<div id="side-nav" class="ui-resizable side-nav-resizable"> 50 <div id="nav-tree"> 51 <div id="nav-tree-contents"> 52 <div id="nav-sync" class="sync"></div> 53 </div> 54 </div> 55 <div id="splitbar" style="-moz-user-select:none;" 56 class="ui-resizable-handle"> 57 </div> 58</div> 59<script type="text/javascript"> 60$(document).ready(function(){initNavTree('group__codepage.html','');}); 61</script> 62<div id="doc-content"> 63<div class="header"> 64 <div class="summary"> 65<a href="#nested-classes">Classes</a> | 66<a href="#enum-members">Enumerations</a> | 67<a href="#func-members">Functions</a> </div> 68 <div class="headertitle"> 69<div class="title">Character conversion functions</div> </div> 70</div><!--header--> 71<div class="contents"> 72<table class="memberdecls"> 73<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="nested-classes"></a> 74Classes</h2></td></tr> 75<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">class  </td><td class="memItemRight" valign="bottom"><a class="el" href="classboost_1_1locale_1_1conv_1_1conversion__error.html">boost::locale::conv::conversion_error</a></td></tr> 76<tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight">The excepton that is thrown in case of conversion error. <a href="classboost_1_1locale_1_1conv_1_1conversion__error.html#details">More...</a><br/></td></tr> 77<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr> 78<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">class  </td><td class="memItemRight" valign="bottom"><a class="el" href="classboost_1_1locale_1_1conv_1_1invalid__charset__error.html">boost::locale::conv::invalid_charset_error</a></td></tr> 79<tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight">This exception is thrown in case of use of unsupported or invalid character set. <a href="classboost_1_1locale_1_1conv_1_1invalid__charset__error.html#details">More...</a><br/></td></tr> 80<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr> 81</table><table class="memberdecls"> 82<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="enum-members"></a> 83Enumerations</h2></td></tr> 84<tr class="memitem:ga8e3c5a274f57107ec5745e227c26ba84"><td class="memItemLeft" align="right" valign="top">enum  </td><td class="memItemRight" valign="bottom"><a class="el" href="group__codepage.html#ga8e3c5a274f57107ec5745e227c26ba84">boost::locale::conv::method_type</a> { <a class="el" href="group__codepage.html#gga8e3c5a274f57107ec5745e227c26ba84ae9b554a2955deddf714757788819edf9">boost::locale::conv::skip</a> = 0, 85<a class="el" href="group__codepage.html#gga8e3c5a274f57107ec5745e227c26ba84aab08f9ee241c405ef40bd3cedb43b383">boost::locale::conv::stop</a> = 1, 86<a class="el" href="group__codepage.html#gga8e3c5a274f57107ec5745e227c26ba84adcdc34a57dd2a3ca917f73c13f18b559">boost::locale::conv::default_method</a> = skip 87 }</td></tr> 88<tr class="separator:ga8e3c5a274f57107ec5745e227c26ba84"><td class="memSeparator" colspan="2"> </td></tr> 89</table><table class="memberdecls"> 90<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="func-members"></a> 91Functions</h2></td></tr> 92<tr class="memitem:ga2ca59a735ca28c9d5103e37ef2373ca1"><td class="memTemplParams" colspan="2">template<typename CharType > </td></tr> 93<tr class="memitem:ga2ca59a735ca28c9d5103e37ef2373ca1"><td class="memTemplItemLeft" align="right" valign="top">std::basic_string< CharType > </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="group__codepage.html#ga2ca59a735ca28c9d5103e37ef2373ca1">boost::locale::conv::to_utf</a> (char const *begin, char const *end, std::string const &charset, method_type how=default_method)</td></tr> 94<tr class="separator:ga2ca59a735ca28c9d5103e37ef2373ca1"><td class="memSeparator" colspan="2"> </td></tr> 95<tr class="memitem:gaef8fb7771dce60511d081770547a4139"><td class="memTemplParams" colspan="2">template<typename CharType > </td></tr> 96<tr class="memitem:gaef8fb7771dce60511d081770547a4139"><td class="memTemplItemLeft" align="right" valign="top">std::string </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="group__codepage.html#gaef8fb7771dce60511d081770547a4139">boost::locale::conv::from_utf</a> (CharType const *begin, CharType const *end, std::string const &charset, method_type how=default_method)</td></tr> 97<tr class="separator:gaef8fb7771dce60511d081770547a4139"><td class="memSeparator" colspan="2"> </td></tr> 98<tr class="memitem:ga5ae3d72f015dc847ddfd688a0a40ff66"><td class="memTemplParams" colspan="2">template<typename CharType > </td></tr> 99<tr class="memitem:ga5ae3d72f015dc847ddfd688a0a40ff66"><td class="memTemplItemLeft" align="right" valign="top">std::basic_string< CharType > </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="group__codepage.html#ga5ae3d72f015dc847ddfd688a0a40ff66">boost::locale::conv::to_utf</a> (char const *begin, char const *end, std::locale const &loc, method_type how=default_method)</td></tr> 100<tr class="separator:ga5ae3d72f015dc847ddfd688a0a40ff66"><td class="memSeparator" colspan="2"> </td></tr> 101<tr class="memitem:ga0eee2960f0d6d15491c5b95dd3054d9a"><td class="memTemplParams" colspan="2">template<typename CharType > </td></tr> 102<tr class="memitem:ga0eee2960f0d6d15491c5b95dd3054d9a"><td class="memTemplItemLeft" align="right" valign="top">std::string </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="group__codepage.html#ga0eee2960f0d6d15491c5b95dd3054d9a">boost::locale::conv::from_utf</a> (CharType const *begin, CharType const *end, std::locale const &loc, method_type how=default_method)</td></tr> 103<tr class="separator:ga0eee2960f0d6d15491c5b95dd3054d9a"><td class="memSeparator" colspan="2"> </td></tr> 104<tr class="memitem:ga25227e4e43f6c695dac13844a94741ea"><td class="memTemplParams" colspan="2">template<typename CharType > </td></tr> 105<tr class="memitem:ga25227e4e43f6c695dac13844a94741ea"><td class="memTemplItemLeft" align="right" valign="top">std::basic_string< CharType > </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="group__codepage.html#ga25227e4e43f6c695dac13844a94741ea">boost::locale::conv::to_utf</a> (std::string const &text, std::string const &charset, method_type how=default_method)</td></tr> 106<tr class="separator:ga25227e4e43f6c695dac13844a94741ea"><td class="memSeparator" colspan="2"> </td></tr> 107<tr class="memitem:ga17c2c9d8659281848db73822fcc38092"><td class="memTemplParams" colspan="2">template<typename CharType > </td></tr> 108<tr class="memitem:ga17c2c9d8659281848db73822fcc38092"><td class="memTemplItemLeft" align="right" valign="top">std::string </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="group__codepage.html#ga17c2c9d8659281848db73822fcc38092">boost::locale::conv::from_utf</a> (std::basic_string< CharType > const &text, std::string const &charset, method_type how=default_method)</td></tr> 109<tr class="separator:ga17c2c9d8659281848db73822fcc38092"><td class="memSeparator" colspan="2"> </td></tr> 110<tr class="memitem:ga2be733c3e2028aa43e4b35100bdb1322"><td class="memTemplParams" colspan="2">template<typename CharType > </td></tr> 111<tr class="memitem:ga2be733c3e2028aa43e4b35100bdb1322"><td class="memTemplItemLeft" align="right" valign="top">std::basic_string< CharType > </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="group__codepage.html#ga2be733c3e2028aa43e4b35100bdb1322">boost::locale::conv::to_utf</a> (char const *text, std::string const &charset, method_type how=default_method)</td></tr> 112<tr class="separator:ga2be733c3e2028aa43e4b35100bdb1322"><td class="memSeparator" colspan="2"> </td></tr> 113<tr class="memitem:gab784637ee28adb9538b8002dadf0b273"><td class="memTemplParams" colspan="2">template<typename CharType > </td></tr> 114<tr class="memitem:gab784637ee28adb9538b8002dadf0b273"><td class="memTemplItemLeft" align="right" valign="top">std::string </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="group__codepage.html#gab784637ee28adb9538b8002dadf0b273">boost::locale::conv::from_utf</a> (CharType const *text, std::string const &charset, method_type how=default_method)</td></tr> 115<tr class="separator:gab784637ee28adb9538b8002dadf0b273"><td class="memSeparator" colspan="2"> </td></tr> 116<tr class="memitem:ga4c22a2bcb97338274752f95e2d265442"><td class="memTemplParams" colspan="2">template<typename CharType > </td></tr> 117<tr class="memitem:ga4c22a2bcb97338274752f95e2d265442"><td class="memTemplItemLeft" align="right" valign="top">std::basic_string< CharType > </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="group__codepage.html#ga4c22a2bcb97338274752f95e2d265442">boost::locale::conv::to_utf</a> (std::string const &text, std::locale const &loc, method_type how=default_method)</td></tr> 118<tr class="separator:ga4c22a2bcb97338274752f95e2d265442"><td class="memSeparator" colspan="2"> </td></tr> 119<tr class="memitem:ga85cc81b352a88e12191926b95eb39aeb"><td class="memTemplParams" colspan="2">template<typename CharType > </td></tr> 120<tr class="memitem:ga85cc81b352a88e12191926b95eb39aeb"><td class="memTemplItemLeft" align="right" valign="top">std::string </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="group__codepage.html#ga85cc81b352a88e12191926b95eb39aeb">boost::locale::conv::from_utf</a> (std::basic_string< CharType > const &text, std::locale const &loc, method_type how=default_method)</td></tr> 121<tr class="separator:ga85cc81b352a88e12191926b95eb39aeb"><td class="memSeparator" colspan="2"> </td></tr> 122<tr class="memitem:gac298fcddef144915332f031f4565feb0"><td class="memTemplParams" colspan="2">template<typename CharType > </td></tr> 123<tr class="memitem:gac298fcddef144915332f031f4565feb0"><td class="memTemplItemLeft" align="right" valign="top">std::basic_string< CharType > </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="group__codepage.html#gac298fcddef144915332f031f4565feb0">boost::locale::conv::to_utf</a> (char const *text, std::locale const &loc, method_type how=default_method)</td></tr> 124<tr class="separator:gac298fcddef144915332f031f4565feb0"><td class="memSeparator" colspan="2"> </td></tr> 125<tr class="memitem:ga2a41ad85803d97f7e1906d5c0561eefa"><td class="memTemplParams" colspan="2">template<typename CharType > </td></tr> 126<tr class="memitem:ga2a41ad85803d97f7e1906d5c0561eefa"><td class="memTemplItemLeft" align="right" valign="top">std::string </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="group__codepage.html#ga2a41ad85803d97f7e1906d5c0561eefa">boost::locale::conv::from_utf</a> (CharType const *text, std::locale const &loc, method_type how=default_method)</td></tr> 127<tr class="separator:ga2a41ad85803d97f7e1906d5c0561eefa"><td class="memSeparator" colspan="2"> </td></tr> 128<tr class="memitem:ga7eda9058b8cbac9b05886bcc894faeff"><td class="memItemLeft" align="right" valign="top">std::string </td><td class="memItemRight" valign="bottom"><a class="el" href="group__codepage.html#ga7eda9058b8cbac9b05886bcc894faeff">boost::locale::conv::between</a> (char const *begin, char const *end, std::string const &to_encoding, std::string const &from_encoding, method_type how=default_method)</td></tr> 129<tr class="separator:ga7eda9058b8cbac9b05886bcc894faeff"><td class="memSeparator" colspan="2"> </td></tr> 130<tr class="memitem:ga612607a8616add30cf21ceb086e664d5"><td class="memItemLeft" align="right" valign="top">std::string </td><td class="memItemRight" valign="bottom"><a class="el" href="group__codepage.html#ga612607a8616add30cf21ceb086e664d5">boost::locale::conv::between</a> (char const *text, std::string const &to_encoding, std::string const &from_encoding, method_type how=default_method)</td></tr> 131<tr class="separator:ga612607a8616add30cf21ceb086e664d5"><td class="memSeparator" colspan="2"> </td></tr> 132<tr class="memitem:gad7f6c33cf95749ab48174ccafddf7b62"><td class="memItemLeft" align="right" valign="top">std::string </td><td class="memItemRight" valign="bottom"><a class="el" href="group__codepage.html#gad7f6c33cf95749ab48174ccafddf7b62">boost::locale::conv::between</a> (std::string const &text, std::string const &to_encoding, std::string const &from_encoding, method_type how=default_method)</td></tr> 133<tr class="separator:gad7f6c33cf95749ab48174ccafddf7b62"><td class="memSeparator" colspan="2"> </td></tr> 134<tr class="memitem:gaf0ad39959911b000706e0538ec059d44"><td class="memTemplParams" colspan="2">template<typename CharOut , typename CharIn > </td></tr> 135<tr class="memitem:gaf0ad39959911b000706e0538ec059d44"><td class="memTemplItemLeft" align="right" valign="top">std::basic_string< CharOut > </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="group__codepage.html#gaf0ad39959911b000706e0538ec059d44">boost::locale::conv::utf_to_utf</a> (CharIn const *begin, CharIn const *end, method_type how=default_method)</td></tr> 136<tr class="separator:gaf0ad39959911b000706e0538ec059d44"><td class="memSeparator" colspan="2"> </td></tr> 137<tr class="memitem:gaa4de44e37cbe5ec4a4b79e1d9bbaf4a7"><td class="memTemplParams" colspan="2">template<typename CharOut , typename CharIn > </td></tr> 138<tr class="memitem:gaa4de44e37cbe5ec4a4b79e1d9bbaf4a7"><td class="memTemplItemLeft" align="right" valign="top">std::basic_string< CharOut > </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="group__codepage.html#gaa4de44e37cbe5ec4a4b79e1d9bbaf4a7">boost::locale::conv::utf_to_utf</a> (CharIn const *str, method_type how=default_method)</td></tr> 139<tr class="separator:gaa4de44e37cbe5ec4a4b79e1d9bbaf4a7"><td class="memSeparator" colspan="2"> </td></tr> 140<tr class="memitem:ga1951228e7f528a20e40258d73cf17f5c"><td class="memTemplParams" colspan="2">template<typename CharOut , typename CharIn > </td></tr> 141<tr class="memitem:ga1951228e7f528a20e40258d73cf17f5c"><td class="memTemplItemLeft" align="right" valign="top">std::basic_string< CharOut > </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="group__codepage.html#ga1951228e7f528a20e40258d73cf17f5c">boost::locale::conv::utf_to_utf</a> (std::basic_string< CharIn > const &str, method_type how=default_method)</td></tr> 142<tr class="separator:ga1951228e7f528a20e40258d73cf17f5c"><td class="memSeparator" colspan="2"> </td></tr> 143</table> 144<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2> 145<h2 class="groupheader">Enumeration Type Documentation</h2> 146<a class="anchor" id="ga8e3c5a274f57107ec5745e227c26ba84"></a> 147<div class="memitem"> 148<div class="memproto"> 149 <table class="memname"> 150 <tr> 151 <td class="memname">enum <a class="el" href="group__codepage.html#ga8e3c5a274f57107ec5745e227c26ba84">boost::locale::conv::method_type</a></td> 152 </tr> 153 </table> 154</div><div class="memdoc"> 155<p>enum that defines conversion policy </p> 156<table class="fieldtable"> 157<tr><th colspan="2">Enumerator</th></tr><tr><td class="fieldname"><em><a class="anchor" id="gga8e3c5a274f57107ec5745e227c26ba84ae9b554a2955deddf714757788819edf9"></a>skip</em> </td><td class="fielddoc"> 158<p>Skip illegal/unconvertable characters. </p> 159</td></tr> 160<tr><td class="fieldname"><em><a class="anchor" id="gga8e3c5a274f57107ec5745e227c26ba84aab08f9ee241c405ef40bd3cedb43b383"></a>stop</em> </td><td class="fielddoc"> 161<p>Stop conversion and throw <a class="el" href="classboost_1_1locale_1_1conv_1_1conversion__error.html" title="The excepton that is thrown in case of conversion error. ">conversion_error</a>. </p> 162</td></tr> 163<tr><td class="fieldname"><em><a class="anchor" id="gga8e3c5a274f57107ec5745e227c26ba84adcdc34a57dd2a3ca917f73c13f18b559"></a>default_method</em> </td><td class="fielddoc"> 164<p>Default method - skip. </p> 165</td></tr> 166</table> 167 168</div> 169</div> 170<h2 class="groupheader">Function Documentation</h2> 171<a class="anchor" id="ga7eda9058b8cbac9b05886bcc894faeff"></a> 172<div class="memitem"> 173<div class="memproto"> 174 <table class="memname"> 175 <tr> 176 <td class="memname">std::string boost::locale::conv::between </td> 177 <td>(</td> 178 <td class="paramtype">char const * </td> 179 <td class="paramname"><em>begin</em>, </td> 180 </tr> 181 <tr> 182 <td class="paramkey"></td> 183 <td></td> 184 <td class="paramtype">char const * </td> 185 <td class="paramname"><em>end</em>, </td> 186 </tr> 187 <tr> 188 <td class="paramkey"></td> 189 <td></td> 190 <td class="paramtype">std::string const & </td> 191 <td class="paramname"><em>to_encoding</em>, </td> 192 </tr> 193 <tr> 194 <td class="paramkey"></td> 195 <td></td> 196 <td class="paramtype">std::string const & </td> 197 <td class="paramname"><em>from_encoding</em>, </td> 198 </tr> 199 <tr> 200 <td class="paramkey"></td> 201 <td></td> 202 <td class="paramtype">method_type </td> 203 <td class="paramname"><em>how</em> = <code>default_method</code> </td> 204 </tr> 205 <tr> 206 <td></td> 207 <td>)</td> 208 <td></td><td></td> 209 </tr> 210 </table> 211</div><div class="memdoc"> 212<p>Convert a text in range [begin,end) to <em>to_encoding</em> from <em>from_encoding</em> </p> 213 214</div> 215</div> 216<a class="anchor" id="ga612607a8616add30cf21ceb086e664d5"></a> 217<div class="memitem"> 218<div class="memproto"> 219<table class="mlabels"> 220 <tr> 221 <td class="mlabels-left"> 222 <table class="memname"> 223 <tr> 224 <td class="memname">std::string boost::locale::conv::between </td> 225 <td>(</td> 226 <td class="paramtype">char const * </td> 227 <td class="paramname"><em>text</em>, </td> 228 </tr> 229 <tr> 230 <td class="paramkey"></td> 231 <td></td> 232 <td class="paramtype">std::string const & </td> 233 <td class="paramname"><em>to_encoding</em>, </td> 234 </tr> 235 <tr> 236 <td class="paramkey"></td> 237 <td></td> 238 <td class="paramtype">std::string const & </td> 239 <td class="paramname"><em>from_encoding</em>, </td> 240 </tr> 241 <tr> 242 <td class="paramkey"></td> 243 <td></td> 244 <td class="paramtype">method_type </td> 245 <td class="paramname"><em>how</em> = <code>default_method</code> </td> 246 </tr> 247 <tr> 248 <td></td> 249 <td>)</td> 250 <td></td><td></td> 251 </tr> 252 </table> 253 </td> 254 <td class="mlabels-right"> 255<span class="mlabels"><span class="mlabel">inline</span></span> </td> 256 </tr> 257</table> 258</div><div class="memdoc"> 259<p>Convert a <em>text</em> to <em>to_encoding</em> from <em>from_encoding</em> </p> 260 261</div> 262</div> 263<a class="anchor" id="gad7f6c33cf95749ab48174ccafddf7b62"></a> 264<div class="memitem"> 265<div class="memproto"> 266<table class="mlabels"> 267 <tr> 268 <td class="mlabels-left"> 269 <table class="memname"> 270 <tr> 271 <td class="memname">std::string boost::locale::conv::between </td> 272 <td>(</td> 273 <td class="paramtype">std::string const & </td> 274 <td class="paramname"><em>text</em>, </td> 275 </tr> 276 <tr> 277 <td class="paramkey"></td> 278 <td></td> 279 <td class="paramtype">std::string const & </td> 280 <td class="paramname"><em>to_encoding</em>, </td> 281 </tr> 282 <tr> 283 <td class="paramkey"></td> 284 <td></td> 285 <td class="paramtype">std::string const & </td> 286 <td class="paramname"><em>from_encoding</em>, </td> 287 </tr> 288 <tr> 289 <td class="paramkey"></td> 290 <td></td> 291 <td class="paramtype">method_type </td> 292 <td class="paramname"><em>how</em> = <code>default_method</code> </td> 293 </tr> 294 <tr> 295 <td></td> 296 <td>)</td> 297 <td></td><td></td> 298 </tr> 299 </table> 300 </td> 301 <td class="mlabels-right"> 302<span class="mlabels"><span class="mlabel">inline</span></span> </td> 303 </tr> 304</table> 305</div><div class="memdoc"> 306<p>Convert a <em>text</em> to <em>to_encoding</em> from <em>from_encoding</em> </p> 307 308</div> 309</div> 310<a class="anchor" id="gaef8fb7771dce60511d081770547a4139"></a> 311<div class="memitem"> 312<div class="memproto"> 313<div class="memtemplate"> 314template<typename CharType > </div> 315 <table class="memname"> 316 <tr> 317 <td class="memname">std::string boost::locale::conv::from_utf </td> 318 <td>(</td> 319 <td class="paramtype">CharType const * </td> 320 <td class="paramname"><em>begin</em>, </td> 321 </tr> 322 <tr> 323 <td class="paramkey"></td> 324 <td></td> 325 <td class="paramtype">CharType const * </td> 326 <td class="paramname"><em>end</em>, </td> 327 </tr> 328 <tr> 329 <td class="paramkey"></td> 330 <td></td> 331 <td class="paramtype">std::string const & </td> 332 <td class="paramname"><em>charset</em>, </td> 333 </tr> 334 <tr> 335 <td class="paramkey"></td> 336 <td></td> 337 <td class="paramtype">method_type </td> 338 <td class="paramname"><em>how</em> = <code>default_method</code> </td> 339 </tr> 340 <tr> 341 <td></td> 342 <td>)</td> 343 <td></td><td></td> 344 </tr> 345 </table> 346</div><div class="memdoc"> 347<p>convert UTF text in range [begin,end) to a text encoded with <em>charset</em> according to policy <em>how</em> </p> 348 349</div> 350</div> 351<a class="anchor" id="ga0eee2960f0d6d15491c5b95dd3054d9a"></a> 352<div class="memitem"> 353<div class="memproto"> 354<div class="memtemplate"> 355template<typename CharType > </div> 356 <table class="memname"> 357 <tr> 358 <td class="memname">std::string boost::locale::conv::from_utf </td> 359 <td>(</td> 360 <td class="paramtype">CharType const * </td> 361 <td class="paramname"><em>begin</em>, </td> 362 </tr> 363 <tr> 364 <td class="paramkey"></td> 365 <td></td> 366 <td class="paramtype">CharType const * </td> 367 <td class="paramname"><em>end</em>, </td> 368 </tr> 369 <tr> 370 <td class="paramkey"></td> 371 <td></td> 372 <td class="paramtype">std::locale const & </td> 373 <td class="paramname"><em>loc</em>, </td> 374 </tr> 375 <tr> 376 <td class="paramkey"></td> 377 <td></td> 378 <td class="paramtype">method_type </td> 379 <td class="paramname"><em>how</em> = <code>default_method</code> </td> 380 </tr> 381 <tr> 382 <td></td> 383 <td>)</td> 384 <td></td><td></td> 385 </tr> 386 </table> 387</div><div class="memdoc"> 388<p>convert UTF text in range [begin,end) to a text encoded according to locale <em>loc</em> according to policy <em>how</em> </p> 389<dl class="section note"><dt>Note</dt><dd>throws std::bad_cast if the loc does not have <a class="el" href="classboost_1_1locale_1_1info.html">info</a> facet installed </dd></dl> 390 391</div> 392</div> 393<a class="anchor" id="ga17c2c9d8659281848db73822fcc38092"></a> 394<div class="memitem"> 395<div class="memproto"> 396<div class="memtemplate"> 397template<typename CharType > </div> 398 <table class="memname"> 399 <tr> 400 <td class="memname">std::string boost::locale::conv::from_utf </td> 401 <td>(</td> 402 <td class="paramtype">std::basic_string< CharType > const & </td> 403 <td class="paramname"><em>text</em>, </td> 404 </tr> 405 <tr> 406 <td class="paramkey"></td> 407 <td></td> 408 <td class="paramtype">std::string const & </td> 409 <td class="paramname"><em>charset</em>, </td> 410 </tr> 411 <tr> 412 <td class="paramkey"></td> 413 <td></td> 414 <td class="paramtype">method_type </td> 415 <td class="paramname"><em>how</em> = <code>default_method</code> </td> 416 </tr> 417 <tr> 418 <td></td> 419 <td>)</td> 420 <td></td><td></td> 421 </tr> 422 </table> 423</div><div class="memdoc"> 424<p>Convert a <em>text</em> from <em>charset</em> to UTF string </p> 425 426</div> 427</div> 428<a class="anchor" id="gab784637ee28adb9538b8002dadf0b273"></a> 429<div class="memitem"> 430<div class="memproto"> 431<div class="memtemplate"> 432template<typename CharType > </div> 433 <table class="memname"> 434 <tr> 435 <td class="memname">std::string boost::locale::conv::from_utf </td> 436 <td>(</td> 437 <td class="paramtype">CharType const * </td> 438 <td class="paramname"><em>text</em>, </td> 439 </tr> 440 <tr> 441 <td class="paramkey"></td> 442 <td></td> 443 <td class="paramtype">std::string const & </td> 444 <td class="paramname"><em>charset</em>, </td> 445 </tr> 446 <tr> 447 <td class="paramkey"></td> 448 <td></td> 449 <td class="paramtype">method_type </td> 450 <td class="paramname"><em>how</em> = <code>default_method</code> </td> 451 </tr> 452 <tr> 453 <td></td> 454 <td>)</td> 455 <td></td><td></td> 456 </tr> 457 </table> 458</div><div class="memdoc"> 459<p>Convert a <em>text</em> from UTF to <em>charset</em> </p> 460 461</div> 462</div> 463<a class="anchor" id="ga85cc81b352a88e12191926b95eb39aeb"></a> 464<div class="memitem"> 465<div class="memproto"> 466<div class="memtemplate"> 467template<typename CharType > </div> 468 <table class="memname"> 469 <tr> 470 <td class="memname">std::string boost::locale::conv::from_utf </td> 471 <td>(</td> 472 <td class="paramtype">std::basic_string< CharType > const & </td> 473 <td class="paramname"><em>text</em>, </td> 474 </tr> 475 <tr> 476 <td class="paramkey"></td> 477 <td></td> 478 <td class="paramtype">std::locale const & </td> 479 <td class="paramname"><em>loc</em>, </td> 480 </tr> 481 <tr> 482 <td class="paramkey"></td> 483 <td></td> 484 <td class="paramtype">method_type </td> 485 <td class="paramname"><em>how</em> = <code>default_method</code> </td> 486 </tr> 487 <tr> 488 <td></td> 489 <td>)</td> 490 <td></td><td></td> 491 </tr> 492 </table> 493</div><div class="memdoc"> 494<p>Convert a <em>text</em> in UTF to locale encoding given by <em>loc</em> </p> 495<dl class="section note"><dt>Note</dt><dd>throws std::bad_cast if the loc does not have <a class="el" href="classboost_1_1locale_1_1info.html">info</a> facet installed </dd></dl> 496 497</div> 498</div> 499<a class="anchor" id="ga2a41ad85803d97f7e1906d5c0561eefa"></a> 500<div class="memitem"> 501<div class="memproto"> 502<div class="memtemplate"> 503template<typename CharType > </div> 504 <table class="memname"> 505 <tr> 506 <td class="memname">std::string boost::locale::conv::from_utf </td> 507 <td>(</td> 508 <td class="paramtype">CharType const * </td> 509 <td class="paramname"><em>text</em>, </td> 510 </tr> 511 <tr> 512 <td class="paramkey"></td> 513 <td></td> 514 <td class="paramtype">std::locale const & </td> 515 <td class="paramname"><em>loc</em>, </td> 516 </tr> 517 <tr> 518 <td class="paramkey"></td> 519 <td></td> 520 <td class="paramtype">method_type </td> 521 <td class="paramname"><em>how</em> = <code>default_method</code> </td> 522 </tr> 523 <tr> 524 <td></td> 525 <td>)</td> 526 <td></td><td></td> 527 </tr> 528 </table> 529</div><div class="memdoc"> 530<p>Convert a <em>text</em> in UTF to locale encoding given by <em>loc</em> </p> 531<dl class="section note"><dt>Note</dt><dd>throws std::bad_cast if the loc does not have <a class="el" href="classboost_1_1locale_1_1info.html">info</a> facet installed </dd></dl> 532 533</div> 534</div> 535<a class="anchor" id="ga2ca59a735ca28c9d5103e37ef2373ca1"></a> 536<div class="memitem"> 537<div class="memproto"> 538<div class="memtemplate"> 539template<typename CharType > </div> 540 <table class="memname"> 541 <tr> 542 <td class="memname">std::basic_string<CharType> boost::locale::conv::to_utf </td> 543 <td>(</td> 544 <td class="paramtype">char const * </td> 545 <td class="paramname"><em>begin</em>, </td> 546 </tr> 547 <tr> 548 <td class="paramkey"></td> 549 <td></td> 550 <td class="paramtype">char const * </td> 551 <td class="paramname"><em>end</em>, </td> 552 </tr> 553 <tr> 554 <td class="paramkey"></td> 555 <td></td> 556 <td class="paramtype">std::string const & </td> 557 <td class="paramname"><em>charset</em>, </td> 558 </tr> 559 <tr> 560 <td class="paramkey"></td> 561 <td></td> 562 <td class="paramtype">method_type </td> 563 <td class="paramname"><em>how</em> = <code>default_method</code> </td> 564 </tr> 565 <tr> 566 <td></td> 567 <td>)</td> 568 <td></td><td></td> 569 </tr> 570 </table> 571</div><div class="memdoc"> 572<p>convert string to UTF string from text in range [begin,end) encoded with <em>charset</em> according to policy <em>how</em> </p> 573 574</div> 575</div> 576<a class="anchor" id="ga5ae3d72f015dc847ddfd688a0a40ff66"></a> 577<div class="memitem"> 578<div class="memproto"> 579<div class="memtemplate"> 580template<typename CharType > </div> 581 <table class="memname"> 582 <tr> 583 <td class="memname">std::basic_string<CharType> boost::locale::conv::to_utf </td> 584 <td>(</td> 585 <td class="paramtype">char const * </td> 586 <td class="paramname"><em>begin</em>, </td> 587 </tr> 588 <tr> 589 <td class="paramkey"></td> 590 <td></td> 591 <td class="paramtype">char const * </td> 592 <td class="paramname"><em>end</em>, </td> 593 </tr> 594 <tr> 595 <td class="paramkey"></td> 596 <td></td> 597 <td class="paramtype">std::locale const & </td> 598 <td class="paramname"><em>loc</em>, </td> 599 </tr> 600 <tr> 601 <td class="paramkey"></td> 602 <td></td> 603 <td class="paramtype">method_type </td> 604 <td class="paramname"><em>how</em> = <code>default_method</code> </td> 605 </tr> 606 <tr> 607 <td></td> 608 <td>)</td> 609 <td></td><td></td> 610 </tr> 611 </table> 612</div><div class="memdoc"> 613<p>convert string to UTF string from text in range [begin,end) encoded according to locale <em>loc</em> according to policy <em>how</em> </p> 614<dl class="section note"><dt>Note</dt><dd>throws std::bad_cast if the loc does not have <a class="el" href="classboost_1_1locale_1_1info.html">info</a> facet installed </dd></dl> 615 616</div> 617</div> 618<a class="anchor" id="ga25227e4e43f6c695dac13844a94741ea"></a> 619<div class="memitem"> 620<div class="memproto"> 621<div class="memtemplate"> 622template<typename CharType > </div> 623 <table class="memname"> 624 <tr> 625 <td class="memname">std::basic_string<CharType> boost::locale::conv::to_utf </td> 626 <td>(</td> 627 <td class="paramtype">std::string const & </td> 628 <td class="paramname"><em>text</em>, </td> 629 </tr> 630 <tr> 631 <td class="paramkey"></td> 632 <td></td> 633 <td class="paramtype">std::string const & </td> 634 <td class="paramname"><em>charset</em>, </td> 635 </tr> 636 <tr> 637 <td class="paramkey"></td> 638 <td></td> 639 <td class="paramtype">method_type </td> 640 <td class="paramname"><em>how</em> = <code>default_method</code> </td> 641 </tr> 642 <tr> 643 <td></td> 644 <td>)</td> 645 <td></td><td></td> 646 </tr> 647 </table> 648</div><div class="memdoc"> 649<p>convert a string <em>text</em> encoded with <em>charset</em> to UTF string </p> 650 651</div> 652</div> 653<a class="anchor" id="ga2be733c3e2028aa43e4b35100bdb1322"></a> 654<div class="memitem"> 655<div class="memproto"> 656<div class="memtemplate"> 657template<typename CharType > </div> 658 <table class="memname"> 659 <tr> 660 <td class="memname">std::basic_string<CharType> boost::locale::conv::to_utf </td> 661 <td>(</td> 662 <td class="paramtype">char const * </td> 663 <td class="paramname"><em>text</em>, </td> 664 </tr> 665 <tr> 666 <td class="paramkey"></td> 667 <td></td> 668 <td class="paramtype">std::string const & </td> 669 <td class="paramname"><em>charset</em>, </td> 670 </tr> 671 <tr> 672 <td class="paramkey"></td> 673 <td></td> 674 <td class="paramtype">method_type </td> 675 <td class="paramname"><em>how</em> = <code>default_method</code> </td> 676 </tr> 677 <tr> 678 <td></td> 679 <td>)</td> 680 <td></td><td></td> 681 </tr> 682 </table> 683</div><div class="memdoc"> 684<p>Convert a <em>text</em> from <em>charset</em> to UTF string </p> 685 686</div> 687</div> 688<a class="anchor" id="ga4c22a2bcb97338274752f95e2d265442"></a> 689<div class="memitem"> 690<div class="memproto"> 691<div class="memtemplate"> 692template<typename CharType > </div> 693 <table class="memname"> 694 <tr> 695 <td class="memname">std::basic_string<CharType> boost::locale::conv::to_utf </td> 696 <td>(</td> 697 <td class="paramtype">std::string const & </td> 698 <td class="paramname"><em>text</em>, </td> 699 </tr> 700 <tr> 701 <td class="paramkey"></td> 702 <td></td> 703 <td class="paramtype">std::locale const & </td> 704 <td class="paramname"><em>loc</em>, </td> 705 </tr> 706 <tr> 707 <td class="paramkey"></td> 708 <td></td> 709 <td class="paramtype">method_type </td> 710 <td class="paramname"><em>how</em> = <code>default_method</code> </td> 711 </tr> 712 <tr> 713 <td></td> 714 <td>)</td> 715 <td></td><td></td> 716 </tr> 717 </table> 718</div><div class="memdoc"> 719<p>Convert a <em>text</em> in locale encoding given by <em>loc</em> to UTF</p> 720<dl class="section note"><dt>Note</dt><dd>throws std::bad_cast if the loc does not have <a class="el" href="classboost_1_1locale_1_1info.html">info</a> facet installed </dd></dl> 721 722</div> 723</div> 724<a class="anchor" id="gac298fcddef144915332f031f4565feb0"></a> 725<div class="memitem"> 726<div class="memproto"> 727<div class="memtemplate"> 728template<typename CharType > </div> 729 <table class="memname"> 730 <tr> 731 <td class="memname">std::basic_string<CharType> boost::locale::conv::to_utf </td> 732 <td>(</td> 733 <td class="paramtype">char const * </td> 734 <td class="paramname"><em>text</em>, </td> 735 </tr> 736 <tr> 737 <td class="paramkey"></td> 738 <td></td> 739 <td class="paramtype">std::locale const & </td> 740 <td class="paramname"><em>loc</em>, </td> 741 </tr> 742 <tr> 743 <td class="paramkey"></td> 744 <td></td> 745 <td class="paramtype">method_type </td> 746 <td class="paramname"><em>how</em> = <code>default_method</code> </td> 747 </tr> 748 <tr> 749 <td></td> 750 <td>)</td> 751 <td></td><td></td> 752 </tr> 753 </table> 754</div><div class="memdoc"> 755<p>Convert a <em>text</em> in locale encoding given by <em>loc</em> to UTF</p> 756<dl class="section note"><dt>Note</dt><dd>throws std::bad_cast if the loc does not have <a class="el" href="classboost_1_1locale_1_1info.html">info</a> facet installed </dd></dl> 757 758</div> 759</div> 760<a class="anchor" id="gaf0ad39959911b000706e0538ec059d44"></a> 761<div class="memitem"> 762<div class="memproto"> 763<div class="memtemplate"> 764template<typename CharOut , typename CharIn > </div> 765 <table class="memname"> 766 <tr> 767 <td class="memname">std::basic_string<CharOut> boost::locale::conv::utf_to_utf </td> 768 <td>(</td> 769 <td class="paramtype">CharIn const * </td> 770 <td class="paramname"><em>begin</em>, </td> 771 </tr> 772 <tr> 773 <td class="paramkey"></td> 774 <td></td> 775 <td class="paramtype">CharIn const * </td> 776 <td class="paramname"><em>end</em>, </td> 777 </tr> 778 <tr> 779 <td class="paramkey"></td> 780 <td></td> 781 <td class="paramtype">method_type </td> 782 <td class="paramname"><em>how</em> = <code>default_method</code> </td> 783 </tr> 784 <tr> 785 <td></td> 786 <td>)</td> 787 <td></td><td></td> 788 </tr> 789 </table> 790</div><div class="memdoc"> 791<p>Convert a Unicode text in range [begin,end) to other Unicode encoding </p> 792 793</div> 794</div> 795<a class="anchor" id="gaa4de44e37cbe5ec4a4b79e1d9bbaf4a7"></a> 796<div class="memitem"> 797<div class="memproto"> 798<div class="memtemplate"> 799template<typename CharOut , typename CharIn > </div> 800 <table class="memname"> 801 <tr> 802 <td class="memname">std::basic_string<CharOut> boost::locale::conv::utf_to_utf </td> 803 <td>(</td> 804 <td class="paramtype">CharIn const * </td> 805 <td class="paramname"><em>str</em>, </td> 806 </tr> 807 <tr> 808 <td class="paramkey"></td> 809 <td></td> 810 <td class="paramtype">method_type </td> 811 <td class="paramname"><em>how</em> = <code>default_method</code> </td> 812 </tr> 813 <tr> 814 <td></td> 815 <td>)</td> 816 <td></td><td></td> 817 </tr> 818 </table> 819</div><div class="memdoc"> 820<p>Convert a Unicode NUL terminated string <em>str</em> other Unicode encoding </p> 821 822</div> 823</div> 824<a class="anchor" id="ga1951228e7f528a20e40258d73cf17f5c"></a> 825<div class="memitem"> 826<div class="memproto"> 827<div class="memtemplate"> 828template<typename CharOut , typename CharIn > </div> 829 <table class="memname"> 830 <tr> 831 <td class="memname">std::basic_string<CharOut> boost::locale::conv::utf_to_utf </td> 832 <td>(</td> 833 <td class="paramtype">std::basic_string< CharIn > const & </td> 834 <td class="paramname"><em>str</em>, </td> 835 </tr> 836 <tr> 837 <td class="paramkey"></td> 838 <td></td> 839 <td class="paramtype">method_type </td> 840 <td class="paramname"><em>how</em> = <code>default_method</code> </td> 841 </tr> 842 <tr> 843 <td></td> 844 <td>)</td> 845 <td></td><td></td> 846 </tr> 847 </table> 848</div><div class="memdoc"> 849<p>Convert a Unicode string <em>str</em> other Unicode encoding </p> 850 851</div> 852</div> 853</div><!-- contents --> 854</div><!-- doc-content --> 855 856 <li class="footer"> 857© 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. 858 </li> 859 </ul> 860 </div> 861</body> 862</html> 863