ceph/src/boost/libs/locale/doc/html/classboost_1_1locale_1_1util_1_1base__converter.html

   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: boost::locale::util::base_converter Class Reference</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 class="current"><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 id="navrow2" class="tabs2">
  49     <ul class="tablist">
  50       <li><a href="annotated.html"><span>Class&#160;List</span></a></li>
  51       <li><a href="hierarchy.html"><span>Class&#160;Hierarchy</span></a></li>
  52       <li><a href="functions.html"><span>Class&#160;Members</span></a></li>
  53     </ul>
  54   </div>
  55 </div><!-- top -->
  56 <div id="side-nav" class="ui-resizable side-nav-resizable">
  57   <div id="nav-tree">
  58     <div id="nav-tree-contents">
  59       <div id="nav-sync" class="sync"></div>
  60     </div>
  61   </div>
  62   <div id="splitbar" style="-moz-user-select:none;"
  63        class="ui-resizable-handle">
  64   </div>
  65 </div>
  66 <script type="text/javascript">
  67 $(document).ready(function(){initNavTree('classboost_1_1locale_1_1util_1_1base__converter.html','');});
  68 </script>
  69 <div id="doc-content">
  70 <div class="header">
  71   <div class="summary">
  72 <a href="#pub-methods">Public Member Functions</a> &#124;
  73 <a href="#pub-static-attribs">Static Public Attributes</a> &#124;
  74 <a href="classboost_1_1locale_1_1util_1_1base__converter-members.html">List of all members</a>  </div>
  75   <div class="headertitle">
  76 <div class="title">boost::locale::util::base_converter Class Reference</div>  </div>
  77 </div><!--header-->
  78 <div class="contents">
  79
  80 <p>This class represent a simple stateless converter from UCS-4 and to UCS-4 for each single code point.
  81  <a href="classboost_1_1locale_1_1util_1_1base__converter.html#details">More...</a></p>
  82
  83 <p><code>#include &lt;<a class="el" href="util_8hpp_source.html">boost/locale/util.hpp</a>&gt;</code></p>
  84 <table class="memberdecls">
  85 <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-methods"></a>
  86 Public Member Functions</h2></td></tr>
  87 <tr class="memitem:ab2332b78e3e0c0b94ea3f6dafd123d60"><td class="memItemLeft" align="right" valign="top">virtual int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classboost_1_1locale_1_1util_1_1base__converter.html#ab2332b78e3e0c0b94ea3f6dafd123d60">max_len</a> () const </td></tr>
  88 <tr class="separator:ab2332b78e3e0c0b94ea3f6dafd123d60"><td class="memSeparator" colspan="2">&#160;</td></tr>
  89 <tr class="memitem:aadcc2c1a767f9d24972c6995e81c1315"><td class="memItemLeft" align="right" valign="top">virtual bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classboost_1_1locale_1_1util_1_1base__converter.html#aadcc2c1a767f9d24972c6995e81c1315">is_thread_safe</a> () const </td></tr>
  90 <tr class="separator:aadcc2c1a767f9d24972c6995e81c1315"><td class="memSeparator" colspan="2">&#160;</td></tr>
  91 <tr class="memitem:a702b31840be6f5c540cd22ac75cb2349"><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="classboost_1_1locale_1_1util_1_1base__converter.html">base_converter</a> *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classboost_1_1locale_1_1util_1_1base__converter.html#a702b31840be6f5c540cd22ac75cb2349">clone</a> () const </td></tr>
  92 <tr class="separator:a702b31840be6f5c540cd22ac75cb2349"><td class="memSeparator" colspan="2">&#160;</td></tr>
  93 <tr class="memitem:a27181b314e09f62ae9ea8fcd30d4e7c4"><td class="memItemLeft" align="right" valign="top">virtual uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classboost_1_1locale_1_1util_1_1base__converter.html#a27181b314e09f62ae9ea8fcd30d4e7c4">to_unicode</a> (char const *&amp;begin, char const *end)</td></tr>
  94 <tr class="separator:a27181b314e09f62ae9ea8fcd30d4e7c4"><td class="memSeparator" colspan="2">&#160;</td></tr>
  95 <tr class="memitem:afeecf1ee2699c26960cbf2d7d6d71d41"><td class="memItemLeft" align="right" valign="top">virtual uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classboost_1_1locale_1_1util_1_1base__converter.html#afeecf1ee2699c26960cbf2d7d6d71d41">from_unicode</a> (uint32_t u, char *begin, char const *end)</td></tr>
  96 <tr class="separator:afeecf1ee2699c26960cbf2d7d6d71d41"><td class="memSeparator" colspan="2">&#160;</td></tr>
  97 </table><table class="memberdecls">
  98 <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-static-attribs"></a>
  99 Static Public Attributes</h2></td></tr>
 100 <tr class="memitem:aa02e2dfd8ddc2b40a8705c6ea7fa8d48"><td class="memItemLeft" align="right" valign="top">static const uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classboost_1_1locale_1_1util_1_1base__converter.html#aa02e2dfd8ddc2b40a8705c6ea7fa8d48">illegal</a> =utf::illegal</td></tr>
 101 <tr class="separator:aa02e2dfd8ddc2b40a8705c6ea7fa8d48"><td class="memSeparator" colspan="2">&#160;</td></tr>
 102 <tr class="memitem:aa78dd2bae2783e31a00849a4e74aeb1e"><td class="memItemLeft" align="right" valign="top">static const uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classboost_1_1locale_1_1util_1_1base__converter.html#aa78dd2bae2783e31a00849a4e74aeb1e">incomplete</a> =utf::incomplete</td></tr>
 103 <tr class="separator:aa78dd2bae2783e31a00849a4e74aeb1e"><td class="memSeparator" colspan="2">&#160;</td></tr>
 104 </table>
 105 <a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
 106 <div class="textblock"><p>This class represent a simple stateless converter from UCS-4 and to UCS-4 for each single code point. </p>
 107 <p>This class is used for creation of std::codecvt facet for converting utf-16/utf-32 encoding to encoding supported by this converter</p>
 108 <p>Please note, this converter should be fully stateless. Fully stateless means it should never assume that it is called in any specific order on the text. Even if the encoding itself seems to be stateless like windows-1255 or shift-jis, some encoders (most notably iconv) can actually compose several code-point into one or decompose them in case composite characters are found. So be very careful when implementing these converters for certain character set. </p>
 109 </div><h2 class="groupheader">Member Function Documentation</h2>
 110 <a class="anchor" id="a702b31840be6f5c540cd22ac75cb2349"></a>
 111 <div class="memitem">
 112 <div class="memproto">
 113 <table class="mlabels">
 114   <tr>
 115   <td class="mlabels-left">
 116       <table class="memname">
 117         <tr>
 118           <td class="memname">virtual <a class="el" href="classboost_1_1locale_1_1util_1_1base__converter.html">base_converter</a>* boost::locale::util::base_converter::clone </td>
 119           <td>(</td>
 120           <td class="paramname"></td><td>)</td>
 121           <td> const</td>
 122         </tr>
 123       </table>
 124   </td>
 125   <td class="mlabels-right">
 126 <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">virtual</span></span>  </td>
 127   </tr>
 128 </table>
 129 </div><div class="memdoc">
 130 <p>Create a polymorphic copy of this object, usually called only if <a class="el" href="classboost_1_1locale_1_1util_1_1base__converter.html#aadcc2c1a767f9d24972c6995e81c1315">is_thread_safe()</a> return false </p>
 131
 132 </div>
 133 </div>
 134 <a class="anchor" id="afeecf1ee2699c26960cbf2d7d6d71d41"></a>
 135 <div class="memitem">
 136 <div class="memproto">
 137 <table class="mlabels">
 138   <tr>
 139   <td class="mlabels-left">
 140       <table class="memname">
 141         <tr>
 142           <td class="memname">virtual uint32_t boost::locale::util::base_converter::from_unicode </td>
 143           <td>(</td>
 144           <td class="paramtype">uint32_t&#160;</td>
 145           <td class="paramname"><em>u</em>, </td>
 146         </tr>
 147         <tr>
 148           <td class="paramkey"></td>
 149           <td></td>
 150           <td class="paramtype">char *&#160;</td>
 151           <td class="paramname"><em>begin</em>, </td>
 152         </tr>
 153         <tr>
 154           <td class="paramkey"></td>
 155           <td></td>
 156           <td class="paramtype">char const *&#160;</td>
 157           <td class="paramname"><em>end</em>&#160;</td>
 158         </tr>
 159         <tr>
 160           <td></td>
 161           <td>)</td>
 162           <td></td><td></td>
 163         </tr>
 164       </table>
 165   </td>
 166   <td class="mlabels-right">
 167 <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">virtual</span></span>  </td>
 168   </tr>
 169 </table>
 170 </div><div class="memdoc">
 171 <p>Convert a single code-point <em>u</em> into encoding and store it in [begin,end) range.</p>
 172 <p>If u is invalid Unicode code-point, or it can not be mapped correctly to represented character set, <em>illegal</em> should be returned</p>
 173 <p>If u can be converted to a sequence of bytes c1, ... , cN (1&lt;= N &lt;= <a class="el" href="classboost_1_1locale_1_1util_1_1base__converter.html#ab2332b78e3e0c0b94ea3f6dafd123d60">max_len()</a> ) then</p>
 174 <ol type="1">
 175 <li>If end - begin &gt;= N, c1, ... cN are written starting at begin and N is returned</li>
 176 <li>If end - begin &lt; N, incomplete is returned, it is unspecified what would be stored in bytes in range [begin,end) </li>
 177 </ol>
 178
 179 </div>
 180 </div>
 181 <a class="anchor" id="aadcc2c1a767f9d24972c6995e81c1315"></a>
 182 <div class="memitem">
 183 <div class="memproto">
 184 <table class="mlabels">
 185   <tr>
 186   <td class="mlabels-left">
 187       <table class="memname">
 188         <tr>
 189           <td class="memname">virtual bool boost::locale::util::base_converter::is_thread_safe </td>
 190           <td>(</td>
 191           <td class="paramname"></td><td>)</td>
 192           <td> const</td>
 193         </tr>
 194       </table>
 195   </td>
 196   <td class="mlabels-right">
 197 <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">virtual</span></span>  </td>
 198   </tr>
 199 </table>
 200 </div><div class="memdoc">
 201 <p>Returns true if calling the functions from_unicode, to_unicode, and max_len is thread safe.</p>
 202 <p>Rule of thumb: if this class' implementation uses simple tables that are unchanged or is purely algorithmic like UTF-8 - so it does not share any mutable bit for independent to_unicode, from_unicode calls, you may set it to true, otherwise, for example if you use iconv_t descriptor or UConverter as conversion object return false, and this object will be cloned for each use. </p>
 203
 204 </div>
 205 </div>
 206 <a class="anchor" id="ab2332b78e3e0c0b94ea3f6dafd123d60"></a>
 207 <div class="memitem">
 208 <div class="memproto">
 209 <table class="mlabels">
 210   <tr>
 211   <td class="mlabels-left">
 212       <table class="memname">
 213         <tr>
 214           <td class="memname">virtual int boost::locale::util::base_converter::max_len </td>
 215           <td>(</td>
 216           <td class="paramname"></td><td>)</td>
 217           <td> const</td>
 218         </tr>
 219       </table>
 220   </td>
 221   <td class="mlabels-right">
 222 <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">virtual</span></span>  </td>
 223   </tr>
 224 </table>
 225 </div><div class="memdoc">
 226 <p>Return the maximal length that one Unicode code-point can be converted to, for example for UTF-8 it is 4, for Shift-JIS it is 2 and ISO-8859-1 is 1 </p>
 227
 228 </div>
 229 </div>
 230 <a class="anchor" id="a27181b314e09f62ae9ea8fcd30d4e7c4"></a>
 231 <div class="memitem">
 232 <div class="memproto">
 233 <table class="mlabels">
 234   <tr>
 235   <td class="mlabels-left">
 236       <table class="memname">
 237         <tr>
 238           <td class="memname">virtual uint32_t boost::locale::util::base_converter::to_unicode </td>
 239           <td>(</td>
 240           <td class="paramtype">char const *&amp;&#160;</td>
 241           <td class="paramname"><em>begin</em>, </td>
 242         </tr>
 243         <tr>
 244           <td class="paramkey"></td>
 245           <td></td>
 246           <td class="paramtype">char const *&#160;</td>
 247           <td class="paramname"><em>end</em>&#160;</td>
 248         </tr>
 249         <tr>
 250           <td></td>
 251           <td>)</td>
 252           <td></td><td></td>
 253         </tr>
 254       </table>
 255   </td>
 256   <td class="mlabels-right">
 257 <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">virtual</span></span>  </td>
 258   </tr>
 259 </table>
 260 </div><div class="memdoc">
 261 <p>Convert a single character starting at begin and ending at most at end to Unicode code-point.</p>
 262 <p>if valid input sequence found in [<em>begin</em>,<em>code_point_end</em>) such as <em>begin</em> &lt; <em>code_point_end</em> &amp;&amp; <em>code_point_end</em> &lt;= <em>end</em> it is converted to its Unicode code point equivalent, <em>begin</em> is set to <em>code_point_end</em> </p>
 263 <p>if incomplete input sequence found in [<em>begin</em>,<em>end</em>), i.e. there my be such <em>code_point_end</em> that <em>code_point_end</em> &gt; <em>end</em> and [<em>begin</em>, <em>code_point_end</em>) would be valid input sequence, then <em>incomplete</em> is returned begin stays unchanged, for example for UTF-8 conversion a *begin = 0xc2, <em>begin</em> +1 = <em>end</em> is such situation.</p>
 264 <p>if invalid input sequence found, i.e. there is a sequence [<em>begin</em>, <em>code_point_end</em>) such as <em>code_point_end</em> &lt;= <em>end</em> that is illegal for this encoding, <em>illegal</em> is returned and begin stays unchanged. For example if *begin = 0xFF and begin &lt; end for UTF-8, then <em>illegal</em> is returned. </p>
 265
 266 </div>
 267 </div>
 268 <h2 class="groupheader">Member Data Documentation</h2>
 269 <a class="anchor" id="aa02e2dfd8ddc2b40a8705c6ea7fa8d48"></a>
 270 <div class="memitem">
 271 <div class="memproto">
 272 <table class="mlabels">
 273   <tr>
 274   <td class="mlabels-left">
 275       <table class="memname">
 276         <tr>
 277           <td class="memname">const uint32_t boost::locale::util::base_converter::illegal =utf::illegal</td>
 278         </tr>
 279       </table>
 280   </td>
 281   <td class="mlabels-right">
 282 <span class="mlabels"><span class="mlabel">static</span></span>  </td>
 283   </tr>
 284 </table>
 285 </div><div class="memdoc">
 286 <p>This value should be returned when an illegal input sequence or code-point is observed: For example if a UCS-32 code-point is in the range reserved for UTF-16 surrogates or an invalid UTF-8 sequence is found </p>
 287
 288 </div>
 289 </div>
 290 <a class="anchor" id="aa78dd2bae2783e31a00849a4e74aeb1e"></a>
 291 <div class="memitem">
 292 <div class="memproto">
 293 <table class="mlabels">
 294   <tr>
 295   <td class="mlabels-left">
 296       <table class="memname">
 297         <tr>
 298           <td class="memname">const uint32_t boost::locale::util::base_converter::incomplete =utf::incomplete</td>
 299         </tr>
 300       </table>
 301   </td>
 302   <td class="mlabels-right">
 303 <span class="mlabels"><span class="mlabel">static</span></span>  </td>
 304   </tr>
 305 </table>
 306 </div><div class="memdoc">
 307 <p>This value is returned in following cases: The of incomplete input sequence was found or insufficient output buffer was provided so complete output could not be written. </p>
 308
 309 </div>
 310 </div>
 311 <hr/>The documentation for this class was generated from the following file:<ul>
 312 <li>boost/locale/<a class="el" href="util_8hpp_source.html">util.hpp</a></li>
 313 </ul>
 314 </div><!-- contents -->
 315 </div><!-- doc-content -->
 316
 317     <li class="footer">
 318 &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.
 319     </li>
 320    </ul>
 321  </div>
 322 </body>
 323 </html>