group__convert.html 37 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691
  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: Text Conversions</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&#160;Page</span></a></li>
  40. <li><a href="pages.html"><span>Related&#160;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__convert.html','');});
  61. </script>
  62. <div id="doc-content">
  63. <div class="header">
  64. <div class="summary">
  65. <a href="#nested-classes">Classes</a> &#124;
  66. <a href="#enum-members">Enumerations</a> &#124;
  67. <a href="#func-members">Functions</a> </div>
  68. <div class="headertitle">
  69. <div class="title">Text Conversions</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>
  74. Classes</h2></td></tr>
  75. <tr class="memitem:"><td class="memItemLeft" align="right" valign="top">class &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classboost_1_1locale_1_1converter__base.html">boost::locale::converter_base</a></td></tr>
  76. <tr class="memdesc:"><td class="mdescLeft">&#160;</td><td class="mdescRight">This class provides base flags for text manipulation. It is used as base for converter facet. <a href="classboost_1_1locale_1_1converter__base.html#details">More...</a><br/></td></tr>
  77. <tr class="separator:"><td class="memSeparator" colspan="2">&#160;</td></tr>
  78. <tr class="memitem:"><td class="memItemLeft" align="right" valign="top">class &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classboost_1_1locale_1_1converter.html">boost::locale::converter&lt; CharType &gt;</a></td></tr>
  79. <tr class="memdesc:"><td class="mdescLeft">&#160;</td><td class="mdescRight">The facet that implements text manipulation. <a href="classboost_1_1locale_1_1converter.html#details">More...</a><br/></td></tr>
  80. <tr class="separator:"><td class="memSeparator" colspan="2">&#160;</td></tr>
  81. </table><table class="memberdecls">
  82. <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="enum-members"></a>
  83. Enumerations</h2></td></tr>
  84. <tr class="memitem:ga6a595a415b83b8a0c8f14c34eb66cc9f"><td class="memItemLeft" align="right" valign="top">enum &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__convert.html#ga6a595a415b83b8a0c8f14c34eb66cc9f">boost::locale::norm_type</a> { <br/>
  85. &#160;&#160;<a class="el" href="group__convert.html#gga6a595a415b83b8a0c8f14c34eb66cc9fa6648d0eabb931f2e9d258570b297e98f">boost::locale::norm_nfd</a>,
  86. <a class="el" href="group__convert.html#gga6a595a415b83b8a0c8f14c34eb66cc9faf6fe7be275e5e13df415ab258105ada0">boost::locale::norm_nfc</a>,
  87. <a class="el" href="group__convert.html#gga6a595a415b83b8a0c8f14c34eb66cc9fa0fbc2ac042fc6f58af5818bfd06d5379">boost::locale::norm_nfkd</a>,
  88. <a class="el" href="group__convert.html#gga6a595a415b83b8a0c8f14c34eb66cc9fa0305c1f3405ea70facf4c6a5ffa40583">boost::locale::norm_nfkc</a>,
  89. <br/>
  90. &#160;&#160;<a class="el" href="group__convert.html#gga6a595a415b83b8a0c8f14c34eb66cc9faa29173d73d9be7fefcbb18c8712465d2">boost::locale::norm_default</a> = norm_nfc
  91. <br/>
  92. }</td></tr>
  93. <tr class="separator:ga6a595a415b83b8a0c8f14c34eb66cc9f"><td class="memSeparator" colspan="2">&#160;</td></tr>
  94. </table><table class="memberdecls">
  95. <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="func-members"></a>
  96. Functions</h2></td></tr>
  97. <tr class="memitem:ga867733c9d4455aaa13a42cf67367d575"><td class="memTemplParams" colspan="2">template&lt;typename CharType &gt; </td></tr>
  98. <tr class="memitem:ga867733c9d4455aaa13a42cf67367d575"><td class="memTemplItemLeft" align="right" valign="top">std::basic_string&lt; CharType &gt;&#160;</td><td class="memTemplItemRight" valign="bottom"><a class="el" href="group__convert.html#ga867733c9d4455aaa13a42cf67367d575">boost::locale::normalize</a> (std::basic_string&lt; CharType &gt; const &amp;str, norm_type n=norm_default, std::locale const &amp;loc=std::locale())</td></tr>
  99. <tr class="separator:ga867733c9d4455aaa13a42cf67367d575"><td class="memSeparator" colspan="2">&#160;</td></tr>
  100. <tr class="memitem:gaa2e01f28fa12ea71a6318f8277f2745e"><td class="memTemplParams" colspan="2">template&lt;typename CharType &gt; </td></tr>
  101. <tr class="memitem:gaa2e01f28fa12ea71a6318f8277f2745e"><td class="memTemplItemLeft" align="right" valign="top">std::basic_string&lt; CharType &gt;&#160;</td><td class="memTemplItemRight" valign="bottom"><a class="el" href="group__convert.html#gaa2e01f28fa12ea71a6318f8277f2745e">boost::locale::normalize</a> (CharType const *str, norm_type n=norm_default, std::locale const &amp;loc=std::locale())</td></tr>
  102. <tr class="separator:gaa2e01f28fa12ea71a6318f8277f2745e"><td class="memSeparator" colspan="2">&#160;</td></tr>
  103. <tr class="memitem:ga03ee131e44c37c2191d15683cc281e5f"><td class="memTemplParams" colspan="2">template&lt;typename CharType &gt; </td></tr>
  104. <tr class="memitem:ga03ee131e44c37c2191d15683cc281e5f"><td class="memTemplItemLeft" align="right" valign="top">std::basic_string&lt; CharType &gt;&#160;</td><td class="memTemplItemRight" valign="bottom"><a class="el" href="group__convert.html#ga03ee131e44c37c2191d15683cc281e5f">boost::locale::normalize</a> (CharType const *begin, CharType const *end, norm_type n=norm_default, std::locale const &amp;loc=std::locale())</td></tr>
  105. <tr class="separator:ga03ee131e44c37c2191d15683cc281e5f"><td class="memSeparator" colspan="2">&#160;</td></tr>
  106. <tr class="memitem:ga2ceae621801e8cf4f77c60d1e3047ae8"><td class="memTemplParams" colspan="2">template&lt;typename CharType &gt; </td></tr>
  107. <tr class="memitem:ga2ceae621801e8cf4f77c60d1e3047ae8"><td class="memTemplItemLeft" align="right" valign="top">std::basic_string&lt; CharType &gt;&#160;</td><td class="memTemplItemRight" valign="bottom"><a class="el" href="group__convert.html#ga2ceae621801e8cf4f77c60d1e3047ae8">boost::locale::to_upper</a> (std::basic_string&lt; CharType &gt; const &amp;str, std::locale const &amp;loc=std::locale())</td></tr>
  108. <tr class="separator:ga2ceae621801e8cf4f77c60d1e3047ae8"><td class="memSeparator" colspan="2">&#160;</td></tr>
  109. <tr class="memitem:ga2197dbd88d8b42a5e6b2b76fb67ed07d"><td class="memTemplParams" colspan="2">template&lt;typename CharType &gt; </td></tr>
  110. <tr class="memitem:ga2197dbd88d8b42a5e6b2b76fb67ed07d"><td class="memTemplItemLeft" align="right" valign="top">std::basic_string&lt; CharType &gt;&#160;</td><td class="memTemplItemRight" valign="bottom"><a class="el" href="group__convert.html#ga2197dbd88d8b42a5e6b2b76fb67ed07d">boost::locale::to_upper</a> (CharType const *str, std::locale const &amp;loc=std::locale())</td></tr>
  111. <tr class="separator:ga2197dbd88d8b42a5e6b2b76fb67ed07d"><td class="memSeparator" colspan="2">&#160;</td></tr>
  112. <tr class="memitem:ga55257608f61f0bde86f7306b477c993a"><td class="memTemplParams" colspan="2">template&lt;typename CharType &gt; </td></tr>
  113. <tr class="memitem:ga55257608f61f0bde86f7306b477c993a"><td class="memTemplItemLeft" align="right" valign="top">std::basic_string&lt; CharType &gt;&#160;</td><td class="memTemplItemRight" valign="bottom"><a class="el" href="group__convert.html#ga55257608f61f0bde86f7306b477c993a">boost::locale::to_upper</a> (CharType const *begin, CharType const *end, std::locale const &amp;loc=std::locale())</td></tr>
  114. <tr class="separator:ga55257608f61f0bde86f7306b477c993a"><td class="memSeparator" colspan="2">&#160;</td></tr>
  115. <tr class="memitem:ga4a3eb15f42f5cbae7bdd00c9e9cac222"><td class="memTemplParams" colspan="2">template&lt;typename CharType &gt; </td></tr>
  116. <tr class="memitem:ga4a3eb15f42f5cbae7bdd00c9e9cac222"><td class="memTemplItemLeft" align="right" valign="top">std::basic_string&lt; CharType &gt;&#160;</td><td class="memTemplItemRight" valign="bottom"><a class="el" href="group__convert.html#ga4a3eb15f42f5cbae7bdd00c9e9cac222">boost::locale::to_lower</a> (std::basic_string&lt; CharType &gt; const &amp;str, std::locale const &amp;loc=std::locale())</td></tr>
  117. <tr class="separator:ga4a3eb15f42f5cbae7bdd00c9e9cac222"><td class="memSeparator" colspan="2">&#160;</td></tr>
  118. <tr class="memitem:gaa7854d1e3ce4c854f4e1fa18703ffed2"><td class="memTemplParams" colspan="2">template&lt;typename CharType &gt; </td></tr>
  119. <tr class="memitem:gaa7854d1e3ce4c854f4e1fa18703ffed2"><td class="memTemplItemLeft" align="right" valign="top">std::basic_string&lt; CharType &gt;&#160;</td><td class="memTemplItemRight" valign="bottom"><a class="el" href="group__convert.html#gaa7854d1e3ce4c854f4e1fa18703ffed2">boost::locale::to_lower</a> (CharType const *str, std::locale const &amp;loc=std::locale())</td></tr>
  120. <tr class="separator:gaa7854d1e3ce4c854f4e1fa18703ffed2"><td class="memSeparator" colspan="2">&#160;</td></tr>
  121. <tr class="memitem:ga4763a6d37777254390658d1e050262a5"><td class="memTemplParams" colspan="2">template&lt;typename CharType &gt; </td></tr>
  122. <tr class="memitem:ga4763a6d37777254390658d1e050262a5"><td class="memTemplItemLeft" align="right" valign="top">std::basic_string&lt; CharType &gt;&#160;</td><td class="memTemplItemRight" valign="bottom"><a class="el" href="group__convert.html#ga4763a6d37777254390658d1e050262a5">boost::locale::to_lower</a> (CharType const *begin, CharType const *end, std::locale const &amp;loc=std::locale())</td></tr>
  123. <tr class="separator:ga4763a6d37777254390658d1e050262a5"><td class="memSeparator" colspan="2">&#160;</td></tr>
  124. <tr class="memitem:ga684efb375e060c71cd3e1799a6329f7f"><td class="memTemplParams" colspan="2">template&lt;typename CharType &gt; </td></tr>
  125. <tr class="memitem:ga684efb375e060c71cd3e1799a6329f7f"><td class="memTemplItemLeft" align="right" valign="top">std::basic_string&lt; CharType &gt;&#160;</td><td class="memTemplItemRight" valign="bottom"><a class="el" href="group__convert.html#ga684efb375e060c71cd3e1799a6329f7f">boost::locale::to_title</a> (std::basic_string&lt; CharType &gt; const &amp;str, std::locale const &amp;loc=std::locale())</td></tr>
  126. <tr class="separator:ga684efb375e060c71cd3e1799a6329f7f"><td class="memSeparator" colspan="2">&#160;</td></tr>
  127. <tr class="memitem:ga16e9258de2d6009546fb0fb07afd67b7"><td class="memTemplParams" colspan="2">template&lt;typename CharType &gt; </td></tr>
  128. <tr class="memitem:ga16e9258de2d6009546fb0fb07afd67b7"><td class="memTemplItemLeft" align="right" valign="top">std::basic_string&lt; CharType &gt;&#160;</td><td class="memTemplItemRight" valign="bottom"><a class="el" href="group__convert.html#ga16e9258de2d6009546fb0fb07afd67b7">boost::locale::to_title</a> (CharType const *str, std::locale const &amp;loc=std::locale())</td></tr>
  129. <tr class="separator:ga16e9258de2d6009546fb0fb07afd67b7"><td class="memSeparator" colspan="2">&#160;</td></tr>
  130. <tr class="memitem:gab2ff15b36c6f177737c7ae737eb70794"><td class="memTemplParams" colspan="2">template&lt;typename CharType &gt; </td></tr>
  131. <tr class="memitem:gab2ff15b36c6f177737c7ae737eb70794"><td class="memTemplItemLeft" align="right" valign="top">std::basic_string&lt; CharType &gt;&#160;</td><td class="memTemplItemRight" valign="bottom"><a class="el" href="group__convert.html#gab2ff15b36c6f177737c7ae737eb70794">boost::locale::to_title</a> (CharType const *begin, CharType const *end, std::locale const &amp;loc=std::locale())</td></tr>
  132. <tr class="separator:gab2ff15b36c6f177737c7ae737eb70794"><td class="memSeparator" colspan="2">&#160;</td></tr>
  133. <tr class="memitem:gadf59d16355babd955766deef89d470ea"><td class="memTemplParams" colspan="2">template&lt;typename CharType &gt; </td></tr>
  134. <tr class="memitem:gadf59d16355babd955766deef89d470ea"><td class="memTemplItemLeft" align="right" valign="top">std::basic_string&lt; CharType &gt;&#160;</td><td class="memTemplItemRight" valign="bottom"><a class="el" href="group__convert.html#gadf59d16355babd955766deef89d470ea">boost::locale::fold_case</a> (std::basic_string&lt; CharType &gt; const &amp;str, std::locale const &amp;loc=std::locale())</td></tr>
  135. <tr class="separator:gadf59d16355babd955766deef89d470ea"><td class="memSeparator" colspan="2">&#160;</td></tr>
  136. <tr class="memitem:ga297f148881cbfce1edd747a22e451ee6"><td class="memTemplParams" colspan="2">template&lt;typename CharType &gt; </td></tr>
  137. <tr class="memitem:ga297f148881cbfce1edd747a22e451ee6"><td class="memTemplItemLeft" align="right" valign="top">std::basic_string&lt; CharType &gt;&#160;</td><td class="memTemplItemRight" valign="bottom"><a class="el" href="group__convert.html#ga297f148881cbfce1edd747a22e451ee6">boost::locale::fold_case</a> (CharType const *str, std::locale const &amp;loc=std::locale())</td></tr>
  138. <tr class="separator:ga297f148881cbfce1edd747a22e451ee6"><td class="memSeparator" colspan="2">&#160;</td></tr>
  139. <tr class="memitem:gabcb2a619f203306eee30b03061a5cbee"><td class="memTemplParams" colspan="2">template&lt;typename CharType &gt; </td></tr>
  140. <tr class="memitem:gabcb2a619f203306eee30b03061a5cbee"><td class="memTemplItemLeft" align="right" valign="top">std::basic_string&lt; CharType &gt;&#160;</td><td class="memTemplItemRight" valign="bottom"><a class="el" href="group__convert.html#gabcb2a619f203306eee30b03061a5cbee">boost::locale::fold_case</a> (CharType const *begin, CharType const *end, std::locale const &amp;loc=std::locale())</td></tr>
  141. <tr class="separator:gabcb2a619f203306eee30b03061a5cbee"><td class="memSeparator" colspan="2">&#160;</td></tr>
  142. </table>
  143. <a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
  144. <p>This module provides various function for string manipulation like Unicode normalization, case conversion etc. </p>
  145. <h2 class="groupheader">Enumeration Type Documentation</h2>
  146. <a class="anchor" id="ga6a595a415b83b8a0c8f14c34eb66cc9f"></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__convert.html#ga6a595a415b83b8a0c8f14c34eb66cc9f">boost::locale::norm_type</a></td>
  152. </tr>
  153. </table>
  154. </div><div class="memdoc">
  155. <p>The type that defined <a href="http://unicode.org/reports/tr15/#Norm_Forms">normalization form</a> </p>
  156. <table class="fieldtable">
  157. <tr><th colspan="2">Enumerator</th></tr><tr><td class="fieldname"><em><a class="anchor" id="gga6a595a415b83b8a0c8f14c34eb66cc9fa6648d0eabb931f2e9d258570b297e98f"></a>norm_nfd</em>&#160;</td><td class="fielddoc">
  158. <p>Canonical decomposition. </p>
  159. </td></tr>
  160. <tr><td class="fieldname"><em><a class="anchor" id="gga6a595a415b83b8a0c8f14c34eb66cc9faf6fe7be275e5e13df415ab258105ada0"></a>norm_nfc</em>&#160;</td><td class="fielddoc">
  161. <p>Canonical decomposition followed by canonical composition. </p>
  162. </td></tr>
  163. <tr><td class="fieldname"><em><a class="anchor" id="gga6a595a415b83b8a0c8f14c34eb66cc9fa0fbc2ac042fc6f58af5818bfd06d5379"></a>norm_nfkd</em>&#160;</td><td class="fielddoc">
  164. <p>Compatibility decomposition. </p>
  165. </td></tr>
  166. <tr><td class="fieldname"><em><a class="anchor" id="gga6a595a415b83b8a0c8f14c34eb66cc9fa0305c1f3405ea70facf4c6a5ffa40583"></a>norm_nfkc</em>&#160;</td><td class="fielddoc">
  167. <p>Compatibility decomposition followed by canonical composition. </p>
  168. </td></tr>
  169. <tr><td class="fieldname"><em><a class="anchor" id="gga6a595a415b83b8a0c8f14c34eb66cc9faa29173d73d9be7fefcbb18c8712465d2"></a>norm_default</em>&#160;</td><td class="fielddoc">
  170. <p>Default normalization - canonical decomposition followed by canonical composition. </p>
  171. </td></tr>
  172. </table>
  173. </div>
  174. </div>
  175. <h2 class="groupheader">Function Documentation</h2>
  176. <a class="anchor" id="gadf59d16355babd955766deef89d470ea"></a>
  177. <div class="memitem">
  178. <div class="memproto">
  179. <div class="memtemplate">
  180. template&lt;typename CharType &gt; </div>
  181. <table class="memname">
  182. <tr>
  183. <td class="memname">std::basic_string&lt;CharType&gt; boost::locale::fold_case </td>
  184. <td>(</td>
  185. <td class="paramtype">std::basic_string&lt; CharType &gt; const &amp;&#160;</td>
  186. <td class="paramname"><em>str</em>, </td>
  187. </tr>
  188. <tr>
  189. <td class="paramkey"></td>
  190. <td></td>
  191. <td class="paramtype">std::locale const &amp;&#160;</td>
  192. <td class="paramname"><em>loc</em> = <code>std::locale()</code>&#160;</td>
  193. </tr>
  194. <tr>
  195. <td></td>
  196. <td>)</td>
  197. <td></td><td></td>
  198. </tr>
  199. </table>
  200. </div><div class="memdoc">
  201. <p>Fold case of a string <em>str</em> according to locale <em>loc</em> </p>
  202. <dl class="section note"><dt>Note</dt><dd>throws std::bad_cast if loc does not have <a class="el" href="classboost_1_1locale_1_1converter.html">converter</a> facet installed </dd></dl>
  203. <dl><dt><b>Examples: </b></dt><dd><a class="el" href="hello_8cpp-example.html#a9">hello.cpp</a>, and <a class="el" href="whello_8cpp-example.html#a9">whello.cpp</a>.</dd>
  204. </dl>
  205. </div>
  206. </div>
  207. <a class="anchor" id="ga297f148881cbfce1edd747a22e451ee6"></a>
  208. <div class="memitem">
  209. <div class="memproto">
  210. <div class="memtemplate">
  211. template&lt;typename CharType &gt; </div>
  212. <table class="memname">
  213. <tr>
  214. <td class="memname">std::basic_string&lt;CharType&gt; boost::locale::fold_case </td>
  215. <td>(</td>
  216. <td class="paramtype">CharType const *&#160;</td>
  217. <td class="paramname"><em>str</em>, </td>
  218. </tr>
  219. <tr>
  220. <td class="paramkey"></td>
  221. <td></td>
  222. <td class="paramtype">std::locale const &amp;&#160;</td>
  223. <td class="paramname"><em>loc</em> = <code>std::locale()</code>&#160;</td>
  224. </tr>
  225. <tr>
  226. <td></td>
  227. <td>)</td>
  228. <td></td><td></td>
  229. </tr>
  230. </table>
  231. </div><div class="memdoc">
  232. <p>Fold case of a NUL terminated string <em>str</em> according to locale <em>loc</em> </p>
  233. <dl class="section note"><dt>Note</dt><dd>throws std::bad_cast if loc does not have <a class="el" href="classboost_1_1locale_1_1converter.html">converter</a> facet installed </dd></dl>
  234. </div>
  235. </div>
  236. <a class="anchor" id="gabcb2a619f203306eee30b03061a5cbee"></a>
  237. <div class="memitem">
  238. <div class="memproto">
  239. <div class="memtemplate">
  240. template&lt;typename CharType &gt; </div>
  241. <table class="memname">
  242. <tr>
  243. <td class="memname">std::basic_string&lt;CharType&gt; boost::locale::fold_case </td>
  244. <td>(</td>
  245. <td class="paramtype">CharType const *&#160;</td>
  246. <td class="paramname"><em>begin</em>, </td>
  247. </tr>
  248. <tr>
  249. <td class="paramkey"></td>
  250. <td></td>
  251. <td class="paramtype">CharType const *&#160;</td>
  252. <td class="paramname"><em>end</em>, </td>
  253. </tr>
  254. <tr>
  255. <td class="paramkey"></td>
  256. <td></td>
  257. <td class="paramtype">std::locale const &amp;&#160;</td>
  258. <td class="paramname"><em>loc</em> = <code>std::locale()</code>&#160;</td>
  259. </tr>
  260. <tr>
  261. <td></td>
  262. <td>)</td>
  263. <td></td><td></td>
  264. </tr>
  265. </table>
  266. </div><div class="memdoc">
  267. <p>Fold case of a string in range [begin,end) according to locale <em>loc</em> </p>
  268. <dl class="section note"><dt>Note</dt><dd>throws std::bad_cast if loc does not have <a class="el" href="classboost_1_1locale_1_1converter.html">converter</a> facet installed </dd></dl>
  269. </div>
  270. </div>
  271. <a class="anchor" id="ga867733c9d4455aaa13a42cf67367d575"></a>
  272. <div class="memitem">
  273. <div class="memproto">
  274. <div class="memtemplate">
  275. template&lt;typename CharType &gt; </div>
  276. <table class="memname">
  277. <tr>
  278. <td class="memname">std::basic_string&lt;CharType&gt; boost::locale::normalize </td>
  279. <td>(</td>
  280. <td class="paramtype">std::basic_string&lt; CharType &gt; const &amp;&#160;</td>
  281. <td class="paramname"><em>str</em>, </td>
  282. </tr>
  283. <tr>
  284. <td class="paramkey"></td>
  285. <td></td>
  286. <td class="paramtype">norm_type&#160;</td>
  287. <td class="paramname"><em>n</em> = <code>norm_default</code>, </td>
  288. </tr>
  289. <tr>
  290. <td class="paramkey"></td>
  291. <td></td>
  292. <td class="paramtype">std::locale const &amp;&#160;</td>
  293. <td class="paramname"><em>loc</em> = <code>std::locale()</code>&#160;</td>
  294. </tr>
  295. <tr>
  296. <td></td>
  297. <td>)</td>
  298. <td></td><td></td>
  299. </tr>
  300. </table>
  301. </div><div class="memdoc">
  302. <p>Normalize Unicode string <em>str</em> according to <a class="el" href="group__convert.html#ga6a595a415b83b8a0c8f14c34eb66cc9f">normalization form</a> <em>n</em> </p>
  303. <p>Note: This function receives only Unicode strings, i.e.: UTF-8, UTF-16 or UTF-32. It does not take in account the locale encoding, because Unicode decomposition and composition are meaningless outside of a Unicode character set.</p>
  304. <dl class="section note"><dt>Note</dt><dd>throws std::bad_cast if loc does not have <a class="el" href="classboost_1_1locale_1_1converter.html">converter</a> facet installed </dd></dl>
  305. </div>
  306. </div>
  307. <a class="anchor" id="gaa2e01f28fa12ea71a6318f8277f2745e"></a>
  308. <div class="memitem">
  309. <div class="memproto">
  310. <div class="memtemplate">
  311. template&lt;typename CharType &gt; </div>
  312. <table class="memname">
  313. <tr>
  314. <td class="memname">std::basic_string&lt;CharType&gt; boost::locale::normalize </td>
  315. <td>(</td>
  316. <td class="paramtype">CharType const *&#160;</td>
  317. <td class="paramname"><em>str</em>, </td>
  318. </tr>
  319. <tr>
  320. <td class="paramkey"></td>
  321. <td></td>
  322. <td class="paramtype">norm_type&#160;</td>
  323. <td class="paramname"><em>n</em> = <code>norm_default</code>, </td>
  324. </tr>
  325. <tr>
  326. <td class="paramkey"></td>
  327. <td></td>
  328. <td class="paramtype">std::locale const &amp;&#160;</td>
  329. <td class="paramname"><em>loc</em> = <code>std::locale()</code>&#160;</td>
  330. </tr>
  331. <tr>
  332. <td></td>
  333. <td>)</td>
  334. <td></td><td></td>
  335. </tr>
  336. </table>
  337. </div><div class="memdoc">
  338. <p>Normalize NUL terminated Unicode string <em>str</em> according to <a class="el" href="group__convert.html#ga6a595a415b83b8a0c8f14c34eb66cc9f">normalization form</a> <em>n</em> </p>
  339. <p>Note: This function receives only Unicode strings, i.e.: UTF-8, UTF-16 or UTF-32. It does not take in account the locale encoding, because Unicode decomposition and composition are meaningless outside of a Unicode character set.</p>
  340. <dl class="section note"><dt>Note</dt><dd>throws std::bad_cast if loc does not have <a class="el" href="classboost_1_1locale_1_1converter.html">converter</a> facet installed </dd></dl>
  341. </div>
  342. </div>
  343. <a class="anchor" id="ga03ee131e44c37c2191d15683cc281e5f"></a>
  344. <div class="memitem">
  345. <div class="memproto">
  346. <div class="memtemplate">
  347. template&lt;typename CharType &gt; </div>
  348. <table class="memname">
  349. <tr>
  350. <td class="memname">std::basic_string&lt;CharType&gt; boost::locale::normalize </td>
  351. <td>(</td>
  352. <td class="paramtype">CharType const *&#160;</td>
  353. <td class="paramname"><em>begin</em>, </td>
  354. </tr>
  355. <tr>
  356. <td class="paramkey"></td>
  357. <td></td>
  358. <td class="paramtype">CharType const *&#160;</td>
  359. <td class="paramname"><em>end</em>, </td>
  360. </tr>
  361. <tr>
  362. <td class="paramkey"></td>
  363. <td></td>
  364. <td class="paramtype">norm_type&#160;</td>
  365. <td class="paramname"><em>n</em> = <code>norm_default</code>, </td>
  366. </tr>
  367. <tr>
  368. <td class="paramkey"></td>
  369. <td></td>
  370. <td class="paramtype">std::locale const &amp;&#160;</td>
  371. <td class="paramname"><em>loc</em> = <code>std::locale()</code>&#160;</td>
  372. </tr>
  373. <tr>
  374. <td></td>
  375. <td>)</td>
  376. <td></td><td></td>
  377. </tr>
  378. </table>
  379. </div><div class="memdoc">
  380. <p>Normalize Unicode string in range [begin,end) according to <a class="el" href="group__convert.html#ga6a595a415b83b8a0c8f14c34eb66cc9f">normalization form</a> <em>n</em> </p>
  381. <p>Note: This function receives only Unicode strings, i.e.: UTF-8, UTF-16 or UTF-32. It does not take in account the locale encoding, because Unicode decomposition and composition are meaningless outside of a Unicode character set.</p>
  382. <dl class="section note"><dt>Note</dt><dd>throws std::bad_cast if loc does not have <a class="el" href="classboost_1_1locale_1_1converter.html">converter</a> facet installed </dd></dl>
  383. </div>
  384. </div>
  385. <a class="anchor" id="ga4a3eb15f42f5cbae7bdd00c9e9cac222"></a>
  386. <div class="memitem">
  387. <div class="memproto">
  388. <div class="memtemplate">
  389. template&lt;typename CharType &gt; </div>
  390. <table class="memname">
  391. <tr>
  392. <td class="memname">std::basic_string&lt;CharType&gt; boost::locale::to_lower </td>
  393. <td>(</td>
  394. <td class="paramtype">std::basic_string&lt; CharType &gt; const &amp;&#160;</td>
  395. <td class="paramname"><em>str</em>, </td>
  396. </tr>
  397. <tr>
  398. <td class="paramkey"></td>
  399. <td></td>
  400. <td class="paramtype">std::locale const &amp;&#160;</td>
  401. <td class="paramname"><em>loc</em> = <code>std::locale()</code>&#160;</td>
  402. </tr>
  403. <tr>
  404. <td></td>
  405. <td>)</td>
  406. <td></td><td></td>
  407. </tr>
  408. </table>
  409. </div><div class="memdoc">
  410. <p>Convert a string <em>str</em> to lower case according to locale <em>loc</em> </p>
  411. <dl class="section note"><dt>Note</dt><dd>throws std::bad_cast if loc does not have <a class="el" href="classboost_1_1locale_1_1converter.html">converter</a> facet installed </dd></dl>
  412. <dl><dt><b>Examples: </b></dt><dd><a class="el" href="conversions_8cpp-example.html#a2">conversions.cpp</a>, <a class="el" href="hello_8cpp-example.html#a7">hello.cpp</a>, <a class="el" href="wconversions_8cpp-example.html#a2">wconversions.cpp</a>, and <a class="el" href="whello_8cpp-example.html#a7">whello.cpp</a>.</dd>
  413. </dl>
  414. </div>
  415. </div>
  416. <a class="anchor" id="gaa7854d1e3ce4c854f4e1fa18703ffed2"></a>
  417. <div class="memitem">
  418. <div class="memproto">
  419. <div class="memtemplate">
  420. template&lt;typename CharType &gt; </div>
  421. <table class="memname">
  422. <tr>
  423. <td class="memname">std::basic_string&lt;CharType&gt; boost::locale::to_lower </td>
  424. <td>(</td>
  425. <td class="paramtype">CharType const *&#160;</td>
  426. <td class="paramname"><em>str</em>, </td>
  427. </tr>
  428. <tr>
  429. <td class="paramkey"></td>
  430. <td></td>
  431. <td class="paramtype">std::locale const &amp;&#160;</td>
  432. <td class="paramname"><em>loc</em> = <code>std::locale()</code>&#160;</td>
  433. </tr>
  434. <tr>
  435. <td></td>
  436. <td>)</td>
  437. <td></td><td></td>
  438. </tr>
  439. </table>
  440. </div><div class="memdoc">
  441. <p>Convert a NUL terminated string <em>str</em> to lower case according to locale <em>loc</em> </p>
  442. <dl class="section note"><dt>Note</dt><dd>throws std::bad_cast if loc does not have <a class="el" href="classboost_1_1locale_1_1converter.html">converter</a> facet installed </dd></dl>
  443. </div>
  444. </div>
  445. <a class="anchor" id="ga4763a6d37777254390658d1e050262a5"></a>
  446. <div class="memitem">
  447. <div class="memproto">
  448. <div class="memtemplate">
  449. template&lt;typename CharType &gt; </div>
  450. <table class="memname">
  451. <tr>
  452. <td class="memname">std::basic_string&lt;CharType&gt; boost::locale::to_lower </td>
  453. <td>(</td>
  454. <td class="paramtype">CharType const *&#160;</td>
  455. <td class="paramname"><em>begin</em>, </td>
  456. </tr>
  457. <tr>
  458. <td class="paramkey"></td>
  459. <td></td>
  460. <td class="paramtype">CharType const *&#160;</td>
  461. <td class="paramname"><em>end</em>, </td>
  462. </tr>
  463. <tr>
  464. <td class="paramkey"></td>
  465. <td></td>
  466. <td class="paramtype">std::locale const &amp;&#160;</td>
  467. <td class="paramname"><em>loc</em> = <code>std::locale()</code>&#160;</td>
  468. </tr>
  469. <tr>
  470. <td></td>
  471. <td>)</td>
  472. <td></td><td></td>
  473. </tr>
  474. </table>
  475. </div><div class="memdoc">
  476. <p>Convert a string in range [begin,end) to lower case according to locale <em>loc</em> </p>
  477. <dl class="section note"><dt>Note</dt><dd>throws std::bad_cast if loc does not have <a class="el" href="classboost_1_1locale_1_1converter.html">converter</a> facet installed </dd></dl>
  478. </div>
  479. </div>
  480. <a class="anchor" id="ga684efb375e060c71cd3e1799a6329f7f"></a>
  481. <div class="memitem">
  482. <div class="memproto">
  483. <div class="memtemplate">
  484. template&lt;typename CharType &gt; </div>
  485. <table class="memname">
  486. <tr>
  487. <td class="memname">std::basic_string&lt;CharType&gt; boost::locale::to_title </td>
  488. <td>(</td>
  489. <td class="paramtype">std::basic_string&lt; CharType &gt; const &amp;&#160;</td>
  490. <td class="paramname"><em>str</em>, </td>
  491. </tr>
  492. <tr>
  493. <td class="paramkey"></td>
  494. <td></td>
  495. <td class="paramtype">std::locale const &amp;&#160;</td>
  496. <td class="paramname"><em>loc</em> = <code>std::locale()</code>&#160;</td>
  497. </tr>
  498. <tr>
  499. <td></td>
  500. <td>)</td>
  501. <td></td><td></td>
  502. </tr>
  503. </table>
  504. </div><div class="memdoc">
  505. <p>Convert a string <em>str</em> to title case according to locale <em>loc</em> </p>
  506. <dl class="section note"><dt>Note</dt><dd>throws std::bad_cast if loc does not have <a class="el" href="classboost_1_1locale_1_1converter.html">converter</a> facet installed </dd></dl>
  507. <dl><dt><b>Examples: </b></dt><dd><a class="el" href="hello_8cpp-example.html#a8">hello.cpp</a>, and <a class="el" href="whello_8cpp-example.html#a8">whello.cpp</a>.</dd>
  508. </dl>
  509. </div>
  510. </div>
  511. <a class="anchor" id="ga16e9258de2d6009546fb0fb07afd67b7"></a>
  512. <div class="memitem">
  513. <div class="memproto">
  514. <div class="memtemplate">
  515. template&lt;typename CharType &gt; </div>
  516. <table class="memname">
  517. <tr>
  518. <td class="memname">std::basic_string&lt;CharType&gt; boost::locale::to_title </td>
  519. <td>(</td>
  520. <td class="paramtype">CharType const *&#160;</td>
  521. <td class="paramname"><em>str</em>, </td>
  522. </tr>
  523. <tr>
  524. <td class="paramkey"></td>
  525. <td></td>
  526. <td class="paramtype">std::locale const &amp;&#160;</td>
  527. <td class="paramname"><em>loc</em> = <code>std::locale()</code>&#160;</td>
  528. </tr>
  529. <tr>
  530. <td></td>
  531. <td>)</td>
  532. <td></td><td></td>
  533. </tr>
  534. </table>
  535. </div><div class="memdoc">
  536. <p>Convert a NUL terminated string <em>str</em> to title case according to locale <em>loc</em> </p>
  537. <dl class="section note"><dt>Note</dt><dd>throws std::bad_cast if loc does not have <a class="el" href="classboost_1_1locale_1_1converter.html">converter</a> facet installed </dd></dl>
  538. </div>
  539. </div>
  540. <a class="anchor" id="gab2ff15b36c6f177737c7ae737eb70794"></a>
  541. <div class="memitem">
  542. <div class="memproto">
  543. <div class="memtemplate">
  544. template&lt;typename CharType &gt; </div>
  545. <table class="memname">
  546. <tr>
  547. <td class="memname">std::basic_string&lt;CharType&gt; boost::locale::to_title </td>
  548. <td>(</td>
  549. <td class="paramtype">CharType const *&#160;</td>
  550. <td class="paramname"><em>begin</em>, </td>
  551. </tr>
  552. <tr>
  553. <td class="paramkey"></td>
  554. <td></td>
  555. <td class="paramtype">CharType const *&#160;</td>
  556. <td class="paramname"><em>end</em>, </td>
  557. </tr>
  558. <tr>
  559. <td class="paramkey"></td>
  560. <td></td>
  561. <td class="paramtype">std::locale const &amp;&#160;</td>
  562. <td class="paramname"><em>loc</em> = <code>std::locale()</code>&#160;</td>
  563. </tr>
  564. <tr>
  565. <td></td>
  566. <td>)</td>
  567. <td></td><td></td>
  568. </tr>
  569. </table>
  570. </div><div class="memdoc">
  571. <p>Convert a string in range [begin,end) to title case according to locale <em>loc</em> </p>
  572. <dl class="section note"><dt>Note</dt><dd>throws std::bad_cast if loc does not have <a class="el" href="classboost_1_1locale_1_1converter.html">converter</a> facet installed </dd></dl>
  573. </div>
  574. </div>
  575. <a class="anchor" id="ga2ceae621801e8cf4f77c60d1e3047ae8"></a>
  576. <div class="memitem">
  577. <div class="memproto">
  578. <div class="memtemplate">
  579. template&lt;typename CharType &gt; </div>
  580. <table class="memname">
  581. <tr>
  582. <td class="memname">std::basic_string&lt;CharType&gt; boost::locale::to_upper </td>
  583. <td>(</td>
  584. <td class="paramtype">std::basic_string&lt; CharType &gt; const &amp;&#160;</td>
  585. <td class="paramname"><em>str</em>, </td>
  586. </tr>
  587. <tr>
  588. <td class="paramkey"></td>
  589. <td></td>
  590. <td class="paramtype">std::locale const &amp;&#160;</td>
  591. <td class="paramname"><em>loc</em> = <code>std::locale()</code>&#160;</td>
  592. </tr>
  593. <tr>
  594. <td></td>
  595. <td>)</td>
  596. <td></td><td></td>
  597. </tr>
  598. </table>
  599. </div><div class="memdoc">
  600. <p>Convert a string <em>str</em> to upper case according to locale <em>loc</em> </p>
  601. <dl class="section note"><dt>Note</dt><dd>throws std::bad_cast if loc does not have <a class="el" href="classboost_1_1locale_1_1converter.html">converter</a> facet installed </dd></dl>
  602. <dl><dt><b>Examples: </b></dt><dd><a class="el" href="conversions_8cpp-example.html#a1">conversions.cpp</a>, <a class="el" href="hello_8cpp-example.html#a6">hello.cpp</a>, <a class="el" href="wconversions_8cpp-example.html#a1">wconversions.cpp</a>, and <a class="el" href="whello_8cpp-example.html#a6">whello.cpp</a>.</dd>
  603. </dl>
  604. </div>
  605. </div>
  606. <a class="anchor" id="ga2197dbd88d8b42a5e6b2b76fb67ed07d"></a>
  607. <div class="memitem">
  608. <div class="memproto">
  609. <div class="memtemplate">
  610. template&lt;typename CharType &gt; </div>
  611. <table class="memname">
  612. <tr>
  613. <td class="memname">std::basic_string&lt;CharType&gt; boost::locale::to_upper </td>
  614. <td>(</td>
  615. <td class="paramtype">CharType const *&#160;</td>
  616. <td class="paramname"><em>str</em>, </td>
  617. </tr>
  618. <tr>
  619. <td class="paramkey"></td>
  620. <td></td>
  621. <td class="paramtype">std::locale const &amp;&#160;</td>
  622. <td class="paramname"><em>loc</em> = <code>std::locale()</code>&#160;</td>
  623. </tr>
  624. <tr>
  625. <td></td>
  626. <td>)</td>
  627. <td></td><td></td>
  628. </tr>
  629. </table>
  630. </div><div class="memdoc">
  631. <p>Convert a NUL terminated string <em>str</em> to upper case according to locale <em>loc</em> </p>
  632. <dl class="section note"><dt>Note</dt><dd>throws std::bad_cast if loc does not have <a class="el" href="classboost_1_1locale_1_1converter.html">converter</a> facet installed </dd></dl>
  633. </div>
  634. </div>
  635. <a class="anchor" id="ga55257608f61f0bde86f7306b477c993a"></a>
  636. <div class="memitem">
  637. <div class="memproto">
  638. <div class="memtemplate">
  639. template&lt;typename CharType &gt; </div>
  640. <table class="memname">
  641. <tr>
  642. <td class="memname">std::basic_string&lt;CharType&gt; boost::locale::to_upper </td>
  643. <td>(</td>
  644. <td class="paramtype">CharType const *&#160;</td>
  645. <td class="paramname"><em>begin</em>, </td>
  646. </tr>
  647. <tr>
  648. <td class="paramkey"></td>
  649. <td></td>
  650. <td class="paramtype">CharType const *&#160;</td>
  651. <td class="paramname"><em>end</em>, </td>
  652. </tr>
  653. <tr>
  654. <td class="paramkey"></td>
  655. <td></td>
  656. <td class="paramtype">std::locale const &amp;&#160;</td>
  657. <td class="paramname"><em>loc</em> = <code>std::locale()</code>&#160;</td>
  658. </tr>
  659. <tr>
  660. <td></td>
  661. <td>)</td>
  662. <td></td><td></td>
  663. </tr>
  664. </table>
  665. </div><div class="memdoc">
  666. <p>Convert a string in range [begin,end) to upper case according to locale <em>loc</em> </p>
  667. <dl class="section note"><dt>Note</dt><dd>throws std::bad_cast if loc does not have <a class="el" href="classboost_1_1locale_1_1converter.html">converter</a> facet installed </dd></dl>
  668. </div>
  669. </div>
  670. </div><!-- contents -->
  671. </div><!-- doc-content -->
  672. <li class="footer">
  673. &copy; 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.
  674. </li>
  675. </ul>
  676. </div>
  677. </body>
  678. </html>