sfmlinstaller

sfmlinstaller Mercurial Source Tree


Root/windows/doc/html/Utf_8inl_source.htm

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
    <head>
        <title>SFML - Simple and Fast Multimedia Library</title>
        <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"/>
        <!--<link rel='stylesheet' type='text/css' href="http://fonts.googleapis.com/css?family=Ubuntu:400,700,400italic"/>-->
        <link rel="stylesheet" type="text/css" href="doxygen.css" title="default" media="screen,print" />
    </head>
    <body>
        <div id="banner-container">
            <div id="banner">
                <span id="sfml">SFML</span>
            </div>
        </div>
        <div id="content">
<!-- Generated by Doxygen 1.8.2 -->
  <div id="navrow1" class="tabs">
    <ul class="tablist">
      <li><a href="index.htm"><span>Main Page</span></a></li>
      <li><a href="modules.htm"><span>Modules</span></a></li>
      <li><a href="annotated.htm"><span>Classes</span></a></li>
      <li class="current"><a href="files.htm"><span>Files</span></a></li>
    </ul>
  </div>
  <div id="navrow2" class="tabs2">
    <ul class="tablist">
      <li><a href="files.htm"><span>File List</span></a></li>
    </ul>
  </div>
<div id="nav-path" class="navpath">
  <ul>
<li class="navelem"><a class="el" href="dir_f3190241575fd2bd132a392ae6942f4a.htm">include</a></li><li class="navelem"><a class="el" href="dir_692f376662c82a26cfe4cfa3aceebe24.htm">SFML</a></li><li class="navelem"><a class="el" href="dir_60c5c649f8df3b69a45a020d59f81335.htm">System</a></li>  </ul>
</div>
</div><!-- top -->
<div class="header">
  <div class="headertitle">
<div class="title">Utf.inl</div>  </div>
</div><!--header-->
<div class="contents">
<div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno">    1</span> </div>
<div class="line"><a name="l00002"></a><span class="lineno">    2</span> <span class="comment">//</span></div>
<div class="line"><a name="l00003"></a><span class="lineno">    3</span> <span class="comment">// SFML - Simple and Fast Multimedia Library</span></div>
<div class="line"><a name="l00004"></a><span class="lineno">    4</span> <span class="comment">// Copyright (C) 2007-2012 Laurent Gomila (laurent.gom@gmail.com)</span></div>
<div class="line"><a name="l00005"></a><span class="lineno">    5</span> <span class="comment">//</span></div>
<div class="line"><a name="l00006"></a><span class="lineno">    6</span> <span class="comment">// This software is provided 'as-is', without any express or implied warranty.</span></div>
<div class="line"><a name="l00007"></a><span class="lineno">    7</span> <span class="comment">// In no event will the authors be held liable for any damages arising from the use of this software.</span></div>
<div class="line"><a name="l00008"></a><span class="lineno">    8</span> <span class="comment">//</span></div>
<div class="line"><a name="l00009"></a><span class="lineno">    9</span> <span class="comment">// Permission is granted to anyone to use this software for any purpose,</span></div>
<div class="line"><a name="l00010"></a><span class="lineno">   10</span> <span class="comment">// including commercial applications, and to alter it and redistribute it freely,</span></div>
<div class="line"><a name="l00011"></a><span class="lineno">   11</span> <span class="comment">// subject to the following restrictions:</span></div>
<div class="line"><a name="l00012"></a><span class="lineno">   12</span> <span class="comment">//</span></div>
<div class="line"><a name="l00013"></a><span class="lineno">   13</span> <span class="comment">// 1. The origin of this software must not be misrepresented;</span></div>
<div class="line"><a name="l00014"></a><span class="lineno">   14</span> <span class="comment">//    you must not claim that you wrote the original software.</span></div>
<div class="line"><a name="l00015"></a><span class="lineno">   15</span> <span class="comment">//    If you use this software in a product, an acknowledgment</span></div>
<div class="line"><a name="l00016"></a><span class="lineno">   16</span> <span class="comment">//    in the product documentation would be appreciated but is not required.</span></div>
<div class="line"><a name="l00017"></a><span class="lineno">   17</span> <span class="comment">//</span></div>
<div class="line"><a name="l00018"></a><span class="lineno">   18</span> <span class="comment">// 2. Altered source versions must be plainly marked as such,</span></div>
<div class="line"><a name="l00019"></a><span class="lineno">   19</span> <span class="comment">//    and must not be misrepresented as being the original software.</span></div>
<div class="line"><a name="l00020"></a><span class="lineno">   20</span> <span class="comment">//</span></div>
<div class="line"><a name="l00021"></a><span class="lineno">   21</span> <span class="comment">// 3. This notice may not be removed or altered from any source distribution.</span></div>
<div class="line"><a name="l00022"></a><span class="lineno">   22</span> <span class="comment">//</span></div>
<div class="line"><a name="l00024"></a><span class="lineno">   24</span> <span class="comment"></span></div>
<div class="line"><a name="l00025"></a><span class="lineno">   25</span> </div>
<div class="line"><a name="l00027"></a><span class="lineno">   27</span> <span class="comment">// References :</span></div>
<div class="line"><a name="l00028"></a><span class="lineno">   28</span> <span class="comment">//</span></div>
<div class="line"><a name="l00029"></a><span class="lineno">   29</span> <span class="comment">// http://www.unicode.org/</span></div>
<div class="line"><a name="l00030"></a><span class="lineno">   30</span> <span class="comment">// http://www.unicode.org/Public/PROGRAMS/CVTUTF/ConvertUTF.c</span></div>
<div class="line"><a name="l00031"></a><span class="lineno">   31</span> <span class="comment">// http://www.unicode.org/Public/PROGRAMS/CVTUTF/ConvertUTF.h</span></div>
<div class="line"><a name="l00032"></a><span class="lineno">   32</span> <span class="comment">// http://people.w3.org/rishida/scripts/uniview/conversion</span></div>
<div class="line"><a name="l00033"></a><span class="lineno">   33</span> <span class="comment">//</span></div>
<div class="line"><a name="l00035"></a><span class="lineno">   35</span> <span class="comment"></span></div>
<div class="line"><a name="l00036"></a><span class="lineno">   36</span> </div>
<div class="line"><a name="l00038"></a><span class="lineno">   38</span> <span class="keyword">template</span> <<span class="keyword">typename</span> In></div>
<div class="line"><a name="l00039"></a><span class="lineno">   39</span> In <a class="code" href="classUtf.htm">Utf<8>::decode</a>(In begin, In end, Uint32& output, Uint32 replacement)</div>
<div class="line"><a name="l00040"></a><span class="lineno">   40</span> {</div>
<div class="line"><a name="l00041"></a><span class="lineno">   41</span>     <span class="comment">// Some useful precomputed data</span></div>
<div class="line"><a name="l00042"></a><span class="lineno">   42</span>     <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">int</span> trailing[256] =</div>
<div class="line"><a name="l00043"></a><span class="lineno">   43</span>     {</div>
<div class="line"><a name="l00044"></a><span class="lineno">   44</span>         0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,</div>
<div class="line"><a name="l00045"></a><span class="lineno">   45</span>         0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,</div>
<div class="line"><a name="l00046"></a><span class="lineno">   46</span>         0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,</div>
<div class="line"><a name="l00047"></a><span class="lineno">   47</span>         0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,</div>
<div class="line"><a name="l00048"></a><span class="lineno">   48</span>         0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,</div>
<div class="line"><a name="l00049"></a><span class="lineno">   49</span>         0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,</div>
<div class="line"><a name="l00050"></a><span class="lineno">   50</span>         1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,</div>
<div class="line"><a name="l00051"></a><span class="lineno">   51</span>         2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 3, 3, 3, 3, 3, 3, 3, 3, 4, 4, 4, 4, 5, 5, 5, 5</div>
<div class="line"><a name="l00052"></a><span class="lineno">   52</span>     };</div>
<div class="line"><a name="l00053"></a><span class="lineno">   53</span>     <span class="keyword">static</span> <span class="keyword">const</span> Uint32 offsets[6] =</div>
<div class="line"><a name="l00054"></a><span class="lineno">   54</span>     {</div>
<div class="line"><a name="l00055"></a><span class="lineno">   55</span>         0x00000000, 0x00003080, 0x000E2080, 0x03C82080, 0xFA082080, 0x82082080</div>
<div class="line"><a name="l00056"></a><span class="lineno">   56</span>     };</div>
<div class="line"><a name="l00057"></a><span class="lineno">   57</span> </div>
<div class="line"><a name="l00058"></a><span class="lineno">   58</span>     <span class="comment">// decode the character</span></div>
<div class="line"><a name="l00059"></a><span class="lineno">   59</span>     <span class="keywordtype">int</span> trailingBytes = trailing[<span class="keyword">static_cast<</span>Uint8<span class="keyword">></span>(*begin)];</div>
<div class="line"><a name="l00060"></a><span class="lineno">   60</span>     <span class="keywordflow">if</span> (begin + trailingBytes < end)</div>
<div class="line"><a name="l00061"></a><span class="lineno">   61</span>     {</div>
<div class="line"><a name="l00062"></a><span class="lineno">   62</span>         output = 0;</div>
<div class="line"><a name="l00063"></a><span class="lineno">   63</span>         <span class="keywordflow">switch</span> (trailingBytes)</div>
<div class="line"><a name="l00064"></a><span class="lineno">   64</span>         {</div>
<div class="line"><a name="l00065"></a><span class="lineno">   65</span>             <span class="keywordflow">case</span> 5 : output += <span class="keyword">static_cast<</span>Uint8<span class="keyword">></span>(*begin++); output <<= 6;</div>
<div class="line"><a name="l00066"></a><span class="lineno">   66</span>             <span class="keywordflow">case</span> 4 : output += <span class="keyword">static_cast<</span>Uint8<span class="keyword">></span>(*begin++); output <<= 6;</div>
<div class="line"><a name="l00067"></a><span class="lineno">   67</span>             <span class="keywordflow">case</span> 3 : output += <span class="keyword">static_cast<</span>Uint8<span class="keyword">></span>(*begin++); output <<= 6;</div>
<div class="line"><a name="l00068"></a><span class="lineno">   68</span>             <span class="keywordflow">case</span> 2 : output += <span class="keyword">static_cast<</span>Uint8<span class="keyword">></span>(*begin++); output <<= 6;</div>
<div class="line"><a name="l00069"></a><span class="lineno">   69</span>             <span class="keywordflow">case</span> 1 : output += <span class="keyword">static_cast<</span>Uint8<span class="keyword">></span>(*begin++); output <<= 6;</div>
<div class="line"><a name="l00070"></a><span class="lineno">   70</span>             <span class="keywordflow">case</span> 0 : output += <span class="keyword">static_cast<</span>Uint8<span class="keyword">></span>(*begin++);</div>
<div class="line"><a name="l00071"></a><span class="lineno">   71</span>         }</div>
<div class="line"><a name="l00072"></a><span class="lineno">   72</span>         output -= offsets[trailingBytes];</div>
<div class="line"><a name="l00073"></a><span class="lineno">   73</span>     }</div>
<div class="line"><a name="l00074"></a><span class="lineno">   74</span>     <span class="keywordflow">else</span></div>
<div class="line"><a name="l00075"></a><span class="lineno">   75</span>     {</div>
<div class="line"><a name="l00076"></a><span class="lineno">   76</span>         <span class="comment">// Incomplete character</span></div>
<div class="line"><a name="l00077"></a><span class="lineno">   77</span>         begin = end;</div>
<div class="line"><a name="l00078"></a><span class="lineno">   78</span>         output = replacement;</div>
<div class="line"><a name="l00079"></a><span class="lineno">   79</span>     }</div>
<div class="line"><a name="l00080"></a><span class="lineno">   80</span> </div>
<div class="line"><a name="l00081"></a><span class="lineno">   81</span>     <span class="keywordflow">return</span> begin;</div>
<div class="line"><a name="l00082"></a><span class="lineno">   82</span> }</div>
<div class="line"><a name="l00083"></a><span class="lineno">   83</span> </div>
<div class="line"><a name="l00084"></a><span class="lineno">   84</span> </div>
<div class="line"><a name="l00086"></a><span class="lineno">   86</span> <span class="keyword">template</span> <<span class="keyword">typename</span> Out></div>
<div class="line"><a name="l00087"></a><span class="lineno">   87</span> Out <a class="code" href="classUtf.htm">Utf<8>::encode</a>(Uint32 input, Out output, Uint8 replacement)</div>
<div class="line"><a name="l00088"></a><span class="lineno">   88</span> {</div>
<div class="line"><a name="l00089"></a><span class="lineno">   89</span>     <span class="comment">// Some useful precomputed data</span></div>
<div class="line"><a name="l00090"></a><span class="lineno">   90</span>     <span class="keyword">static</span> <span class="keyword">const</span> Uint8 firstBytes[7] =</div>
<div class="line"><a name="l00091"></a><span class="lineno">   91</span>     {</div>
<div class="line"><a name="l00092"></a><span class="lineno">   92</span>         0x00, 0x00, 0xC0, 0xE0, 0xF0, 0xF8, 0xFC</div>
<div class="line"><a name="l00093"></a><span class="lineno">   93</span>     };</div>
<div class="line"><a name="l00094"></a><span class="lineno">   94</span> </div>
<div class="line"><a name="l00095"></a><span class="lineno">   95</span>     <span class="comment">// encode the character</span></div>
<div class="line"><a name="l00096"></a><span class="lineno">   96</span>     <span class="keywordflow">if</span> ((input > 0x0010FFFF) || ((input >= 0xD800) && (input <= 0xDBFF)))</div>
<div class="line"><a name="l00097"></a><span class="lineno">   97</span>     {</div>
<div class="line"><a name="l00098"></a><span class="lineno">   98</span>         <span class="comment">// Invalid character</span></div>
<div class="line"><a name="l00099"></a><span class="lineno">   99</span>         <span class="keywordflow">if</span> (replacement)</div>
<div class="line"><a name="l00100"></a><span class="lineno">  100</span>             *output++ = replacement;</div>
<div class="line"><a name="l00101"></a><span class="lineno">  101</span>     }</div>
<div class="line"><a name="l00102"></a><span class="lineno">  102</span>     <span class="keywordflow">else</span></div>
<div class="line"><a name="l00103"></a><span class="lineno">  103</span>     {</div>
<div class="line"><a name="l00104"></a><span class="lineno">  104</span>         <span class="comment">// Valid character</span></div>
<div class="line"><a name="l00105"></a><span class="lineno">  105</span> </div>
<div class="line"><a name="l00106"></a><span class="lineno">  106</span>         <span class="comment">// Get the number of bytes to write</span></div>
<div class="line"><a name="l00107"></a><span class="lineno">  107</span>         std::size_t bytestoWrite = 1;</div>
<div class="line"><a name="l00108"></a><span class="lineno">  108</span>         <span class="keywordflow">if</span>      (input <  0x80)       bytestoWrite = 1;</div>
<div class="line"><a name="l00109"></a><span class="lineno">  109</span>         <span class="keywordflow">else</span> <span class="keywordflow">if</span> (input <  0x800)      bytestoWrite = 2;</div>
<div class="line"><a name="l00110"></a><span class="lineno">  110</span>         <span class="keywordflow">else</span> <span class="keywordflow">if</span> (input <  0x10000)    bytestoWrite = 3;</div>
<div class="line"><a name="l00111"></a><span class="lineno">  111</span>         <span class="keywordflow">else</span> <span class="keywordflow">if</span> (input <= 0x0010FFFF) bytestoWrite = 4;</div>
<div class="line"><a name="l00112"></a><span class="lineno">  112</span> </div>
<div class="line"><a name="l00113"></a><span class="lineno">  113</span>         <span class="comment">// Extract the bytes to write</span></div>
<div class="line"><a name="l00114"></a><span class="lineno">  114</span>         Uint8 bytes[4];</div>
<div class="line"><a name="l00115"></a><span class="lineno">  115</span>         <span class="keywordflow">switch</span> (bytestoWrite)</div>
<div class="line"><a name="l00116"></a><span class="lineno">  116</span>         {</div>
<div class="line"><a name="l00117"></a><span class="lineno">  117</span>             <span class="keywordflow">case</span> 4 : bytes[3] = <span class="keyword">static_cast<</span>Uint8<span class="keyword">></span>((input | 0x80) & 0xBF); input >>= 6;</div>
<div class="line"><a name="l00118"></a><span class="lineno">  118</span>             <span class="keywordflow">case</span> 3 : bytes[2] = <span class="keyword">static_cast<</span>Uint8<span class="keyword">></span>((input | 0x80) & 0xBF); input >>= 6;</div>
<div class="line"><a name="l00119"></a><span class="lineno">  119</span>             <span class="keywordflow">case</span> 2 : bytes[1] = <span class="keyword">static_cast<</span>Uint8<span class="keyword">></span>((input | 0x80) & 0xBF); input >>= 6;</div>
<div class="line"><a name="l00120"></a><span class="lineno">  120</span>             <span class="keywordflow">case</span> 1 : bytes[0] = <span class="keyword">static_cast<</span>Uint8<span class="keyword">></span> (input | firstBytes[bytestoWrite]);</div>
<div class="line"><a name="l00121"></a><span class="lineno">  121</span>         }</div>
<div class="line"><a name="l00122"></a><span class="lineno">  122</span> </div>
<div class="line"><a name="l00123"></a><span class="lineno">  123</span>         <span class="comment">// Add them to the output</span></div>
<div class="line"><a name="l00124"></a><span class="lineno">  124</span>         output = std::copy(bytes, bytes + bytestoWrite, output);</div>
<div class="line"><a name="l00125"></a><span class="lineno">  125</span>     }</div>
<div class="line"><a name="l00126"></a><span class="lineno">  126</span> </div>
<div class="line"><a name="l00127"></a><span class="lineno">  127</span>     <span class="keywordflow">return</span> output;</div>
<div class="line"><a name="l00128"></a><span class="lineno">  128</span> }</div>
<div class="line"><a name="l00129"></a><span class="lineno">  129</span> </div>
<div class="line"><a name="l00130"></a><span class="lineno">  130</span> </div>
<div class="line"><a name="l00132"></a><span class="lineno">  132</span> <span class="keyword">template</span> <<span class="keyword">typename</span> In></div>
<div class="line"><a name="l00133"></a><span class="lineno">  133</span> In <a class="code" href="classUtf.htm">Utf<8>::next</a>(In begin, In end)</div>
<div class="line"><a name="l00134"></a><span class="lineno">  134</span> {</div>
<div class="line"><a name="l00135"></a><span class="lineno">  135</span>     Uint32 codepoint;</div>
<div class="line"><a name="l00136"></a><span class="lineno">  136</span>     <span class="keywordflow">return</span> decode(begin, end, codepoint);</div>
<div class="line"><a name="l00137"></a><span class="lineno">  137</span> }</div>
<div class="line"><a name="l00138"></a><span class="lineno">  138</span> </div>
<div class="line"><a name="l00139"></a><span class="lineno">  139</span> </div>
<div class="line"><a name="l00141"></a><span class="lineno">  141</span> <span class="keyword">template</span> <<span class="keyword">typename</span> In></div>
<div class="line"><a name="l00142"></a><span class="lineno">  142</span> std::size_t <a class="code" href="classUtf.htm">Utf<8>::count</a>(In begin, In end)</div>
<div class="line"><a name="l00143"></a><span class="lineno">  143</span> {</div>
<div class="line"><a name="l00144"></a><span class="lineno">  144</span>     std::size_t length = 0;</div>
<div class="line"><a name="l00145"></a><span class="lineno">  145</span>     <span class="keywordflow">while</span> (begin < end)</div>
<div class="line"><a name="l00146"></a><span class="lineno">  146</span>     {</div>
<div class="line"><a name="l00147"></a><span class="lineno">  147</span>         begin = next(begin, end);</div>
<div class="line"><a name="l00148"></a><span class="lineno">  148</span>         ++length;</div>
<div class="line"><a name="l00149"></a><span class="lineno">  149</span>     }</div>
<div class="line"><a name="l00150"></a><span class="lineno">  150</span> </div>
<div class="line"><a name="l00151"></a><span class="lineno">  151</span>     <span class="keywordflow">return</span> length;</div>
<div class="line"><a name="l00152"></a><span class="lineno">  152</span> }</div>
<div class="line"><a name="l00153"></a><span class="lineno">  153</span> </div>
<div class="line"><a name="l00154"></a><span class="lineno">  154</span> </div>
<div class="line"><a name="l00156"></a><span class="lineno">  156</span> <span class="keyword">template</span> <<span class="keyword">typename</span> In, <span class="keyword">typename</span> Out></div>
<div class="line"><a name="l00157"></a><span class="lineno">  157</span> Out <a class="code" href="classUtf.htm">Utf<8>::fromAnsi</a>(In begin, In end, Out output, <span class="keyword">const</span> std::locale& locale)</div>
<div class="line"><a name="l00158"></a><span class="lineno">  158</span> {</div>
<div class="line"><a name="l00159"></a><span class="lineno">  159</span>     <span class="keywordflow">while</span> (begin < end)</div>
<div class="line"><a name="l00160"></a><span class="lineno">  160</span>     {</div>
<div class="line"><a name="l00161"></a><span class="lineno">  161</span>         Uint32 codepoint = <a class="code" href="classUtf.htm">Utf<32>::decodeAnsi</a>(*begin++, locale);</div>
<div class="line"><a name="l00162"></a><span class="lineno">  162</span>         output = encode(codepoint, output);</div>
<div class="line"><a name="l00163"></a><span class="lineno">  163</span>     }</div>
<div class="line"><a name="l00164"></a><span class="lineno">  164</span> </div>
<div class="line"><a name="l00165"></a><span class="lineno">  165</span>     <span class="keywordflow">return</span> output;</div>
<div class="line"><a name="l00166"></a><span class="lineno">  166</span> }</div>
<div class="line"><a name="l00167"></a><span class="lineno">  167</span> </div>
<div class="line"><a name="l00168"></a><span class="lineno">  168</span> </div>
<div class="line"><a name="l00170"></a><span class="lineno">  170</span> <span class="keyword">template</span> <<span class="keyword">typename</span> In, <span class="keyword">typename</span> Out></div>
<div class="line"><a name="l00171"></a><span class="lineno">  171</span> Out <a class="code" href="classUtf.htm">Utf<8>::fromWide</a>(In begin, In end, Out output)</div>
<div class="line"><a name="l00172"></a><span class="lineno">  172</span> {</div>
<div class="line"><a name="l00173"></a><span class="lineno">  173</span>     <span class="keywordflow">while</span> (begin < end)</div>
<div class="line"><a name="l00174"></a><span class="lineno">  174</span>     {</div>
<div class="line"><a name="l00175"></a><span class="lineno">  175</span>         Uint32 codepoint = <a class="code" href="classUtf.htm">Utf<32>::decodeWide</a>(*begin++);</div>
<div class="line"><a name="l00176"></a><span class="lineno">  176</span>         output = encode(codepoint, output);</div>
<div class="line"><a name="l00177"></a><span class="lineno">  177</span>     }</div>
<div class="line"><a name="l00178"></a><span class="lineno">  178</span> </div>
<div class="line"><a name="l00179"></a><span class="lineno">  179</span>     <span class="keywordflow">return</span> output;</div>
<div class="line"><a name="l00180"></a><span class="lineno">  180</span> }</div>
<div class="line"><a name="l00181"></a><span class="lineno">  181</span> </div>
<div class="line"><a name="l00182"></a><span class="lineno">  182</span> </div>
<div class="line"><a name="l00184"></a><span class="lineno">  184</span> <span class="keyword">template</span> <<span class="keyword">typename</span> In, <span class="keyword">typename</span> Out></div>
<div class="line"><a name="l00185"></a><span class="lineno">  185</span> Out <a class="code" href="classUtf.htm">Utf<8>::fromLatin1</a>(In begin, In end, Out output)</div>
<div class="line"><a name="l00186"></a><span class="lineno">  186</span> {</div>
<div class="line"><a name="l00187"></a><span class="lineno">  187</span>     <span class="comment">// Latin-1 is directly compatible with Unicode encodings,</span></div>
<div class="line"><a name="l00188"></a><span class="lineno">  188</span>     <span class="comment">// and can thus be treated as (a sub-range of) UTF-32</span></div>
<div class="line"><a name="l00189"></a><span class="lineno">  189</span>     <span class="keywordflow">while</span> (begin < end)</div>
<div class="line"><a name="l00190"></a><span class="lineno">  190</span>         output = encode(*begin++, output);</div>
<div class="line"><a name="l00191"></a><span class="lineno">  191</span> </div>
<div class="line"><a name="l00192"></a><span class="lineno">  192</span>     <span class="keywordflow">return</span> output;</div>
<div class="line"><a name="l00193"></a><span class="lineno">  193</span> }</div>
<div class="line"><a name="l00194"></a><span class="lineno">  194</span> </div>
<div class="line"><a name="l00195"></a><span class="lineno">  195</span> </div>
<div class="line"><a name="l00197"></a><span class="lineno">  197</span> <span class="keyword">template</span> <<span class="keyword">typename</span> In, <span class="keyword">typename</span> Out></div>
<div class="line"><a name="l00198"></a><span class="lineno">  198</span> Out <a class="code" href="classUtf.htm">Utf<8>::toAnsi</a>(In begin, In end, Out output, <span class="keywordtype">char</span> replacement, <span class="keyword">const</span> std::locale& locale)</div>
<div class="line"><a name="l00199"></a><span class="lineno">  199</span> {</div>
<div class="line"><a name="l00200"></a><span class="lineno">  200</span>     <span class="keywordflow">while</span> (begin < end)</div>
<div class="line"><a name="l00201"></a><span class="lineno">  201</span>     {</div>
<div class="line"><a name="l00202"></a><span class="lineno">  202</span>         Uint32 codepoint;</div>
<div class="line"><a name="l00203"></a><span class="lineno">  203</span>         begin = decode(begin, end, codepoint);</div>
<div class="line"><a name="l00204"></a><span class="lineno">  204</span>         output = <a class="code" href="classUtf.htm">Utf<32>::encodeAnsi</a>(codepoint, output, replacement, locale);</div>
<div class="line"><a name="l00205"></a><span class="lineno">  205</span>     }</div>
<div class="line"><a name="l00206"></a><span class="lineno">  206</span> </div>
<div class="line"><a name="l00207"></a><span class="lineno">  207</span>     <span class="keywordflow">return</span> output;</div>
<div class="line"><a name="l00208"></a><span class="lineno">  208</span> }</div>
<div class="line"><a name="l00209"></a><span class="lineno">  209</span> </div>
<div class="line"><a name="l00210"></a><span class="lineno">  210</span> </div>
<div class="line"><a name="l00212"></a><span class="lineno">  212</span> <span class="keyword">template</span> <<span class="keyword">typename</span> In, <span class="keyword">typename</span> Out></div>
<div class="line"><a name="l00213"></a><span class="lineno">  213</span> Out <a class="code" href="classUtf.htm">Utf<8>::toWide</a>(In begin, In end, Out output, <span class="keywordtype">wchar_t</span> replacement)</div>
<div class="line"><a name="l00214"></a><span class="lineno">  214</span> {</div>
<div class="line"><a name="l00215"></a><span class="lineno">  215</span>     <span class="keywordflow">while</span> (begin < end)</div>
<div class="line"><a name="l00216"></a><span class="lineno">  216</span>     {</div>
<div class="line"><a name="l00217"></a><span class="lineno">  217</span>         Uint32 codepoint;</div>
<div class="line"><a name="l00218"></a><span class="lineno">  218</span>         begin = decode(begin, end, codepoint);</div>
<div class="line"><a name="l00219"></a><span class="lineno">  219</span>         output = <a class="code" href="classUtf.htm">Utf<32>::encodeWide</a>(codepoint, output, replacement);</div>
<div class="line"><a name="l00220"></a><span class="lineno">  220</span>     }</div>
<div class="line"><a name="l00221"></a><span class="lineno">  221</span> </div>
<div class="line"><a name="l00222"></a><span class="lineno">  222</span>     <span class="keywordflow">return</span> output;</div>
<div class="line"><a name="l00223"></a><span class="lineno">  223</span> }</div>
<div class="line"><a name="l00224"></a><span class="lineno">  224</span> </div>
<div class="line"><a name="l00225"></a><span class="lineno">  225</span> </div>
<div class="line"><a name="l00227"></a><span class="lineno">  227</span> <span class="keyword">template</span> <<span class="keyword">typename</span> In, <span class="keyword">typename</span> Out></div>
<div class="line"><a name="l00228"></a><span class="lineno">  228</span> Out <a class="code" href="classUtf.htm">Utf<8>::toLatin1</a>(In begin, In end, Out output, <span class="keywordtype">char</span> replacement)</div>
<div class="line"><a name="l00229"></a><span class="lineno">  229</span> {</div>
<div class="line"><a name="l00230"></a><span class="lineno">  230</span>     <span class="comment">// Latin-1 is directly compatible with Unicode encodings,</span></div>
<div class="line"><a name="l00231"></a><span class="lineno">  231</span>     <span class="comment">// and can thus be treated as (a sub-range of) UTF-32</span></div>
<div class="line"><a name="l00232"></a><span class="lineno">  232</span>     <span class="keywordflow">while</span> (begin < end)</div>
<div class="line"><a name="l00233"></a><span class="lineno">  233</span>     {</div>
<div class="line"><a name="l00234"></a><span class="lineno">  234</span>         Uint32 codepoint;</div>
<div class="line"><a name="l00235"></a><span class="lineno">  235</span>         begin = decode(begin, end, codepoint);</div>
<div class="line"><a name="l00236"></a><span class="lineno">  236</span>         *output++ = codepoint < 256 ? static_cast<char>(codepoint) : replacement;</div>
<div class="line"><a name="l00237"></a><span class="lineno">  237</span>     }</div>
<div class="line"><a name="l00238"></a><span class="lineno">  238</span> </div>
<div class="line"><a name="l00239"></a><span class="lineno">  239</span>     <span class="keywordflow">return</span> output;</div>
<div class="line"><a name="l00240"></a><span class="lineno">  240</span> }</div>
<div class="line"><a name="l00241"></a><span class="lineno">  241</span> </div>
<div class="line"><a name="l00242"></a><span class="lineno">  242</span> </div>
<div class="line"><a name="l00244"></a><span class="lineno">  244</span> <span class="keyword">template</span> <<span class="keyword">typename</span> In, <span class="keyword">typename</span> Out></div>
<div class="line"><a name="l00245"></a><span class="lineno">  245</span> Out <a class="code" href="classUtf.htm">Utf<8>::toUtf8</a>(In begin, In end, Out output)</div>
<div class="line"><a name="l00246"></a><span class="lineno">  246</span> {</div>
<div class="line"><a name="l00247"></a><span class="lineno">  247</span>     <span class="keywordflow">return</span> std::copy(begin, end, output);</div>
<div class="line"><a name="l00248"></a><span class="lineno">  248</span> }</div>
<div class="line"><a name="l00249"></a><span class="lineno">  249</span> </div>
<div class="line"><a name="l00250"></a><span class="lineno">  250</span> </div>
<div class="line"><a name="l00252"></a><span class="lineno">  252</span> <span class="keyword">template</span> <<span class="keyword">typename</span> In, <span class="keyword">typename</span> Out></div>
<div class="line"><a name="l00253"></a><span class="lineno">  253</span> Out <a class="code" href="classUtf.htm">Utf<8>::toUtf16</a>(In begin, In end, Out output)</div>
<div class="line"><a name="l00254"></a><span class="lineno">  254</span> {</div>
<div class="line"><a name="l00255"></a><span class="lineno">  255</span>     <span class="keywordflow">while</span> (begin < end)</div>
<div class="line"><a name="l00256"></a><span class="lineno">  256</span>     {</div>
<div class="line"><a name="l00257"></a><span class="lineno">  257</span>         Uint32 codepoint;</div>
<div class="line"><a name="l00258"></a><span class="lineno">  258</span>         begin = decode(begin, end, codepoint);</div>
<div class="line"><a name="l00259"></a><span class="lineno">  259</span>         output = <a class="code" href="classUtf.htm">Utf<16>::encode</a>(codepoint, output);</div>
<div class="line"><a name="l00260"></a><span class="lineno">  260</span>     }</div>
<div class="line"><a name="l00261"></a><span class="lineno">  261</span> </div>
<div class="line"><a name="l00262"></a><span class="lineno">  262</span>     <span class="keywordflow">return</span> output;</div>
<div class="line"><a name="l00263"></a><span class="lineno">  263</span> }</div>
<div class="line"><a name="l00264"></a><span class="lineno">  264</span> </div>
<div class="line"><a name="l00265"></a><span class="lineno">  265</span> </div>
<div class="line"><a name="l00267"></a><span class="lineno">  267</span> <span class="keyword">template</span> <<span class="keyword">typename</span> In, <span class="keyword">typename</span> Out></div>
<div class="line"><a name="l00268"></a><span class="lineno">  268</span> Out <a class="code" href="classUtf.htm">Utf<8>::toUtf32</a>(In begin, In end, Out output)</div>
<div class="line"><a name="l00269"></a><span class="lineno">  269</span> {</div>
<div class="line"><a name="l00270"></a><span class="lineno">  270</span>     <span class="keywordflow">while</span> (begin < end)</div>
<div class="line"><a name="l00271"></a><span class="lineno">  271</span>     {</div>
<div class="line"><a name="l00272"></a><span class="lineno">  272</span>         Uint32 codepoint;</div>
<div class="line"><a name="l00273"></a><span class="lineno">  273</span>         begin = decode(begin, end, codepoint);</div>
<div class="line"><a name="l00274"></a><span class="lineno">  274</span>         *output++ = codepoint;</div>
<div class="line"><a name="l00275"></a><span class="lineno">  275</span>     }</div>
<div class="line"><a name="l00276"></a><span class="lineno">  276</span> </div>
<div class="line"><a name="l00277"></a><span class="lineno">  277</span>     <span class="keywordflow">return</span> output;</div>
<div class="line"><a name="l00278"></a><span class="lineno">  278</span> }</div>
<div class="line"><a name="l00279"></a><span class="lineno">  279</span> </div>
<div class="line"><a name="l00280"></a><span class="lineno">  280</span> </div>
<div class="line"><a name="l00282"></a><span class="lineno">  282</span> <span class="keyword">template</span> <<span class="keyword">typename</span> In></div>
<div class="line"><a name="l00283"></a><span class="lineno">  283</span> In <a class="code" href="classUtf.htm">Utf<16>::decode</a>(In begin, In end, Uint32& output, Uint32 replacement)</div>
<div class="line"><a name="l00284"></a><span class="lineno">  284</span> {</div>
<div class="line"><a name="l00285"></a><span class="lineno">  285</span>     Uint16 first = *begin++;</div>
<div class="line"><a name="l00286"></a><span class="lineno">  286</span> </div>
<div class="line"><a name="l00287"></a><span class="lineno">  287</span>     <span class="comment">// If it's a surrogate pair, first convert to a single UTF-32 character</span></div>
<div class="line"><a name="l00288"></a><span class="lineno">  288</span>     <span class="keywordflow">if</span> ((first >= 0xD800) && (first <= 0xDBFF))</div>
<div class="line"><a name="l00289"></a><span class="lineno">  289</span>     {</div>
<div class="line"><a name="l00290"></a><span class="lineno">  290</span>         <span class="keywordflow">if</span> (begin < end)</div>
<div class="line"><a name="l00291"></a><span class="lineno">  291</span>         {</div>
<div class="line"><a name="l00292"></a><span class="lineno">  292</span>             Uint32 second = *begin++;</div>
<div class="line"><a name="l00293"></a><span class="lineno">  293</span>             <span class="keywordflow">if</span> ((second >= 0xDC00) && (second <= 0xDFFF))</div>
<div class="line"><a name="l00294"></a><span class="lineno">  294</span>             {</div>
<div class="line"><a name="l00295"></a><span class="lineno">  295</span>                 <span class="comment">// The second element is valid: convert the two elements to a UTF-32 character</span></div>
<div class="line"><a name="l00296"></a><span class="lineno">  296</span>                 output = <span class="keyword">static_cast<</span>Uint32<span class="keyword">></span>(((first - 0xD800) << 10) + (second - 0xDC00) + 0x0010000);</div>
<div class="line"><a name="l00297"></a><span class="lineno">  297</span>             }</div>
<div class="line"><a name="l00298"></a><span class="lineno">  298</span>             <span class="keywordflow">else</span></div>
<div class="line"><a name="l00299"></a><span class="lineno">  299</span>             {</div>
<div class="line"><a name="l00300"></a><span class="lineno">  300</span>                 <span class="comment">// Invalid character</span></div>
<div class="line"><a name="l00301"></a><span class="lineno">  301</span>                 output = replacement;</div>
<div class="line"><a name="l00302"></a><span class="lineno">  302</span>             }</div>
<div class="line"><a name="l00303"></a><span class="lineno">  303</span>         }</div>
<div class="line"><a name="l00304"></a><span class="lineno">  304</span>         <span class="keywordflow">else</span></div>
<div class="line"><a name="l00305"></a><span class="lineno">  305</span>         {</div>
<div class="line"><a name="l00306"></a><span class="lineno">  306</span>             <span class="comment">// Invalid character</span></div>
<div class="line"><a name="l00307"></a><span class="lineno">  307</span>             begin = end;</div>
<div class="line"><a name="l00308"></a><span class="lineno">  308</span>             output = replacement;</div>
<div class="line"><a name="l00309"></a><span class="lineno">  309</span>         }</div>
<div class="line"><a name="l00310"></a><span class="lineno">  310</span>     }</div>
<div class="line"><a name="l00311"></a><span class="lineno">  311</span>     <span class="keywordflow">else</span></div>
<div class="line"><a name="l00312"></a><span class="lineno">  312</span>     {</div>
<div class="line"><a name="l00313"></a><span class="lineno">  313</span>         <span class="comment">// We can make a direct copy</span></div>
<div class="line"><a name="l00314"></a><span class="lineno">  314</span>         output = first;</div>
<div class="line"><a name="l00315"></a><span class="lineno">  315</span>     }</div>
<div class="line"><a name="l00316"></a><span class="lineno">  316</span> </div>
<div class="line"><a name="l00317"></a><span class="lineno">  317</span>     <span class="keywordflow">return</span> begin;</div>
<div class="line"><a name="l00318"></a><span class="lineno">  318</span> }</div>
<div class="line"><a name="l00319"></a><span class="lineno">  319</span> </div>
<div class="line"><a name="l00320"></a><span class="lineno">  320</span> </div>
<div class="line"><a name="l00322"></a><span class="lineno">  322</span> <span class="keyword">template</span> <<span class="keyword">typename</span> Out></div>
<div class="line"><a name="l00323"></a><span class="lineno">  323</span> Out <a class="code" href="classUtf.htm">Utf<16>::encode</a>(Uint32 input, Out output, Uint16 replacement)</div>
<div class="line"><a name="l00324"></a><span class="lineno">  324</span> {</div>
<div class="line"><a name="l00325"></a><span class="lineno">  325</span>     <span class="keywordflow">if</span> (input < 0xFFFF)</div>
<div class="line"><a name="l00326"></a><span class="lineno">  326</span>     {</div>
<div class="line"><a name="l00327"></a><span class="lineno">  327</span>         <span class="comment">// The character can be copied directly, we just need to check if it's in the valid range</span></div>
<div class="line"><a name="l00328"></a><span class="lineno">  328</span>         <span class="keywordflow">if</span> ((input >= 0xD800) && (input <= 0xDFFF))</div>
<div class="line"><a name="l00329"></a><span class="lineno">  329</span>         {</div>
<div class="line"><a name="l00330"></a><span class="lineno">  330</span>             <span class="comment">// Invalid character (this range is reserved)</span></div>
<div class="line"><a name="l00331"></a><span class="lineno">  331</span>             <span class="keywordflow">if</span> (replacement)</div>
<div class="line"><a name="l00332"></a><span class="lineno">  332</span>                 *output++ = replacement;</div>
<div class="line"><a name="l00333"></a><span class="lineno">  333</span>         }</div>
<div class="line"><a name="l00334"></a><span class="lineno">  334</span>         <span class="keywordflow">else</span></div>
<div class="line"><a name="l00335"></a><span class="lineno">  335</span>         {</div>
<div class="line"><a name="l00336"></a><span class="lineno">  336</span>             <span class="comment">// Valid character directly convertible to a single UTF-16 character</span></div>
<div class="line"><a name="l00337"></a><span class="lineno">  337</span>             *output++ = <span class="keyword">static_cast<</span>Uint16<span class="keyword">></span>(input);</div>
<div class="line"><a name="l00338"></a><span class="lineno">  338</span>         }</div>
<div class="line"><a name="l00339"></a><span class="lineno">  339</span>     }</div>
<div class="line"><a name="l00340"></a><span class="lineno">  340</span>     <span class="keywordflow">else</span> <span class="keywordflow">if</span> (input > 0x0010FFFF)</div>
<div class="line"><a name="l00341"></a><span class="lineno">  341</span>     {</div>
<div class="line"><a name="l00342"></a><span class="lineno">  342</span>         <span class="comment">// Invalid character (greater than the maximum unicode value)</span></div>
<div class="line"><a name="l00343"></a><span class="lineno">  343</span>         <span class="keywordflow">if</span> (replacement)</div>
<div class="line"><a name="l00344"></a><span class="lineno">  344</span>             *output++ = replacement;</div>
<div class="line"><a name="l00345"></a><span class="lineno">  345</span>     }</div>
<div class="line"><a name="l00346"></a><span class="lineno">  346</span>     <span class="keywordflow">else</span></div>
<div class="line"><a name="l00347"></a><span class="lineno">  347</span>     {</div>
<div class="line"><a name="l00348"></a><span class="lineno">  348</span>         <span class="comment">// The input character will be converted to two UTF-16 elements</span></div>
<div class="line"><a name="l00349"></a><span class="lineno">  349</span>         input -= 0x0010000;</div>
<div class="line"><a name="l00350"></a><span class="lineno">  350</span>         *output++ = <span class="keyword">static_cast<</span>Uint16<span class="keyword">></span>((input >> 10)     + 0xD800);</div>
<div class="line"><a name="l00351"></a><span class="lineno">  351</span>         *output++ = <span class="keyword">static_cast<</span>Uint16<span class="keyword">></span>((input & 0x3FFUL) + 0xDC00);</div>
<div class="line"><a name="l00352"></a><span class="lineno">  352</span>     }</div>
<div class="line"><a name="l00353"></a><span class="lineno">  353</span> </div>
<div class="line"><a name="l00354"></a><span class="lineno">  354</span>     <span class="keywordflow">return</span> output;</div>
<div class="line"><a name="l00355"></a><span class="lineno">  355</span> }</div>
<div class="line"><a name="l00356"></a><span class="lineno">  356</span> </div>
<div class="line"><a name="l00357"></a><span class="lineno">  357</span> </div>
<div class="line"><a name="l00359"></a><span class="lineno">  359</span> <span class="keyword">template</span> <<span class="keyword">typename</span> In></div>
<div class="line"><a name="l00360"></a><span class="lineno">  360</span> In <a class="code" href="classUtf.htm">Utf<16>::next</a>(In begin, In end)</div>
<div class="line"><a name="l00361"></a><span class="lineno">  361</span> {</div>
<div class="line"><a name="l00362"></a><span class="lineno">  362</span>     Uint32 codepoint;</div>
<div class="line"><a name="l00363"></a><span class="lineno">  363</span>     <span class="keywordflow">return</span> decode(begin, end, codepoint);</div>
<div class="line"><a name="l00364"></a><span class="lineno">  364</span> }</div>
<div class="line"><a name="l00365"></a><span class="lineno">  365</span> </div>
<div class="line"><a name="l00366"></a><span class="lineno">  366</span> </div>
<div class="line"><a name="l00368"></a><span class="lineno">  368</span> <span class="keyword">template</span> <<span class="keyword">typename</span> In></div>
<div class="line"><a name="l00369"></a><span class="lineno">  369</span> std::size_t <a class="code" href="classUtf.htm">Utf<16>::count</a>(In begin, In end)</div>
<div class="line"><a name="l00370"></a><span class="lineno">  370</span> {</div>
<div class="line"><a name="l00371"></a><span class="lineno">  371</span>     std::size_t length = 0;</div>
<div class="line"><a name="l00372"></a><span class="lineno">  372</span>     <span class="keywordflow">while</span> (begin < end)</div>
<div class="line"><a name="l00373"></a><span class="lineno">  373</span>     {</div>
<div class="line"><a name="l00374"></a><span class="lineno">  374</span>         begin = next(begin, end);</div>
<div class="line"><a name="l00375"></a><span class="lineno">  375</span>         ++length;</div>
<div class="line"><a name="l00376"></a><span class="lineno">  376</span>     }</div>
<div class="line"><a name="l00377"></a><span class="lineno">  377</span> </div>
<div class="line"><a name="l00378"></a><span class="lineno">  378</span>     <span class="keywordflow">return</span> length;</div>
<div class="line"><a name="l00379"></a><span class="lineno">  379</span> }</div>
<div class="line"><a name="l00380"></a><span class="lineno">  380</span> </div>
<div class="line"><a name="l00381"></a><span class="lineno">  381</span> </div>
<div class="line"><a name="l00383"></a><span class="lineno">  383</span> <span class="keyword">template</span> <<span class="keyword">typename</span> In, <span class="keyword">typename</span> Out></div>
<div class="line"><a name="l00384"></a><span class="lineno">  384</span> Out <a class="code" href="classUtf.htm">Utf<16>::fromAnsi</a>(In begin, In end, Out output, <span class="keyword">const</span> std::locale& locale)</div>
<div class="line"><a name="l00385"></a><span class="lineno">  385</span> {</div>
<div class="line"><a name="l00386"></a><span class="lineno">  386</span>     <span class="keywordflow">while</span> (begin < end)</div>
<div class="line"><a name="l00387"></a><span class="lineno">  387</span>     {</div>
<div class="line"><a name="l00388"></a><span class="lineno">  388</span>         Uint32 codepoint = <a class="code" href="classUtf.htm">Utf<32>::decodeAnsi</a>(*begin++, locale);</div>
<div class="line"><a name="l00389"></a><span class="lineno">  389</span>         output = encode(codepoint, output);</div>
<div class="line"><a name="l00390"></a><span class="lineno">  390</span>     }</div>
<div class="line"><a name="l00391"></a><span class="lineno">  391</span> </div>
<div class="line"><a name="l00392"></a><span class="lineno">  392</span>     <span class="keywordflow">return</span> output;</div>
<div class="line"><a name="l00393"></a><span class="lineno">  393</span> }</div>
<div class="line"><a name="l00394"></a><span class="lineno">  394</span> </div>
<div class="line"><a name="l00395"></a><span class="lineno">  395</span> </div>
<div class="line"><a name="l00397"></a><span class="lineno">  397</span> <span class="keyword">template</span> <<span class="keyword">typename</span> In, <span class="keyword">typename</span> Out></div>
<div class="line"><a name="l00398"></a><span class="lineno">  398</span> Out <a class="code" href="classUtf.htm">Utf<16>::fromWide</a>(In begin, In end, Out output)</div>
<div class="line"><a name="l00399"></a><span class="lineno">  399</span> {</div>
<div class="line"><a name="l00400"></a><span class="lineno">  400</span>     <span class="keywordflow">while</span> (begin < end)</div>
<div class="line"><a name="l00401"></a><span class="lineno">  401</span>     {</div>
<div class="line"><a name="l00402"></a><span class="lineno">  402</span>         Uint32 codepoint = <a class="code" href="classUtf.htm">Utf<32>::decodeWide</a>(*begin++);</div>
<div class="line"><a name="l00403"></a><span class="lineno">  403</span>         output = encode(codepoint, output);</div>
<div class="line"><a name="l00404"></a><span class="lineno">  404</span>     }</div>
<div class="line"><a name="l00405"></a><span class="lineno">  405</span> </div>
<div class="line"><a name="l00406"></a><span class="lineno">  406</span>     <span class="keywordflow">return</span> output;</div>
<div class="line"><a name="l00407"></a><span class="lineno">  407</span> }</div>
<div class="line"><a name="l00408"></a><span class="lineno">  408</span> </div>
<div class="line"><a name="l00409"></a><span class="lineno">  409</span> </div>
<div class="line"><a name="l00411"></a><span class="lineno">  411</span> <span class="keyword">template</span> <<span class="keyword">typename</span> In, <span class="keyword">typename</span> Out></div>
<div class="line"><a name="l00412"></a><span class="lineno">  412</span> Out <a class="code" href="classUtf.htm">Utf<16>::fromLatin1</a>(In begin, In end, Out output)</div>
<div class="line"><a name="l00413"></a><span class="lineno">  413</span> {</div>
<div class="line"><a name="l00414"></a><span class="lineno">  414</span>     <span class="comment">// Latin-1 is directly compatible with Unicode encodings,</span></div>
<div class="line"><a name="l00415"></a><span class="lineno">  415</span>     <span class="comment">// and can thus be treated as (a sub-range of) UTF-32</span></div>
<div class="line"><a name="l00416"></a><span class="lineno">  416</span>     <span class="keywordflow">return</span> std::copy(begin, end, output);</div>
<div class="line"><a name="l00417"></a><span class="lineno">  417</span> }</div>
<div class="line"><a name="l00418"></a><span class="lineno">  418</span> </div>
<div class="line"><a name="l00419"></a><span class="lineno">  419</span> </div>
<div class="line"><a name="l00421"></a><span class="lineno">  421</span> <span class="keyword">template</span> <<span class="keyword">typename</span> In, <span class="keyword">typename</span> Out></div>
<div class="line"><a name="l00422"></a><span class="lineno">  422</span> Out <a class="code" href="classUtf.htm">Utf<16>::toAnsi</a>(In begin, In end, Out output, <span class="keywordtype">char</span> replacement, <span class="keyword">const</span> std::locale& locale)</div>
<div class="line"><a name="l00423"></a><span class="lineno">  423</span> {</div>
<div class="line"><a name="l00424"></a><span class="lineno">  424</span>     <span class="keywordflow">while</span> (begin < end)</div>
<div class="line"><a name="l00425"></a><span class="lineno">  425</span>     {</div>
<div class="line"><a name="l00426"></a><span class="lineno">  426</span>         Uint32 codepoint;</div>
<div class="line"><a name="l00427"></a><span class="lineno">  427</span>         begin = decode(begin, end, codepoint);</div>
<div class="line"><a name="l00428"></a><span class="lineno">  428</span>         output = <a class="code" href="classUtf.htm">Utf<32>::encodeAnsi</a>(codepoint, output, replacement, locale);</div>
<div class="line"><a name="l00429"></a><span class="lineno">  429</span>     }</div>
<div class="line"><a name="l00430"></a><span class="lineno">  430</span> </div>
<div class="line"><a name="l00431"></a><span class="lineno">  431</span>     <span class="keywordflow">return</span> output;</div>
<div class="line"><a name="l00432"></a><span class="lineno">  432</span> }</div>
<div class="line"><a name="l00433"></a><span class="lineno">  433</span> </div>
<div class="line"><a name="l00434"></a><span class="lineno">  434</span> </div>
<div class="line"><a name="l00436"></a><span class="lineno">  436</span> <span class="keyword">template</span> <<span class="keyword">typename</span> In, <span class="keyword">typename</span> Out></div>
<div class="line"><a name="l00437"></a><span class="lineno">  437</span> Out <a class="code" href="classUtf.htm">Utf<16>::toWide</a>(In begin, In end, Out output, <span class="keywordtype">wchar_t</span> replacement)</div>
<div class="line"><a name="l00438"></a><span class="lineno">  438</span> {</div>
<div class="line"><a name="l00439"></a><span class="lineno">  439</span>     <span class="keywordflow">while</span> (begin < end)</div>
<div class="line"><a name="l00440"></a><span class="lineno">  440</span>     {</div>
<div class="line"><a name="l00441"></a><span class="lineno">  441</span>         Uint32 codepoint;</div>
<div class="line"><a name="l00442"></a><span class="lineno">  442</span>         begin = decode(begin, end, codepoint);</div>
<div class="line"><a name="l00443"></a><span class="lineno">  443</span>         output = <a class="code" href="classUtf.htm">Utf<32>::encodeWide</a>(codepoint, output, replacement);</div>
<div class="line"><a name="l00444"></a><span class="lineno">  444</span>     }</div>
<div class="line"><a name="l00445"></a><span class="lineno">  445</span> </div>
<div class="line"><a name="l00446"></a><span class="lineno">  446</span>     <span class="keywordflow">return</span> output;</div>
<div class="line"><a name="l00447"></a><span class="lineno">  447</span> }</div>
<div class="line"><a name="l00448"></a><span class="lineno">  448</span> </div>
<div class="line"><a name="l00449"></a><span class="lineno">  449</span> </div>
<div class="line"><a name="l00451"></a><span class="lineno">  451</span> <span class="keyword">template</span> <<span class="keyword">typename</span> In, <span class="keyword">typename</span> Out></div>
<div class="line"><a name="l00452"></a><span class="lineno">  452</span> Out <a class="code" href="classUtf.htm">Utf<16>::toLatin1</a>(In begin, In end, Out output, <span class="keywordtype">char</span> replacement)</div>
<div class="line"><a name="l00453"></a><span class="lineno">  453</span> {</div>
<div class="line"><a name="l00454"></a><span class="lineno">  454</span>     <span class="comment">// Latin-1 is directly compatible with Unicode encodings,</span></div>
<div class="line"><a name="l00455"></a><span class="lineno">  455</span>     <span class="comment">// and can thus be treated as (a sub-range of) UTF-32</span></div>
<div class="line"><a name="l00456"></a><span class="lineno">  456</span>     <span class="keywordflow">while</span> (begin < end)</div>
<div class="line"><a name="l00457"></a><span class="lineno">  457</span>     {</div>
<div class="line"><a name="l00458"></a><span class="lineno">  458</span>         *output++ = *begin < 256 ? static_cast<char>(*begin) : replacement;</div>
<div class="line"><a name="l00459"></a><span class="lineno">  459</span>         begin++;</div>
<div class="line"><a name="l00460"></a><span class="lineno">  460</span>     }</div>
<div class="line"><a name="l00461"></a><span class="lineno">  461</span> </div>
<div class="line"><a name="l00462"></a><span class="lineno">  462</span>     <span class="keywordflow">return</span> output;</div>
<div class="line"><a name="l00463"></a><span class="lineno">  463</span> }</div>
<div class="line"><a name="l00464"></a><span class="lineno">  464</span> </div>
<div class="line"><a name="l00465"></a><span class="lineno">  465</span> </div>
<div class="line"><a name="l00467"></a><span class="lineno">  467</span> <span class="keyword">template</span> <<span class="keyword">typename</span> In, <span class="keyword">typename</span> Out></div>
<div class="line"><a name="l00468"></a><span class="lineno">  468</span> Out <a class="code" href="classUtf.htm">Utf<16>::toUtf8</a>(In begin, In end, Out output)</div>
<div class="line"><a name="l00469"></a><span class="lineno">  469</span> {</div>
<div class="line"><a name="l00470"></a><span class="lineno">  470</span>     <span class="keywordflow">while</span> (begin < end)</div>
<div class="line"><a name="l00471"></a><span class="lineno">  471</span>     {</div>
<div class="line"><a name="l00472"></a><span class="lineno">  472</span>         Uint32 codepoint;</div>
<div class="line"><a name="l00473"></a><span class="lineno">  473</span>         begin = decode(begin, end, codepoint);</div>
<div class="line"><a name="l00474"></a><span class="lineno">  474</span>         output = <a class="code" href="classUtf.htm">Utf<8>::encode</a>(codepoint, output);</div>
<div class="line"><a name="l00475"></a><span class="lineno">  475</span>     }</div>
<div class="line"><a name="l00476"></a><span class="lineno">  476</span> </div>
<div class="line"><a name="l00477"></a><span class="lineno">  477</span>     <span class="keywordflow">return</span> output;</div>
<div class="line"><a name="l00478"></a><span class="lineno">  478</span> }</div>
<div class="line"><a name="l00479"></a><span class="lineno">  479</span> </div>
<div class="line"><a name="l00480"></a><span class="lineno">  480</span> </div>
<div class="line"><a name="l00482"></a><span class="lineno">  482</span> <span class="keyword">template</span> <<span class="keyword">typename</span> In, <span class="keyword">typename</span> Out></div>
<div class="line"><a name="l00483"></a><span class="lineno">  483</span> Out <a class="code" href="classUtf.htm">Utf<16>::toUtf16</a>(In begin, In end, Out output)</div>
<div class="line"><a name="l00484"></a><span class="lineno">  484</span> {</div>
<div class="line"><a name="l00485"></a><span class="lineno">  485</span>     <span class="keywordflow">return</span> std::copy(begin, end, output);</div>
<div class="line"><a name="l00486"></a><span class="lineno">  486</span> }</div>
<div class="line"><a name="l00487"></a><span class="lineno">  487</span> </div>
<div class="line"><a name="l00488"></a><span class="lineno">  488</span> </div>
<div class="line"><a name="l00490"></a><span class="lineno">  490</span> <span class="keyword">template</span> <<span class="keyword">typename</span> In, <span class="keyword">typename</span> Out></div>
<div class="line"><a name="l00491"></a><span class="lineno">  491</span> Out <a class="code" href="classUtf.htm">Utf<16>::toUtf32</a>(In begin, In end, Out output)</div>
<div class="line"><a name="l00492"></a><span class="lineno">  492</span> {</div>
<div class="line"><a name="l00493"></a><span class="lineno">  493</span>     <span class="keywordflow">while</span> (begin < end)</div>
<div class="line"><a name="l00494"></a><span class="lineno">  494</span>     {</div>
<div class="line"><a name="l00495"></a><span class="lineno">  495</span>         Uint32 codepoint;</div>
<div class="line"><a name="l00496"></a><span class="lineno">  496</span>         begin = decode(begin, end, codepoint);</div>
<div class="line"><a name="l00497"></a><span class="lineno">  497</span>         *output++ = codepoint;</div>
<div class="line"><a name="l00498"></a><span class="lineno">  498</span>     }</div>
<div class="line"><a name="l00499"></a><span class="lineno">  499</span> </div>
<div class="line"><a name="l00500"></a><span class="lineno">  500</span>     <span class="keywordflow">return</span> output;</div>
<div class="line"><a name="l00501"></a><span class="lineno">  501</span> }</div>
<div class="line"><a name="l00502"></a><span class="lineno">  502</span> </div>
<div class="line"><a name="l00503"></a><span class="lineno">  503</span> </div>
<div class="line"><a name="l00505"></a><span class="lineno">  505</span> <span class="keyword">template</span> <<span class="keyword">typename</span> In></div>
<div class="line"><a name="l00506"></a><span class="lineno">  506</span> In <a class="code" href="classUtf.htm">Utf<32>::decode</a>(In begin, In <span class="comment">/*end*/</span>, Uint32& output, Uint32 <span class="comment">/*replacement*/</span>)</div>
<div class="line"><a name="l00507"></a><span class="lineno">  507</span> {</div>
<div class="line"><a name="l00508"></a><span class="lineno">  508</span>     output = *begin++;</div>
<div class="line"><a name="l00509"></a><span class="lineno">  509</span>     <span class="keywordflow">return</span> begin;</div>
<div class="line"><a name="l00510"></a><span class="lineno">  510</span> }</div>
<div class="line"><a name="l00511"></a><span class="lineno">  511</span> </div>
<div class="line"><a name="l00512"></a><span class="lineno">  512</span> </div>
<div class="line"><a name="l00514"></a><span class="lineno">  514</span> <span class="keyword">template</span> <<span class="keyword">typename</span> Out></div>
<div class="line"><a name="l00515"></a><span class="lineno">  515</span> Out <a class="code" href="classUtf.htm">Utf<32>::encode</a>(Uint32 input, Out output, Uint32 <span class="comment">/*replacement*/</span>)</div>
<div class="line"><a name="l00516"></a><span class="lineno">  516</span> {</div>
<div class="line"><a name="l00517"></a><span class="lineno">  517</span>     *output++ = input;</div>
<div class="line"><a name="l00518"></a><span class="lineno">  518</span>     <span class="keywordflow">return</span> output;</div>
<div class="line"><a name="l00519"></a><span class="lineno">  519</span> }</div>
<div class="line"><a name="l00520"></a><span class="lineno">  520</span> </div>
<div class="line"><a name="l00521"></a><span class="lineno">  521</span> </div>
<div class="line"><a name="l00523"></a><span class="lineno">  523</span> <span class="keyword">template</span> <<span class="keyword">typename</span> In></div>
<div class="line"><a name="l00524"></a><span class="lineno">  524</span> In <a class="code" href="classUtf.htm">Utf<32>::next</a>(In begin, In <span class="comment">/*end*/</span>)</div>
<div class="line"><a name="l00525"></a><span class="lineno">  525</span> {</div>
<div class="line"><a name="l00526"></a><span class="lineno">  526</span>     <span class="keywordflow">return</span> ++begin;</div>
<div class="line"><a name="l00527"></a><span class="lineno">  527</span> }</div>
<div class="line"><a name="l00528"></a><span class="lineno">  528</span> </div>
<div class="line"><a name="l00529"></a><span class="lineno">  529</span> </div>
<div class="line"><a name="l00531"></a><span class="lineno">  531</span> <span class="keyword">template</span> <<span class="keyword">typename</span> In></div>
<div class="line"><a name="l00532"></a><span class="lineno">  532</span> std::size_t <a class="code" href="classUtf.htm">Utf<32>::count</a>(In begin, In end)</div>
<div class="line"><a name="l00533"></a><span class="lineno">  533</span> {</div>
<div class="line"><a name="l00534"></a><span class="lineno">  534</span>     <span class="keywordflow">return</span> begin - end;</div>
<div class="line"><a name="l00535"></a><span class="lineno">  535</span> }</div>
<div class="line"><a name="l00536"></a><span class="lineno">  536</span> </div>
<div class="line"><a name="l00537"></a><span class="lineno">  537</span> </div>
<div class="line"><a name="l00539"></a><span class="lineno">  539</span> <span class="keyword">template</span> <<span class="keyword">typename</span> In, <span class="keyword">typename</span> Out></div>
<div class="line"><a name="l00540"></a><span class="lineno">  540</span> Out <a class="code" href="classUtf.htm">Utf<32>::fromAnsi</a>(In begin, In end, Out output, <span class="keyword">const</span> std::locale& locale)</div>
<div class="line"><a name="l00541"></a><span class="lineno">  541</span> {</div>
<div class="line"><a name="l00542"></a><span class="lineno">  542</span>     <span class="keywordflow">while</span> (begin < end)</div>
<div class="line"><a name="l00543"></a><span class="lineno">  543</span>         *output++ = decodeAnsi(*begin++, locale);</div>
<div class="line"><a name="l00544"></a><span class="lineno">  544</span> </div>
<div class="line"><a name="l00545"></a><span class="lineno">  545</span>     <span class="keywordflow">return</span> output;</div>
<div class="line"><a name="l00546"></a><span class="lineno">  546</span> }</div>
<div class="line"><a name="l00547"></a><span class="lineno">  547</span> </div>
<div class="line"><a name="l00548"></a><span class="lineno">  548</span> </div>
<div class="line"><a name="l00550"></a><span class="lineno">  550</span> <span class="keyword">template</span> <<span class="keyword">typename</span> In, <span class="keyword">typename</span> Out></div>
<div class="line"><a name="l00551"></a><span class="lineno">  551</span> Out <a class="code" href="classUtf.htm">Utf<32>::fromWide</a>(In begin, In end, Out output)</div>
<div class="line"><a name="l00552"></a><span class="lineno">  552</span> {</div>
<div class="line"><a name="l00553"></a><span class="lineno">  553</span>     <span class="keywordflow">while</span> (begin < end)</div>
<div class="line"><a name="l00554"></a><span class="lineno">  554</span>         *output++ = decodeWide(*begin++);</div>
<div class="line"><a name="l00555"></a><span class="lineno">  555</span> </div>
<div class="line"><a name="l00556"></a><span class="lineno">  556</span>     <span class="keywordflow">return</span> output;</div>
<div class="line"><a name="l00557"></a><span class="lineno">  557</span> }</div>
<div class="line"><a name="l00558"></a><span class="lineno">  558</span> </div>
<div class="line"><a name="l00559"></a><span class="lineno">  559</span> </div>
<div class="line"><a name="l00561"></a><span class="lineno">  561</span> <span class="keyword">template</span> <<span class="keyword">typename</span> In, <span class="keyword">typename</span> Out></div>
<div class="line"><a name="l00562"></a><span class="lineno">  562</span> Out <a class="code" href="classUtf.htm">Utf<32>::fromLatin1</a>(In begin, In end, Out output)</div>
<div class="line"><a name="l00563"></a><span class="lineno">  563</span> {</div>
<div class="line"><a name="l00564"></a><span class="lineno">  564</span>     <span class="comment">// Latin-1 is directly compatible with Unicode encodings,</span></div>
<div class="line"><a name="l00565"></a><span class="lineno">  565</span>     <span class="comment">// and can thus be treated as (a sub-range of) UTF-32</span></div>
<div class="line"><a name="l00566"></a><span class="lineno">  566</span>     <span class="keywordflow">return</span> std::copy(begin, end, output);</div>
<div class="line"><a name="l00567"></a><span class="lineno">  567</span> }</div>
<div class="line"><a name="l00568"></a><span class="lineno">  568</span> </div>
<div class="line"><a name="l00569"></a><span class="lineno">  569</span> </div>
<div class="line"><a name="l00571"></a><span class="lineno">  571</span> <span class="keyword">template</span> <<span class="keyword">typename</span> In, <span class="keyword">typename</span> Out></div>
<div class="line"><a name="l00572"></a><span class="lineno">  572</span> Out <a class="code" href="classUtf.htm">Utf<32>::toAnsi</a>(In begin, In end, Out output, <span class="keywordtype">char</span> replacement, <span class="keyword">const</span> std::locale& locale)</div>
<div class="line"><a name="l00573"></a><span class="lineno">  573</span> {</div>
<div class="line"><a name="l00574"></a><span class="lineno">  574</span>     <span class="keywordflow">while</span> (begin < end)</div>
<div class="line"><a name="l00575"></a><span class="lineno">  575</span>         output = encodeAnsi(*begin++, output, replacement, locale);</div>
<div class="line"><a name="l00576"></a><span class="lineno">  576</span> </div>
<div class="line"><a name="l00577"></a><span class="lineno">  577</span>     <span class="keywordflow">return</span> output;</div>
<div class="line"><a name="l00578"></a><span class="lineno">  578</span> }</div>
<div class="line"><a name="l00579"></a><span class="lineno">  579</span> </div>
<div class="line"><a name="l00580"></a><span class="lineno">  580</span> </div>
<div class="line"><a name="l00582"></a><span class="lineno">  582</span> <span class="keyword">template</span> <<span class="keyword">typename</span> In, <span class="keyword">typename</span> Out></div>
<div class="line"><a name="l00583"></a><span class="lineno">  583</span> Out <a class="code" href="classUtf.htm">Utf<32>::toWide</a>(In begin, In end, Out output, <span class="keywordtype">wchar_t</span> replacement)</div>
<div class="line"><a name="l00584"></a><span class="lineno">  584</span> {</div>
<div class="line"><a name="l00585"></a><span class="lineno">  585</span>     <span class="keywordflow">while</span> (begin < end)</div>
<div class="line"><a name="l00586"></a><span class="lineno">  586</span>         output = encodeWide(*begin++, output, replacement);</div>
<div class="line"><a name="l00587"></a><span class="lineno">  587</span> </div>
<div class="line"><a name="l00588"></a><span class="lineno">  588</span>     <span class="keywordflow">return</span> output;</div>
<div class="line"><a name="l00589"></a><span class="lineno">  589</span> }</div>
<div class="line"><a name="l00590"></a><span class="lineno">  590</span> </div>
<div class="line"><a name="l00591"></a><span class="lineno">  591</span> </div>
<div class="line"><a name="l00593"></a><span class="lineno">  593</span> <span class="keyword">template</span> <<span class="keyword">typename</span> In, <span class="keyword">typename</span> Out></div>
<div class="line"><a name="l00594"></a><span class="lineno">  594</span> Out <a class="code" href="classUtf.htm">Utf<32>::toLatin1</a>(In begin, In end, Out output, <span class="keywordtype">char</span> replacement)</div>
<div class="line"><a name="l00595"></a><span class="lineno">  595</span> {</div>
<div class="line"><a name="l00596"></a><span class="lineno">  596</span>     <span class="comment">// Latin-1 is directly compatible with Unicode encodings,</span></div>
<div class="line"><a name="l00597"></a><span class="lineno">  597</span>     <span class="comment">// and can thus be treated as (a sub-range of) UTF-32</span></div>
<div class="line"><a name="l00598"></a><span class="lineno">  598</span>     <span class="keywordflow">while</span> (begin < end)</div>
<div class="line"><a name="l00599"></a><span class="lineno">  599</span>     {</div>
<div class="line"><a name="l00600"></a><span class="lineno">  600</span>         *output++ = *begin < 256 ? static_cast<char>(*begin) : replacement;</div>
<div class="line"><a name="l00601"></a><span class="lineno">  601</span>         begin++;</div>
<div class="line"><a name="l00602"></a><span class="lineno">  602</span>     }</div>
<div class="line"><a name="l00603"></a><span class="lineno">  603</span> </div>
<div class="line"><a name="l00604"></a><span class="lineno">  604</span>     <span class="keywordflow">return</span> output;</div>
<div class="line"><a name="l00605"></a><span class="lineno">  605</span> }</div>
<div class="line"><a name="l00606"></a><span class="lineno">  606</span> </div>
<div class="line"><a name="l00607"></a><span class="lineno">  607</span> </div>
<div class="line"><a name="l00609"></a><span class="lineno">  609</span> <span class="keyword">template</span> <<span class="keyword">typename</span> In, <span class="keyword">typename</span> Out></div>
<div class="line"><a name="l00610"></a><span class="lineno">  610</span> Out <a class="code" href="classUtf.htm">Utf<32>::toUtf8</a>(In begin, In end, Out output)</div>
<div class="line"><a name="l00611"></a><span class="lineno">  611</span> {</div>
<div class="line"><a name="l00612"></a><span class="lineno">  612</span>     <span class="keywordflow">while</span> (begin < end)</div>
<div class="line"><a name="l00613"></a><span class="lineno">  613</span>         output = <a class="code" href="classUtf.htm">Utf<8>::encode</a>(*begin++, output);</div>
<div class="line"><a name="l00614"></a><span class="lineno">  614</span> </div>
<div class="line"><a name="l00615"></a><span class="lineno">  615</span>     <span class="keywordflow">return</span> output;</div>
<div class="line"><a name="l00616"></a><span class="lineno">  616</span> }</div>
<div class="line"><a name="l00617"></a><span class="lineno">  617</span> </div>
<div class="line"><a name="l00619"></a><span class="lineno">  619</span> <span class="keyword">template</span> <<span class="keyword">typename</span> In, <span class="keyword">typename</span> Out></div>
<div class="line"><a name="l00620"></a><span class="lineno">  620</span> Out <a class="code" href="classUtf.htm">Utf<32>::toUtf16</a>(In begin, In end, Out output)</div>
<div class="line"><a name="l00621"></a><span class="lineno">  621</span> {</div>
<div class="line"><a name="l00622"></a><span class="lineno">  622</span>     <span class="keywordflow">while</span> (begin < end)</div>
<div class="line"><a name="l00623"></a><span class="lineno">  623</span>         output = <a class="code" href="classUtf.htm">Utf<16>::encode</a>(*begin++, output);</div>
<div class="line"><a name="l00624"></a><span class="lineno">  624</span> </div>
<div class="line"><a name="l00625"></a><span class="lineno">  625</span>     <span class="keywordflow">return</span> output;</div>
<div class="line"><a name="l00626"></a><span class="lineno">  626</span> }</div>
<div class="line"><a name="l00627"></a><span class="lineno">  627</span> </div>
<div class="line"><a name="l00628"></a><span class="lineno">  628</span> </div>
<div class="line"><a name="l00630"></a><span class="lineno">  630</span> <span class="keyword">template</span> <<span class="keyword">typename</span> In, <span class="keyword">typename</span> Out></div>
<div class="line"><a name="l00631"></a><span class="lineno">  631</span> Out <a class="code" href="classUtf.htm">Utf<32>::toUtf32</a>(In begin, In end, Out output)</div>
<div class="line"><a name="l00632"></a><span class="lineno">  632</span> {</div>
<div class="line"><a name="l00633"></a><span class="lineno">  633</span>     <span class="keywordflow">return</span> std::copy(begin, end, output);</div>
<div class="line"><a name="l00634"></a><span class="lineno">  634</span> }</div>
<div class="line"><a name="l00635"></a><span class="lineno">  635</span> </div>
<div class="line"><a name="l00636"></a><span class="lineno">  636</span> </div>
<div class="line"><a name="l00638"></a><span class="lineno">  638</span> <span class="keyword">template</span> <<span class="keyword">typename</span> In></div>
<div class="line"><a name="l00639"></a><span class="lineno">  639</span> Uint32 <a class="code" href="classUtf.htm">Utf<32>::decodeAnsi</a>(In input, <span class="keyword">const</span> std::locale& locale)</div>
<div class="line"><a name="l00640"></a><span class="lineno">  640</span> {</div>
<div class="line"><a name="l00641"></a><span class="lineno">  641</span>     <span class="comment">// On Windows, gcc's standard library (glibc++) has almost</span></div>
<div class="line"><a name="l00642"></a><span class="lineno">  642</span>     <span class="comment">// no support for Unicode stuff. As a consequence, in this</span></div>
<div class="line"><a name="l00643"></a><span class="lineno">  643</span>     <span class="comment">// context we can only use the default locale and ignore</span></div>
<div class="line"><a name="l00644"></a><span class="lineno">  644</span>     <span class="comment">// the one passed as parameter.</span></div>
<div class="line"><a name="l00645"></a><span class="lineno">  645</span> </div>
<div class="line"><a name="l00646"></a><span class="lineno">  646</span> <span class="preprocessor">    #if defined(SFML_SYSTEM_WINDOWS) &&                       </span><span class="comment">/* if Windows ... */</span><span class="preprocessor">                          \</span></div>
<div class="line"><a name="l00647"></a><span class="lineno">  647</span> <span class="preprocessor">       (defined(__GLIBCPP__) || defined (__GLIBCXX__)) &&     </span><span class="comment">/* ... and standard library is glibc++ ... */</span><span class="preprocessor"> \</span></div>
<div class="line"><a name="l00648"></a><span class="lineno">  648</span> <span class="preprocessor">      !(defined(__SGI_STL_PORT) || defined(_STLPORT_VERSION)) </span><span class="comment">/* ... and STLPort is not used on top of it */</span><span class="preprocessor"></span></div>
<div class="line"><a name="l00649"></a><span class="lineno">  649</span> <span class="preprocessor"></span></div>
<div class="line"><a name="l00650"></a><span class="lineno">  650</span>         (void)locale; <span class="comment">// to avoid warnings</span></div>
<div class="line"><a name="l00651"></a><span class="lineno">  651</span> </div>
<div class="line"><a name="l00652"></a><span class="lineno">  652</span>         <span class="keywordtype">wchar_t</span> character = 0;</div>
<div class="line"><a name="l00653"></a><span class="lineno">  653</span>         mbtowc(&character, &input, 1);</div>
<div class="line"><a name="l00654"></a><span class="lineno">  654</span>         <span class="keywordflow">return</span> <span class="keyword">static_cast<</span>Uint32<span class="keyword">></span>(character);</div>
<div class="line"><a name="l00655"></a><span class="lineno">  655</span> </div>
<div class="line"><a name="l00656"></a><span class="lineno">  656</span> <span class="preprocessor">    #else</span></div>
<div class="line"><a name="l00657"></a><span class="lineno">  657</span> <span class="preprocessor"></span></div>
<div class="line"><a name="l00658"></a><span class="lineno">  658</span>         <span class="comment">// Get the facet of the locale which deals with character conversion</span></div>
<div class="line"><a name="l00659"></a><span class="lineno">  659</span>         <span class="keyword">const</span> std::ctype<wchar_t>& facet = std::use_facet< std::ctype<wchar_t> >(locale);</div>
<div class="line"><a name="l00660"></a><span class="lineno">  660</span> </div>
<div class="line"><a name="l00661"></a><span class="lineno">  661</span>         <span class="comment">// Use the facet to convert each character of the input string</span></div>
<div class="line"><a name="l00662"></a><span class="lineno">  662</span>         <span class="keywordflow">return</span> <span class="keyword">static_cast<</span>Uint32<span class="keyword">></span>(facet.widen(input));</div>
<div class="line"><a name="l00663"></a><span class="lineno">  663</span> </div>
<div class="line"><a name="l00664"></a><span class="lineno">  664</span> <span class="preprocessor">    #endif</span></div>
<div class="line"><a name="l00665"></a><span class="lineno">  665</span> <span class="preprocessor"></span>}</div>
<div class="line"><a name="l00666"></a><span class="lineno">  666</span> </div>
<div class="line"><a name="l00667"></a><span class="lineno">  667</span> </div>
<div class="line"><a name="l00669"></a><span class="lineno">  669</span> <span class="keyword">template</span> <<span class="keyword">typename</span> In></div>
<div class="line"><a name="l00670"></a><span class="lineno">  670</span> Uint32 <a class="code" href="classUtf.htm">Utf<32>::decodeWide</a>(In input)</div>
<div class="line"><a name="l00671"></a><span class="lineno">  671</span> {</div>
<div class="line"><a name="l00672"></a><span class="lineno">  672</span>     <span class="comment">// The encoding of wide characters is not well defined and is left to the system;</span></div>
<div class="line"><a name="l00673"></a><span class="lineno">  673</span>     <span class="comment">// however we can safely assume that it is UCS-2 on Windows and</span></div>
<div class="line"><a name="l00674"></a><span class="lineno">  674</span>     <span class="comment">// UCS-4 on Unix systems.</span></div>
<div class="line"><a name="l00675"></a><span class="lineno">  675</span>     <span class="comment">// In both cases, a simple copy is enough (UCS-2 is a subset of UCS-4,</span></div>
<div class="line"><a name="l00676"></a><span class="lineno">  676</span>     <span class="comment">// and UCS-4 *is* UTF-32).</span></div>
<div class="line"><a name="l00677"></a><span class="lineno">  677</span> </div>
<div class="line"><a name="l00678"></a><span class="lineno">  678</span>     <span class="keywordflow">return</span> input;</div>
<div class="line"><a name="l00679"></a><span class="lineno">  679</span> }</div>
<div class="line"><a name="l00680"></a><span class="lineno">  680</span> </div>
<div class="line"><a name="l00681"></a><span class="lineno">  681</span> </div>
<div class="line"><a name="l00683"></a><span class="lineno">  683</span> <span class="keyword">template</span> <<span class="keyword">typename</span> Out></div>
<div class="line"><a name="l00684"></a><span class="lineno">  684</span> Out <a class="code" href="classUtf.htm">Utf<32>::encodeAnsi</a>(Uint32 codepoint, Out output, <span class="keywordtype">char</span> replacement, <span class="keyword">const</span> std::locale& locale)</div>
<div class="line"><a name="l00685"></a><span class="lineno">  685</span> {</div>
<div class="line"><a name="l00686"></a><span class="lineno">  686</span>     <span class="comment">// On Windows, gcc's standard library (glibc++) has almost</span></div>
<div class="line"><a name="l00687"></a><span class="lineno">  687</span>     <span class="comment">// no support for Unicode stuff. As a consequence, in this</span></div>
<div class="line"><a name="l00688"></a><span class="lineno">  688</span>     <span class="comment">// context we can only use the default locale and ignore</span></div>
<div class="line"><a name="l00689"></a><span class="lineno">  689</span>     <span class="comment">// the one passed as parameter.</span></div>
<div class="line"><a name="l00690"></a><span class="lineno">  690</span> </div>
<div class="line"><a name="l00691"></a><span class="lineno">  691</span> <span class="preprocessor">    #if defined(SFML_SYSTEM_WINDOWS) &&                       </span><span class="comment">/* if Windows ... */</span><span class="preprocessor">                          \</span></div>
<div class="line"><a name="l00692"></a><span class="lineno">  692</span> <span class="preprocessor">       (defined(__GLIBCPP__) || defined (__GLIBCXX__)) &&     </span><span class="comment">/* ... and standard library is glibc++ ... */</span><span class="preprocessor"> \</span></div>
<div class="line"><a name="l00693"></a><span class="lineno">  693</span> <span class="preprocessor">      !(defined(__SGI_STL_PORT) || defined(_STLPORT_VERSION)) </span><span class="comment">/* ... and STLPort is not used on top of it */</span><span class="preprocessor"></span></div>
<div class="line"><a name="l00694"></a><span class="lineno">  694</span> <span class="preprocessor"></span></div>
<div class="line"><a name="l00695"></a><span class="lineno">  695</span>         (void)locale; <span class="comment">// to avoid warnings</span></div>
<div class="line"><a name="l00696"></a><span class="lineno">  696</span> </div>
<div class="line"><a name="l00697"></a><span class="lineno">  697</span>         <span class="keywordtype">char</span> character = 0;</div>
<div class="line"><a name="l00698"></a><span class="lineno">  698</span>         <span class="keywordflow">if</span> (wctomb(&character, static_cast<wchar_t>(codepoint)) >= 0)</div>
<div class="line"><a name="l00699"></a><span class="lineno">  699</span>             *output++ = character;</div>
<div class="line"><a name="l00700"></a><span class="lineno">  700</span>         <span class="keywordflow">else</span> <span class="keywordflow">if</span> (replacement)</div>
<div class="line"><a name="l00701"></a><span class="lineno">  701</span>             *output++ = replacement;</div>
<div class="line"><a name="l00702"></a><span class="lineno">  702</span> </div>
<div class="line"><a name="l00703"></a><span class="lineno">  703</span>         <span class="keywordflow">return</span> output;</div>
<div class="line"><a name="l00704"></a><span class="lineno">  704</span> </div>
<div class="line"><a name="l00705"></a><span class="lineno">  705</span> <span class="preprocessor">    #else</span></div>
<div class="line"><a name="l00706"></a><span class="lineno">  706</span> <span class="preprocessor"></span></div>
<div class="line"><a name="l00707"></a><span class="lineno">  707</span>         <span class="comment">// Get the facet of the locale which deals with character conversion</span></div>
<div class="line"><a name="l00708"></a><span class="lineno">  708</span>         <span class="keyword">const</span> std::ctype<wchar_t>& facet = std::use_facet< std::ctype<wchar_t> >(locale);</div>
<div class="line"><a name="l00709"></a><span class="lineno">  709</span> </div>
<div class="line"><a name="l00710"></a><span class="lineno">  710</span>         <span class="comment">// Use the facet to convert each character of the input string</span></div>
<div class="line"><a name="l00711"></a><span class="lineno">  711</span>         *output++ = facet.narrow(static_cast<wchar_t>(codepoint), replacement);</div>
<div class="line"><a name="l00712"></a><span class="lineno">  712</span> </div>
<div class="line"><a name="l00713"></a><span class="lineno">  713</span>         <span class="keywordflow">return</span> output;</div>
<div class="line"><a name="l00714"></a><span class="lineno">  714</span> </div>
<div class="line"><a name="l00715"></a><span class="lineno">  715</span> <span class="preprocessor">    #endif</span></div>
<div class="line"><a name="l00716"></a><span class="lineno">  716</span> <span class="preprocessor"></span>}</div>
<div class="line"><a name="l00717"></a><span class="lineno">  717</span> </div>
<div class="line"><a name="l00718"></a><span class="lineno">  718</span> </div>
<div class="line"><a name="l00720"></a><span class="lineno">  720</span> <span class="keyword">template</span> <<span class="keyword">typename</span> Out></div>
<div class="line"><a name="l00721"></a><span class="lineno">  721</span> Out <a class="code" href="classUtf.htm">Utf<32>::encodeWide</a>(Uint32 codepoint, Out output, <span class="keywordtype">wchar_t</span> replacement)</div>
<div class="line"><a name="l00722"></a><span class="lineno">  722</span> {</div>
<div class="line"><a name="l00723"></a><span class="lineno">  723</span>     <span class="comment">// The encoding of wide characters is not well defined and is left to the system;</span></div>
<div class="line"><a name="l00724"></a><span class="lineno">  724</span>     <span class="comment">// however we can safely assume that it is UCS-2 on Windows and</span></div>
<div class="line"><a name="l00725"></a><span class="lineno">  725</span>     <span class="comment">// UCS-4 on Unix systems.</span></div>
<div class="line"><a name="l00726"></a><span class="lineno">  726</span>     <span class="comment">// For UCS-2 we need to check if the source characters fits in (UCS-2 is a subset of UCS-4).</span></div>
<div class="line"><a name="l00727"></a><span class="lineno">  727</span>     <span class="comment">// For UCS-4 we can do a direct copy (UCS-4 *is* UTF-32).</span></div>
<div class="line"><a name="l00728"></a><span class="lineno">  728</span> </div>
<div class="line"><a name="l00729"></a><span class="lineno">  729</span>     <span class="keywordflow">switch</span> (<span class="keyword">sizeof</span>(<span class="keywordtype">wchar_t</span>))</div>
<div class="line"><a name="l00730"></a><span class="lineno">  730</span>     {</div>
<div class="line"><a name="l00731"></a><span class="lineno">  731</span>         <span class="keywordflow">case</span> 4:</div>
<div class="line"><a name="l00732"></a><span class="lineno">  732</span>         {</div>
<div class="line"><a name="l00733"></a><span class="lineno">  733</span>             *output++ = <span class="keyword">static_cast<</span><span class="keywordtype">wchar_t</span><span class="keyword">></span>(codepoint);</div>
<div class="line"><a name="l00734"></a><span class="lineno">  734</span>             <span class="keywordflow">break</span>;</div>
<div class="line"><a name="l00735"></a><span class="lineno">  735</span>         }</div>
<div class="line"><a name="l00736"></a><span class="lineno">  736</span> </div>
<div class="line"><a name="l00737"></a><span class="lineno">  737</span>         <span class="keywordflow">default</span>:</div>
<div class="line"><a name="l00738"></a><span class="lineno">  738</span>         {</div>
<div class="line"><a name="l00739"></a><span class="lineno">  739</span>             <span class="keywordflow">if</span> ((codepoint <= 0xFFFF) && ((codepoint < 0xD800) || (codepoint > 0xDFFF)))</div>
<div class="line"><a name="l00740"></a><span class="lineno">  740</span>             {</div>
<div class="line"><a name="l00741"></a><span class="lineno">  741</span>                 *output++ = <span class="keyword">static_cast<</span><span class="keywordtype">wchar_t</span><span class="keyword">></span>(codepoint);</div>
<div class="line"><a name="l00742"></a><span class="lineno">  742</span>             }</div>
<div class="line"><a name="l00743"></a><span class="lineno">  743</span>             <span class="keywordflow">else</span> <span class="keywordflow">if</span> (replacement)</div>
<div class="line"><a name="l00744"></a><span class="lineno">  744</span>             {</div>
<div class="line"><a name="l00745"></a><span class="lineno">  745</span>                 *output++ = replacement;</div>
<div class="line"><a name="l00746"></a><span class="lineno">  746</span>             }</div>
<div class="line"><a name="l00747"></a><span class="lineno">  747</span>             <span class="keywordflow">break</span>;</div>
<div class="line"><a name="l00748"></a><span class="lineno">  748</span>         }</div>
<div class="line"><a name="l00749"></a><span class="lineno">  749</span>     }</div>
<div class="line"><a name="l00750"></a><span class="lineno">  750</span> </div>
<div class="line"><a name="l00751"></a><span class="lineno">  751</span>     <span class="keywordflow">return</span> output;</div>
<div class="line"><a name="l00752"></a><span class="lineno">  752</span> }</div>
</div><!-- fragment --></div><!-- contents -->
        </div>
        <div id="footer-container">
            <div id="footer">
                Copyright � Laurent Gomila  :: 
                Documentation generated by <a href="http://www.doxygen.org/" title="doxygen website">doxygen</a>  :: 
            </div>
        </div>
    <script>
  (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
  (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
  m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
  })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
 
  ga('create', 'UA-41898676-1', 'srchub.org');
  ga('send', 'pageview');
Page rendered in 1.64877s using 11 queries.
Source at commit tip created 11 years 11 months ago.
By Nathan Adams, Initial commit

Archive Download this file

Branches

Tags

Page rendered in 1.64877s using 11 queries.