path: root/devdocs/c/string%2Fwide.html

    <h1 id="firstHeading" class="firstHeading">Null-terminated wide strings</h1>            <p>A null-terminated wide string is a sequence of valid wide characters, ending with a null-character.</p>
<h3 id="Functions"> Functions</h3> <table class="t-dsc-begin"> <tr> <td colspan="2"> <h5 id="Character_classification">  Character classification </h5> </td>
</tr> <tr class="t-dsc-header"> <th colspan="2"> Defined in header <code>&lt;wctype.h&gt;</code>  </th>
</tr> <tr class="t-dsc"> <td> <div><a href="wide/iswalnum" title="c/string/wide/iswalnum"> <span class="t-lines"><span>iswalnum</span></span></a></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c95">(C95)</span></span></span></div> </td> <td> checks if a wide character is alphanumeric <br> <span class="t-mark">(function)</span>  </td>
</tr> <tr class="t-dsc"> <td> <div><a href="wide/iswalpha" title="c/string/wide/iswalpha"> <span class="t-lines"><span>iswalpha</span></span></a></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c95">(C95)</span></span></span></div> </td> <td> checks if a wide character is alphabetic <br> <span class="t-mark">(function)</span>  </td>
</tr> <tr class="t-dsc"> <td> <div><a href="wide/iswlower" title="c/string/wide/iswlower"> <span class="t-lines"><span>iswlower</span></span></a></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c95">(C95)</span></span></span></div> </td> <td> checks if a wide character is an lowercase character <br> <span class="t-mark">(function)</span>  </td>
</tr> <tr class="t-dsc"> <td> <div><a href="wide/iswupper" title="c/string/wide/iswupper"> <span class="t-lines"><span>iswupper</span></span></a></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c95">(C95)</span></span></span></div> </td> <td> checks if a wide character is an uppercase character <br> <span class="t-mark">(function)</span>  </td>
</tr> <tr class="t-dsc"> <td> <div><a href="wide/iswdigit" title="c/string/wide/iswdigit"> <span class="t-lines"><span>iswdigit</span></span></a></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c95">(C95)</span></span></span></div> </td> <td> checks if a wide character is a digit <br> <span class="t-mark">(function)</span>  </td>
</tr> <tr class="t-dsc"> <td> <div><a href="wide/iswxdigit" title="c/string/wide/iswxdigit"> <span class="t-lines"><span>iswxdigit</span></span></a></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c95">(C95)</span></span></span></div> </td> <td> checks if a wide character is a hexadecimal character <br> <span class="t-mark">(function)</span>  </td>
</tr> <tr class="t-dsc"> <td> <div><a href="wide/iswcntrl" title="c/string/wide/iswcntrl"> <span class="t-lines"><span>iswcntrl</span></span></a></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c95">(C95)</span></span></span></div> </td> <td> checks if a wide character is a control character <br> <span class="t-mark">(function)</span>  </td>
</tr> <tr class="t-dsc"> <td> <div><a href="wide/iswgraph" title="c/string/wide/iswgraph"> <span class="t-lines"><span>iswgraph</span></span></a></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c95">(C95)</span></span></span></div> </td> <td> checks if a wide character is a graphical character <br> <span class="t-mark">(function)</span>  </td>
</tr> <tr class="t-dsc"> <td> <div><a href="wide/iswspace" title="c/string/wide/iswspace"> <span class="t-lines"><span>iswspace</span></span></a></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c95">(C95)</span></span></span></div> </td> <td> checks if a wide character is a space character <br> <span class="t-mark">(function)</span>  </td>
</tr> <tr class="t-dsc"> <td> <div><a href="wide/iswblank" title="c/string/wide/iswblank"> <span class="t-lines"><span>iswblank</span></span></a></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c99">(C99)</span></span></span></div> </td> <td> checks if a wide character is a blank character <br> <span class="t-mark">(function)</span>  </td>
</tr> <tr class="t-dsc"> <td> <div><a href="wide/iswprint" title="c/string/wide/iswprint"> <span class="t-lines"><span>iswprint</span></span></a></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c95">(C95)</span></span></span></div> </td> <td> checks if a wide character is a printing character <br> <span class="t-mark">(function)</span>  </td>
</tr> <tr class="t-dsc"> <td> <div><a href="wide/iswpunct" title="c/string/wide/iswpunct"> <span class="t-lines"><span>iswpunct</span></span></a></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c95">(C95)</span></span></span></div> </td> <td> checks if a wide character is a punctuation character <br> <span class="t-mark">(function)</span>  </td>
</tr> <tr class="t-dsc"> <td> <div><a href="wide/iswctype" title="c/string/wide/iswctype"> <span class="t-lines"><span>iswctype</span></span></a></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c95">(C95)</span></span></span></div> </td> <td> classifies a wide character according to the specified <code><a href="../locale/lc_categories" title="c/locale/LC categories">LC_CTYPE</a></code> category <br> <span class="t-mark">(function)</span>  </td>
</tr> <tr class="t-dsc"> <td> <div><a href="wide/wctype" title="c/string/wide/wctype"> <span class="t-lines"><span>wctype</span></span></a></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c95">(C95)</span></span></span></div> </td> <td> looks up a character classification category in the current C locale <br> <span class="t-mark">(function)</span>  </td>
</tr> <tr> <td colspan="2"> <h5 id="Character_manipulation">  Character manipulation </h5> </td>
</tr> <tr class="t-dsc-header"> <th colspan="2"> Defined in header <code>&lt;wctype.h&gt;</code>  </th>
</tr> <tr class="t-dsc"> <td> <div><a href="wide/towlower" title="c/string/wide/towlower"> <span class="t-lines"><span>towlower</span></span></a></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c95">(C95)</span></span></span></div> </td> <td> converts a wide character to lowercase <br> <span class="t-mark">(function)</span>  </td>
</tr> <tr class="t-dsc"> <td> <div><a href="wide/towupper" title="c/string/wide/towupper"> <span class="t-lines"><span>towupper</span></span></a></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c95">(C95)</span></span></span></div> </td> <td> converts a wide character to uppercase <br> <span class="t-mark">(function)</span>  </td>
</tr> <tr class="t-dsc"> <td> <div><a href="wide/towctrans" title="c/string/wide/towctrans"> <span class="t-lines"><span>towctrans</span></span></a></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c95">(C95)</span></span></span></div> </td> <td> performs character mapping according to the specified LC_CTYPE mapping category <br> <span class="t-mark">(function)</span>  </td>
</tr> <tr class="t-dsc"> <td> <div><a href="wide/wctrans" title="c/string/wide/wctrans"> <span class="t-lines"><span>wctrans</span></span></a></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c95">(C95)</span></span></span></div> </td> <td> looks up a character mapping category in the current C locale <br> <span class="t-mark">(function)</span>  </td>
</tr> </table> <table class="wikitable"> <tr> <th colspan="3"> ASCII values </th> <th rowspan="2"> characters </th> <th rowspan="2"> <p><a href="byte/iscntrl" title="c/string/byte/iscntrl"><code>iscntrl</code></a><br> <a href="wide/iswcntrl" title="c/string/wide/iswcntrl"><code>iswcntrl</code></a></p>
</th> <th rowspan="2"> <p><a href="byte/isprint" title="c/string/byte/isprint"><code>isprint</code></a><br> <a href="wide/iswprint" title="c/string/wide/iswprint"><code>iswprint</code></a></p>
</th> <th rowspan="2"> <p><a href="byte/isspace" title="c/string/byte/isspace"><code>isspace</code></a><br> <a href="wide/iswspace" title="c/string/wide/iswspace"><code>iswspace</code></a></p>
</th> <th rowspan="2"> <p><a href="byte/isblank" title="c/string/byte/isblank"><code>isblank</code></a><br> <a href="wide/iswblank" title="c/string/wide/iswblank"><code>iswblank</code></a></p>
</th> <th rowspan="2"> <p><a href="byte/isgraph" title="c/string/byte/isgraph"><code>isgraph</code></a><br> <a href="wide/iswgraph" title="c/string/wide/iswgraph"><code>iswgraph</code></a></p>
</th> <th rowspan="2"> <p><a href="byte/ispunct" title="c/string/byte/ispunct"><code>ispunct</code></a> <br> <a href="wide/iswpunct" title="c/string/wide/iswpunct"><code>iswpunct</code></a></p>
</th> <th rowspan="2"> <p><a href="byte/isalnum" title="c/string/byte/isalnum"><code>isalnum</code></a> <br> <a href="wide/iswalnum" title="c/string/wide/iswalnum"><code>iswalnum</code></a></p>
</th> <th rowspan="2"> <p><a href="byte/isalpha" title="c/string/byte/isalpha"><code>isalpha</code></a> <br> <a href="wide/iswalpha" title="c/string/wide/iswalpha"><code>iswalpha</code></a></p>
</th> <th rowspan="2"> <p><a href="byte/isupper" title="c/string/byte/isupper"><code>isupper</code></a><br> <a href="wide/iswupper" title="c/string/wide/iswupper"><code>iswupper</code></a></p>
</th> <th rowspan="2"> <p><a href="byte/islower" title="c/string/byte/islower"><code>islower</code></a><br> <a href="wide/iswlower" title="c/string/wide/iswlower"><code>iswlower</code></a></p>
</th> <th rowspan="2"> <p><a href="byte/isdigit" title="c/string/byte/isdigit"><code>isdigit</code></a><br> <a href="wide/iswdigit" title="c/string/wide/iswdigit"><code>iswdigit</code></a></p>
</th> <th rowspan="2"> <p><a href="byte/isxdigit" title="c/string/byte/isxdigit"><code>isxdigit</code></a><br> <a href="wide/iswxdigit" title="c/string/wide/iswxdigit"><code>iswxdigit</code></a></p>
</th>
</tr> <tr> <th> decimal </th> <th> hexadecimal </th> <th> octal </th>
</tr> <tr> <td> 0–8 </td> <td> <code>\x0</code>–<code>\x8</code> </td> <td> <code>\0</code>–<code>\10</code> </td> <td> control codes (<code>NUL</code>, etc.) </td> <td class="table-yes">
<b><code>≠0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td>
</tr> <tr> <td> 9 </td> <td> <code>\x9</code> </td> <td> <code>\11</code> </td> <td> tab (<code>\t</code>) </td> <td class="table-yes">
<b><code>≠0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-yes">
<b><code>≠0</code></b> </td> <td class="table-yes">
<b><code>≠0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td>
</tr> <tr> <td> 10–13 </td> <td> <code>\xA</code>–<code>\xD</code> </td> <td> <code>\12</code>–<code>\15</code> </td> <td> whitespaces (<code>\n</code>, <code>\v</code>, <code>\f</code>, <code>\r</code>) </td> <td class="table-yes">
<b><code>≠0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-yes">
<b><code>≠0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td>
</tr> <tr> <td> 14–31 </td> <td> <code>\xE</code>–<code>\x1F</code> </td> <td> <code>\16</code>–<code>\37</code> </td> <td> control codes </td> <td class="table-yes">
<b><code>≠0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td>
</tr> <tr> <td> 32 </td> <td> <code>\x20</code> </td> <td> <code>\40</code> </td> <td> space </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-yes">
<b><code>≠0</code></b> </td> <td class="table-yes">
<b><code>≠0</code></b> </td> <td class="table-yes">
<b><code>≠0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td>
</tr> <tr> <td> 33–47 </td> <td> <code>\x21</code>–<code>\x2F</code> </td> <td> <code>\41</code>–<code>\57</code> </td> <td> <code>!"#$%&amp;'()*+,-./</code> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-yes">
<b><code>≠0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-yes">
<b><code>≠0</code></b> </td> <td class="table-yes">
<b><code>≠0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td>
</tr> <tr> <td> 48–57 </td> <td> <code>\x30</code>–<code>\x39</code> </td> <td> <code>\60</code>–<code>\71</code> </td> <td> <code>0123456789</code> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-yes">
<b><code>≠0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-yes">
<b><code>≠0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-yes">
<b><code>≠0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-yes">
<b><code>≠0</code></b> </td> <td class="table-yes">
<b><code>≠0</code></b> </td>
</tr> <tr> <td> 58–64 </td> <td> <code>\x3A</code>–<code>\x40</code> </td> <td> <code>\72</code>–<code>\100</code> </td> <td> <code>:;&lt;=&gt;?@</code> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-yes">
<b><code>≠0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-yes">
<b><code>≠0</code></b> </td> <td class="table-yes">
<b><code>≠0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td>
</tr> <tr> <td> 65–70 </td> <td> <code>\x41</code>–<code>\x46</code> </td> <td> <code>\101</code>–<code>\106</code> </td> <td> <code>ABCDEF</code> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-yes">
<b><code>≠0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-yes">
<b><code>≠0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-yes">
<b><code>≠0</code></b> </td> <td class="table-yes">
<b><code>≠0</code></b> </td> <td class="table-yes">
<b><code>≠0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-yes">
<b><code>≠0</code></b> </td>
</tr> <tr> <td> 71–90 </td> <td> <code>\x47</code>–<code>\x5A</code> </td> <td> <code>\107</code>–<code>\132</code> </td> <td> <code>GHIJKLMNOP</code><br><code>QRSTUVWXYZ</code> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-yes">
<b><code>≠0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-yes">
<b><code>≠0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-yes">
<b><code>≠0</code></b> </td> <td class="table-yes">
<b><code>≠0</code></b> </td> <td class="table-yes">
<b><code>≠0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td>
</tr> <tr> <td> 91–96 </td> <td> <code>\x5B</code>–<code>\x60</code> </td> <td> <code>\133</code>–<code>\140</code> </td> <td> <code>[\]^_`</code> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-yes">
<b><code>≠0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-yes">
<b><code>≠0</code></b> </td> <td class="table-yes">
<b><code>≠0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td>
</tr> <tr> <td> 97–102 </td> <td> <code>\x61</code>–<code>\x66</code> </td> <td> <code>\141</code>–<code>\146</code> </td> <td> <code>abcdef</code> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-yes">
<b><code>≠0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-yes">
<b><code>≠0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-yes">
<b><code>≠0</code></b> </td> <td class="table-yes">
<b><code>≠0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-yes">
<b><code>≠0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-yes">
<b><code>≠0</code></b> </td>
</tr> <tr> <td> 103–122 </td> <td> <code>\x67</code>–<code>\x7A</code> </td> <td> <code>\147</code>–<code>\172</code> </td> <td> <code>ghijklmnop</code><br><code>qrstuvwxyz</code> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-yes">
<b><code>≠0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-yes">
<b><code>≠0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-yes">
<b><code>≠0</code></b> </td> <td class="table-yes">
<b><code>≠0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-yes">
<b><code>≠0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td>
</tr> <tr> <td> 123–126 </td> <td> <code>\x7B</code>–<code>\x7E</code> </td> <td> <code>\172</code>–<code>\176</code> </td> <td> <code>{|}~</code> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-yes">
<b><code>≠0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-yes">
<b><code>≠0</code></b> </td> <td class="table-yes">
<b><code>≠0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td>
</tr> <tr> <td> 127 </td> <td> <code>\x7F</code> </td> <td> <code>\177</code> </td> <td> backspace character (<code>DEL</code>) </td> <td class="table-yes">
<b><code>≠0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td> <td class="table-no"> <b><code>0</code></b> </td>
</tr>
</table> <table class="t-dsc-begin"> <tr> <td colspan="2"> <h5 id="Conversions_to_numeric_formats">  Conversions to numeric formats </h5> </td>
</tr> <tr class="t-dsc-header"> <th colspan="2"> Defined in header <code>&lt;wchar.h&gt;</code>  </th>
</tr> <tr class="t-dsc"> <td> <div><a href="wide/wcstol" title="c/string/wide/wcstol"> <span class="t-lines"><span>wcstol</span><span>wcstoll</span></span></a></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c95">(C95)</span></span><span><span class="t-mark-rev t-since-c99">(C99)</span></span></span></div> </td> <td> converts a wide string to an integer value <br> <span class="t-mark">(function)</span>  </td>
</tr> <tr class="t-dsc"> <td> <div><a href="wide/wcstoul" title="c/string/wide/wcstoul"> <span class="t-lines"><span>wcstoul</span><span>wcstoull</span></span></a></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c95">(C95)</span></span><span><span class="t-mark-rev t-since-c99">(C99)</span></span></span></div> </td> <td> converts a wide string to an unsigned integer value <br> <span class="t-mark">(function)</span>  </td>
</tr> <tr class="t-dsc"> <td> <div><a href="wide/wcstof" title="c/string/wide/wcstof"> <span class="t-lines"><span>wcstof</span><span>wcstod</span><span>wcstold</span></span></a></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c99">(C99)</span></span><span><span class="t-mark-rev t-since-c95">(C95)</span></span><span><span class="t-mark-rev t-since-c99">(C99)</span></span></span></div> </td> <td> converts a wide string to a floating-point value <br> <span class="t-mark">(function)</span>  </td>
</tr> <tr class="t-dsc-header"> <th colspan="2"> Defined in header <code>&lt;inttypes.h&gt;</code>  </th>
</tr> <tr class="t-dsc"> <td> <div><a href="wide/wcstoimax" title="c/string/wide/wcstoimax"> <span class="t-lines"><span>wcstoimax</span><span>wcstoumax</span></span></a></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c99">(C99)</span></span><span><span class="t-mark-rev t-since-c99">(C99)</span></span></span></div> </td> <td> converts a wide string to <code><a href="http://en.cppreference.com/w/c/types/integer"><span class="kw118">intmax_t</span></a></code> or <code><a href="http://en.cppreference.com/w/c/types/integer"><span class="kw132">uintmax_t</span></a></code> <br> <span class="t-mark">(function)</span>  </td>
</tr> </table> <table class="t-dsc-begin"> <tr> <td colspan="2"> <h5 id="String_manipulation">  String manipulation </h5> </td>
</tr> <tr class="t-dsc-header"> <th colspan="2"> Defined in header <code>&lt;wchar.h&gt;</code>  </th>
</tr> <tr class="t-dsc"> <td> <div><a href="wide/wcscpy" title="c/string/wide/wcscpy"> <span class="t-lines"><span>wcscpy</span><span>wcscpy_s</span></span></a></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c95">(C95)</span></span><span><span class="t-mark-rev t-since-c11">(C11)</span></span></span></div> </td> <td> copies one wide string to another <br> <span class="t-mark">(function)</span>  </td>
</tr> <tr class="t-dsc"> <td> <div><a href="wide/wcsncpy" title="c/string/wide/wcsncpy"> <span class="t-lines"><span>wcsncpy</span><span>wcsncpy_s</span></span></a></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c95">(C95)</span></span><span><span class="t-mark-rev t-since-c11">(C11)</span></span></span></div> </td> <td> copies a certain amount of wide characters from one string to another <br> <span class="t-mark">(function)</span>  </td>
</tr> <tr class="t-dsc"> <td> <div><a href="wide/wcscat" title="c/string/wide/wcscat"> <span class="t-lines"><span>wcscat</span><span>wcscat_s</span></span></a></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c95">(C95)</span></span><span><span class="t-mark-rev t-since-c11">(C11)</span></span></span></div> </td> <td> appends a copy of one wide string to another <br> <span class="t-mark">(function)</span>  </td>
</tr> <tr class="t-dsc"> <td> <div><a href="wide/wcsncat" title="c/string/wide/wcsncat"> <span class="t-lines"><span>wcsncat</span><span>wcsncat_s</span></span></a></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c95">(C95)</span></span><span><span class="t-mark-rev t-since-c11">(C11)</span></span></span></div> </td> <td> appends a certain amount of wide characters from one wide string to another <br> <span class="t-mark">(function)</span>  </td>
</tr> <tr class="t-dsc"> <td> <div><a href="wide/wcsxfrm" title="c/string/wide/wcsxfrm"> <span class="t-lines"><span>wcsxfrm</span></span></a></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c95">(C95)</span></span></span></div> </td> <td> transform a wide string so that wcscmp would produce the same result as wcscoll <br> <span class="t-mark">(function)</span>  </td>
</tr> <tr> <td colspan="2"> <h5 id="String_examination">  String examination </h5> </td>
</tr> <tr class="t-dsc-header"> <th colspan="2"> Defined in header <code>&lt;wchar.h&gt;</code>  </th>
</tr> <tr class="t-dsc"> <td> <div><a href="wide/wcslen" title="c/string/wide/wcslen"> <span class="t-lines"><span>wcslen</span><span>wcsnlen_s</span></span></a></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c95">(C95)</span></span><span><span class="t-mark-rev t-since-c11">(C11)</span></span></span></div> </td> <td> returns the length of a wide string <br> <span class="t-mark">(function)</span>  </td>
</tr> <tr class="t-dsc"> <td> <div><a href="wide/wcscmp" title="c/string/wide/wcscmp"> <span class="t-lines"><span>wcscmp</span></span></a></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c95">(C95)</span></span></span></div> </td> <td> compares two wide strings <br> <span class="t-mark">(function)</span>  </td>
</tr> <tr class="t-dsc"> <td> <div><a href="wide/wcsncmp" title="c/string/wide/wcsncmp"> <span class="t-lines"><span>wcsncmp</span></span></a></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c95">(C95)</span></span></span></div> </td> <td> compares a certain amount of characters from two wide strings <br> <span class="t-mark">(function)</span>  </td>
</tr> <tr class="t-dsc"> <td> <div><a href="wide/wcscoll" title="c/string/wide/wcscoll"> <span class="t-lines"><span>wcscoll</span></span></a></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c95">(C95)</span></span></span></div> </td> <td> compares two wide strings in accordance to the current locale <br> <span class="t-mark">(function)</span>  </td>
</tr> <tr class="t-dsc"> <td> <div><a href="wide/wcschr" title="c/string/wide/wcschr"> <span class="t-lines"><span>wcschr</span></span></a></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c95">(C95)</span></span></span></div> </td> <td> finds the first occurrence of a wide character in a wide string <br> <span class="t-mark">(function)</span>  </td>
</tr> <tr class="t-dsc"> <td> <div><a href="wide/wcsrchr" title="c/string/wide/wcsrchr"> <span class="t-lines"><span>wcsrchr</span></span></a></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c95">(C95)</span></span></span></div> </td> <td> finds the last occurrence of a wide character in a wide string <br> <span class="t-mark">(function)</span>  </td>
</tr> <tr class="t-dsc"> <td> <div><a href="wide/wcsspn" title="c/string/wide/wcsspn"> <span class="t-lines"><span>wcsspn</span></span></a></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c95">(C95)</span></span></span></div> </td> <td> returns the length of the maximum initial segment that consists <br> of only the wide characters found in another wide string <br> <span class="t-mark">(function)</span>  </td>
</tr> <tr class="t-dsc"> <td> <div><a href="wide/wcscspn" title="c/string/wide/wcscspn"> <span class="t-lines"><span>wcscspn</span></span></a></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c95">(C95)</span></span></span></div> </td> <td> returns the length of the maximum initial segment that consists <br> of only the wide chars <i>not</i> found in another wide string <br> <span class="t-mark">(function)</span>  </td>
</tr> <tr class="t-dsc"> <td> <div><a href="wide/wcspbrk" title="c/string/wide/wcspbrk"> <span class="t-lines"><span>wcspbrk</span></span></a></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c95">(C95)</span></span></span></div> </td> <td> finds the first location of any wide character in one wide string, in another wide string <br> <span class="t-mark">(function)</span>  </td>
</tr> <tr class="t-dsc"> <td> <div><a href="wide/wcsstr" title="c/string/wide/wcsstr"> <span class="t-lines"><span>wcsstr</span></span></a></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c95">(C95)</span></span></span></div> </td> <td> finds the first occurrence of a wide string within another wide string <br> <span class="t-mark">(function)</span>  </td>
</tr> <tr class="t-dsc"> <td> <div><a href="wide/wcstok" title="c/string/wide/wcstok"> <span class="t-lines"><span>wcstok</span><span>wcstok_s</span></span></a></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c95">(C95)</span></span><span><span class="t-mark-rev t-since-c11">(C11)</span></span></span></div> </td> <td> finds the next token in a wide string <br> <span class="t-mark">(function)</span>  </td>
</tr> </table> <table class="t-dsc-begin"> <tr> <td colspan="2"> <h5 id="Wide_character_array_manipulation">  Wide character array manipulation </h5> </td>
</tr> <tr class="t-dsc-header"> <th colspan="2"> Defined in header <code>&lt;wchar.h&gt;</code>  </th>
</tr> <tr class="t-dsc"> <td> <div><a href="wide/wmemcpy" title="c/string/wide/wmemcpy"> <span class="t-lines"><span>wmemcpy</span><span>wmemcpy_s</span></span></a></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c95">(C95)</span></span><span><span class="t-mark-rev t-since-c11">(C11)</span></span></span></div> </td> <td> copies a certain amount of wide characters between two non-overlapping arrays <br> <span class="t-mark">(function)</span>  </td>
</tr> <tr class="t-dsc"> <td> <div><a href="wide/wmemmove" title="c/string/wide/wmemmove"> <span class="t-lines"><span>wmemmove</span><span>wmemmove_s</span></span></a></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c95">(C95)</span></span><span><span class="t-mark-rev t-since-c11">(C11)</span></span></span></div> </td> <td> copies a certain amount of wide characters between two, possibly overlapping, arrays <br> <span class="t-mark">(function)</span>  </td>
</tr> <tr class="t-dsc"> <td> <div><a href="wide/wmemcmp" title="c/string/wide/wmemcmp"> <span class="t-lines"><span>wmemcmp</span></span></a></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c95">(C95)</span></span></span></div> </td> <td> compares a certain amount of wide characters from two arrays <br> <span class="t-mark">(function)</span>  </td>
</tr> <tr class="t-dsc"> <td> <div><a href="wide/wmemchr" title="c/string/wide/wmemchr"> <span class="t-lines"><span>wmemchr</span></span></a></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c95">(C95)</span></span></span></div> </td> <td> finds the first occurrence of a wide character in a wide character array <br> <span class="t-mark">(function)</span>  </td>
</tr> <tr class="t-dsc"> <td> <div><a href="wide/wmemset" title="c/string/wide/wmemset"> <span class="t-lines"><span>wmemset</span></span></a></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c95">(C95)</span></span></span></div> </td> <td> copies the given wide character to every position in a wide character array <br> <span class="t-mark">(function)</span>  </td>
</tr> </table> <h3 id="Types"> Types</h3> <table class="t-dsc-begin"> <tr class="t-dsc-header"> <th colspan="2"> Defined in header <code>&lt;stddef.h&gt;</code>  </th>
</tr> <tr class="t-dsc-header"> <th colspan="2"> Defined in header <code>&lt;stdlib.h&gt;</code>  </th>
</tr> <tr class="t-dsc-header"> <th colspan="2"> Defined in header <code>&lt;wchar.h&gt;</code>  </th>
</tr> <tr class="t-dsc"> <td> <div><span class="t-lines"><span>wchar_t</span></span></div> </td> <td> integer type that can hold any valid wide character <br> <span class="t-mark">(typedef)</span> </td>
</tr> <tr class="t-dsc-header"> <th colspan="2"> Defined in header <code>&lt;wchar.h&gt;</code>  </th>
</tr> <tr class="t-dsc-header"> <th colspan="2"> Defined in header <code>&lt;wctype.h&gt;</code>  </th>
</tr> <tr class="t-dsc"> <td> <div><span class="t-lines"><span>wint_t</span></span></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c95">(C95)</span></span></span></div> </td> <td> integer type that can hold any valid wide character and at least one more value <br> <span class="t-mark">(typedef)</span> </td>
</tr> <tr class="t-dsc-header"> <th colspan="2"> Defined in header <code>&lt;wctype.h&gt;</code>  </th>
</tr> <tr class="t-dsc"> <td> <div><span class="t-lines"><span>wctrans_t</span></span></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c95">(C95)</span></span></span></div> </td> <td> scalar type that holds locale-specific character mapping <br> <span class="t-mark">(typedef)</span> </td>
</tr> <tr class="t-dsc"> <td> <div><span class="t-lines"><span>wctype_t</span></span></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c95">(C95)</span></span></span></div> </td> <td> scalar type that holds locale-specific character classification <br> <span class="t-mark">(typedef)</span> </td>
</tr> </table> <h3 id="Macros"> Macros</h3> <table class="t-dsc-begin"> <tr class="t-dsc-header"> <th colspan="2"> Defined in header <code>&lt;wchar.h&gt;</code>  </th>
</tr> <tr class="t-dsc-header"> <th colspan="2"> Defined in header <code>&lt;wctype.h&gt;</code>  </th>
</tr> <tr class="t-dsc"> <td> <div><span class="t-lines"><span>WEOF</span></span></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c95">(C95)</span></span></span></div> </td> <td> a non-character value of type wint_t used to indicate errors <br> <span class="t-mark">(macro constant)</span> </td>
</tr> <tr class="t-dsc-header"> <th colspan="2"> Defined in header <code>&lt;wchar.h&gt;</code>  </th>
</tr> <tr class="t-dsc-header"> <th colspan="2"> Defined in header <code>&lt;stdint.h&gt;</code>  </th>
</tr> <tr class="t-dsc"> <td> <div><span class="t-lines"><span>WCHAR_MIN</span></span></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c95">(C95)</span></span></span></div> </td> <td> the smallest valid value of wchar_t <br> <span class="t-mark">(macro constant)</span> </td>
</tr> <tr class="t-dsc"> <td> <div><span class="t-lines"><span>WCHAR_MAX</span></span></div>
<div><span class="t-lines"><span><span class="t-mark-rev t-since-c95">(C95)</span></span></span></div> </td> <td> the largest valid value of wchar_t <br> <span class="t-mark">(macro constant)</span> </td>
</tr> </table> <h3 id="References"> References</h3>  <ul>
<li> C11 standard (ISO/IEC 9899:2011): </li>
<ul>
<li> 7.19 Common definitions &lt;stddef.h&gt; (p: 288) </li>
<li> 7.29 Extended multibyte and wide character utilities &lt;wchar.h&gt; (p: 402-446) </li>
<li> 7.30 Wide character classification and mapping utilities &lt;wctype.h&gt; (p: 447-454) </li>
<li> 7.31.16 Extended multibyte and wide character utilities &lt;wchar.h&gt; (p: 456) </li>
<li> 7.31.17 Wide character classification and mapping utilities &lt;wctype.h&gt; (p: 457) </li>
<li> K.3.3 Common definitions &lt;stddef.h&gt; (p: 585) </li>
<li> K.3.9 Extended multibyte and wide character utilities &lt;wchar.h&gt; (p: 627-651) </li>
</ul>
<li> C99 standard (ISO/IEC 9899:1999): </li>
<ul>
<li> 7.17 Common definitions &lt;stddef.h&gt; (p: 254) </li>
<li> 7.24 Extended multibyte and wide character utilities &lt;wchar.h&gt; (p: 348-392) </li>
<li> 7.25 Wide character classification and mapping utilities &lt;wctype.h&gt; (p: 393-400) </li>
<li> 7.26.12 Extended multibyte and wide character utilities &lt;wchar.h&gt; (p: 402) </li>
<li> 7.26.13 Wide character classification and mapping utilities &lt;wctype.h&gt; (p: 402) </li>
</ul>
<li> C89/C90 standard (ISO/IEC 9899:1990): </li>
<ul><li> 4.1.5 Common definitions &lt;stddef.h&gt; </li></ul>
</ul>                   <h3 id="See_also"> See also</h3> <table class="t-dsc-begin"> <tr class="t-dsc"> <td colspan="2"> <span><a href="https://en.cppreference.com/w/cpp/string/wide" title="cpp/string/wide">C++ documentation</a></span> for <span class=""><span><code>Null</code>-terminated wide strings</span></span> </td>
</tr> </table>            <div class="_attribution">
  <p class="_attribution-p">
    &copy; cppreference.com<br>Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.<br>
    <a href="https://en.cppreference.com/w/c/string/wide" class="_attribution-link">https://en.cppreference.com/w/c/string/wide</a>
  </p>
</div>