wchar.h.html

IEEE 1003.1-2003, Single Unix Specification v3

int           wmemcmp(const wchar_t *, const wchar_t *, size_t);
wchar_t      *wmemcpy(wchar_t *restrict, const wchar_t *restrict, size_t);
wchar_t      *wmemmove(wchar_t *, const wchar_t *, size_t);
wchar_t      *wmemset(wchar_t *, wchar_t, size_t);
int           wprintf(const wchar_t *restrict, ...);
int           wscanf(const wchar_t *restrict, ...);
</tt>
</pre>

<p>The <i>&lt;wchar.h&gt;</i> header shall define the following macros:</p>

<dl compact>
<dt>WCHAR_MAX</dt>

<dd>The maximum value representable by an object of type <b>wchar_t</b>.</dd>

<dt>WCHAR_MIN</dt>

<dd>The minimum value representable by an object of type <b>wchar_t</b>.</dd>

<dt>WEOF</dt>

<dd>Constant expression of type <b>wint_t</b> that is returned by several WP functions to indicate end-of-file.</dd>

<dt>NULL</dt>

<dd>As described in <a href="stddef.h.html"><i>&lt;stddef.h&gt;</i></a> .</dd>
</dl>

<p>The tag <b>tm</b> shall be declared as naming an incomplete structure type, the contents of which are described in the header <a
href="time.h.html"><i>&lt;time.h&gt;</i></a> .</p>

<p><sup>[<a href="javascript:open_code('CX')">CX</a>]</sup> <img src="../images/opt-start.gif" alt="[Option Start]" border="0">
Inclusion of the <i>&lt;wchar.h&gt;</i> header may make visible all symbols from the headers <a href=
"../basedefs/ctype.h.html"><i>&lt;ctype.h&gt;</i></a>, <a href="../basedefs/string.h.html"><i>&lt;string.h&gt;</i></a>, <a href=
"../basedefs/stdarg.h.html"><i>&lt;stdarg.h&gt;</i></a>, <a href="../basedefs/stddef.h.html"><i>&lt;stddef.h&gt;</i></a>, <a href=
"../basedefs/stdio.h.html"><i>&lt;stdio.h&gt;</i></a>, <a href="../basedefs/stdlib.h.html"><i>&lt;stdlib.h&gt;</i></a>, and <a
href="../basedefs/time.h.html"><i>&lt;time.h&gt;</i></a>. <img src="../images/opt-end.gif" alt="[Option End]" border="0"></p>
</blockquote>

<hr>
<div class="box"><em>The following sections are informative.</em></div>

<h4><a name="tag_13_83_04"></a>APPLICATION USAGE</h4>

<blockquote>
<p>The <a href="../functions/iswblank.html"><i>iswblank</i>()</a> function was a late addition to the ISO&nbsp;C standard and was
introduced at the same time as the ISO&nbsp;C standard introduced <a href="../basedefs/wctype.h.html"><i>&lt;wctype.h&gt;</i></a>,
which contains all of the <i>isw*</i>() functions. The Open Group Base Specifications had
previously aligned with the MSE working draft and had introduced the rest of the <i>isw*</i>()
functions into <i>&lt;wchar.h&gt;</i>. For backwards-compatibility, the original set of 
<i>isw*</i>() functions, without <a href="../functions/iswblank.html"><i>iswblank</i>()</a>, are
permitted (as an XSI extension) in <i>&lt;wchar.h&gt;</i>. For maximum portability, applications should include <a href=
"../basedefs/wctype.h.html"><i>&lt;wctype.h&gt;</i></a> in order to obtain declarations for the 
<i>isw*</i>() functions.</p>
</blockquote>

<h4><a name="tag_13_83_05"></a>RATIONALE</h4>

<blockquote>
<p>In the ISO&nbsp;C standard, the symbols referenced as XSI extensions are in <a href=
"../basedefs/wctype.h.html"><i>&lt;wctype.h&gt;</i></a>. Their presence here is thus an extension.</p>
</blockquote>

<h4><a name="tag_13_83_06"></a>FUTURE DIRECTIONS</h4>

<blockquote>
<p>None.</p>
</blockquote>

<h4><a name="tag_13_83_07"></a>SEE ALSO</h4>

<blockquote>
<p><a href="ctype.h.html"><i>&lt;ctype.h&gt;</i></a> , <a href="stdarg.h.html"><i>&lt;stdarg.h&gt;</i></a> , <a href=
"stddef.h.html"><i>&lt;stddef.h&gt;</i></a> , <a href="stdio.h.html"><i>&lt;stdio.h&gt;</i></a> , <a href=
"stdlib.h.html"><i>&lt;stdlib.h&gt;</i></a> , <a href="string.h.html"><i>&lt;string.h&gt;</i></a> , <a href=
"time.h.html"><i>&lt;time.h&gt;</i></a> , <a href="wctype.h.html"><i>&lt;wctype.h&gt;</i></a> , the System Interfaces volume of
IEEE&nbsp;Std&nbsp;1003.1-2001, <a href="../functions/btowc.html"><i>btowc</i>()</a>, <a href=
"../functions/confstr.html"><i>confstr</i>()</a>, <a href="../functions/fgetwc.html"><i>fgetwc</i>()</a>, <a href=
"../functions/fgetws.html"><i>fgetws</i>()</a>, <a href="../functions/fputwc.html"><i>fputwc</i>()</a>, <a href=
"../functions/fputws.html"><i>fputws</i>()</a>, <a href="../functions/fwide.html"><i>fwide</i>()</a>, <a href=
"../functions/fwprintf.html"><i>fwprintf</i>()</a>, <a href="../functions/fwscanf.html"><i>fwscanf</i>()</a>, <a href=
"../functions/getwc.html"><i>getwc</i>()</a>, <a href="../functions/getwchar.html"><i>getwchar</i>()</a>, <a href=
"../functions/iswalnum.html"><i>iswalnum</i>()</a>, <a href="../functions/iswalpha.html"><i>iswalpha</i>()</a>, <a href=
"../functions/iswcntrl.html"><i>iswcntrl</i>()</a>, <a href="../functions/iswctype.html"><i>iswctype</i>()</a>, <a href=
"../functions/iswdigit.html"><i>iswdigit</i>()</a>, <a href="../functions/iswgraph.html"><i>iswgraph</i>()</a>, <a href=
"../functions/iswlower.html"><i>iswlower</i>()</a>, <a href="../functions/iswprint.html"><i>iswprint</i>()</a>, <a href=
"../functions/iswpunct.html"><i>iswpunct</i>()</a>, <a href="../functions/iswspace.html"><i>iswspace</i>()</a>, <a href=
"../functions/iswupper.html"><i>iswupper</i>()</a>, <a href="../functions/iswxdigit.html"><i>iswxdigit</i>()</a>, <a href=
"../functions/iswctype.html"><i>iswctype</i>()</a>, <a href="../functions/mbsinit.html"><i>mbsinit</i>()</a>, <a href=
"../functions/mbrlen.html"><i>mbrlen</i>()</a>, <a href="../functions/mbrtowc.html"><i>mbrtowc</i>()</a>, <a href=
"../functions/mbsrtowcs.html"><i>mbsrtowcs</i>()</a>, <a href="../functions/putwc.html"><i>putwc</i>()</a>, <a href=
"../functions/putwchar.html"><i>putwchar</i>()</a>, <a href="../functions/swprintf.html"><i>swprintf</i>()</a>, <a href=
"../functions/swscanf.html"><i>swscanf</i>()</a>, <a href="../functions/towlower.html"><i>towlower</i>()</a>, <a href=
"../functions/towupper.html"><i>towupper</i>()</a>, <a href="../functions/ungetwc.html"><i>ungetwc</i>()</a>, <a href=
"../functions/vfwprintf.html"><i>vfwprintf</i>()</a>, <a href="../functions/vfwscanf.html"><i>vfwscanf</i>()</a>, <a href=
"../functions/vswprintf.html"><i>vswprintf</i>()</a>, <a href="../functions/vswscanf.html"><i>vswscanf</i>()</a>, <a href=
"../functions/vwscanf.html"><i>vwscanf</i>()</a>, <a href="../functions/wcrtomb.html"><i>wcrtomb</i>()</a>, <a href=
"../functions/wcsrtombs.html"><i>wcsrtombs</i>()</a>, <a href="../functions/wcscat.html"><i>wcscat</i>()</a>, <a href=
"../functions/wcschr.html"><i>wcschr</i>()</a>, <a href="../functions/wcscmp.html"><i>wcscmp</i>()</a>, <a href=
"../functions/wcscoll.html"><i>wcscoll</i>()</a>, <a href="../functions/wcscpy.html"><i>wcscpy</i>()</a>, <a href=
"../functions/wcscspn.html"><i>wcscspn</i>()</a>, <a href="../functions/wcsftime.html"><i>wcsftime</i>()</a>, <a href=
"../functions/wcslen.html"><i>wcslen</i>()</a>, <a href="../functions/wcsncat.html"><i>wcsncat</i>()</a>, <a href=
"../functions/wcsncmp.html"><i>wcsncmp</i>()</a>, <a href="../functions/wcsncpy.html"><i>wcsncpy</i>()</a>, <a href=
"../functions/wcspbrk.html"><i>wcspbrk</i>()</a>, <a href="../functions/wcsrchr.html"><i>wcsrchr</i>()</a>, <a href=
"../functions/wcsspn.html"><i>wcsspn</i>()</a>, <a href="../functions/wcsstr.html"><i>wcsstr</i>()</a>, <a href=
"../functions/wcstod.html"><i>wcstod</i>()</a>, <a href="../functions/wcstof.html"><i>wcstof</i>()</a>, <a href=
"../functions/wcstok.html"><i>wcstok</i>()</a>, <a href="../functions/wcstol.html"><i>wcstol</i>()</a>, <a href=
"../functions/wcstold.html"><i>wcstold</i>()</a>, <a href="../functions/wcstoll.html"><i>wcstoll</i>()</a>, <a href=
"../functions/wcstoul.html"><i>wcstoul</i>()</a>, <a href="../functions/wcstoull.html"><i>wcstoull</i>()</a>, <a href=
"../functions/wcswcs.html"><i>wcswcs</i>()</a>, <a href="../functions/wcswidth.html"><i>wcswidth</i>()</a>, <a href=
"../functions/wcsxfrm.html"><i>wcsxfrm</i>()</a>, <a href="../functions/wctob.html"><i>wctob</i>()</a>, <a href=
"../functions/wctype.html"><i>wctype</i>()</a>, <a href="../functions/wcwidth.html"><i>wcwidth</i>()</a>, <a href=
"../functions/wmemchr.html"><i>wmemchr</i>()</a>, <a href="../functions/wmemcmp.html"><i>wmemcmp</i>()</a>, <a href=
"../functions/wmemcpy.html"><i>wmemcpy</i>()</a>, <a href="../functions/wmemmove.html"><i>wmemmove</i>()</a>, <a href=
"../functions/wmemset.html"><i>wmemset</i>()</a>, <a href="../functions/wprintf.html"><i>wprintf</i>()</a>, <a href=
"../functions/wscanf.html"><i>wscanf</i>()</a>, the Shell and Utilities volume of IEEE&nbsp;Std&nbsp;1003.1-2001, <a href=
"../utilities/getconf.html"><i>getconf</i></a></p>
</blockquote>

<h4><a name="tag_13_83_08"></a>CHANGE HISTORY</h4>

<blockquote>
<p>First released in Issue 4.</p>
</blockquote>

<h4><a name="tag_13_83_09"></a>Issue 5</h4>

<blockquote>
<p>Aligned with the ISO/IEC&nbsp;9899:1990/Amendment 1:1995 (E).</p>
</blockquote>

<h4><a name="tag_13_83_10"></a>Issue 6</h4>

<blockquote>
<p>The Open Group Corrigendum U021/10 is applied. The prototypes for <a href="../functions/wcswidth.html"><i>wcswidth</i>()</a> and
<a href="../functions/wcwidth.html"><i>wcwidth</i>()</a> are marked as extensions.</p>

<p>The Open Group Corrigendum U028/5 is applied, correcting the prototype for the <a href=
"../functions/mbsinit.html"><i>mbsinit</i>()</a> function.</p>

<p>The following changes are made for alignment with the ISO/IEC&nbsp;9899:1999 standard:</p>

<ul>
<li>
<p>Various function prototypes are updated to add the <b>restrict</b> keyword.</p>
</li>

<li>
<p>The functions <a href="../functions/vfwscanf.html"><i>vfwscanf</i>()</a>, <a href=
"../functions/vswscanf.html"><i>vswscanf</i>()</a>, <a href="../functions/wcstof.html"><i>wcstof</i>()</a>, <a href=
"../functions/wcstold.html"><i>wcstold</i>()</a>, <a href="../functions/wcstoll.html"><i>wcstoll</i>()</a>, and <a href=
"../functions/wcstoull.html"><i>wcstoull</i>()</a> are added.</p>
</li>
</ul>

<p>The type <b>wctype_t</b>, the <i>isw*</i>(), 
<i>to*</i>(), and <a href="../functions/wctype.html"><i>wctype</i>()</a> functions are marked as XSI
extensions.</p>

<p>IEEE&nbsp;Std 1003.1-2001/Cor&nbsp;1-2002, item XBD/TC1/D6/26 is applied, adding the APPLICATION USAGE section.</p>
</blockquote>

<div class="box"><em>End of informative text.</em></div>

<hr>
<hr size="2" noshade>
<center><font size="2"><!--footer start-->
UNIX &reg; is a registered Trademark of The Open Group.<br>
POSIX &reg; is a registered Trademark of The IEEE.<br>
[ <a href="../mindex.html">Main Index</a> | <a href="../basedefs/contents.html">XBD</a> | <a href=
"../utilities/contents.html">XCU</a> | <a href="../functions/contents.html">XSH</a> | <a href="../xrat/contents.html">XRAT</a>
]</font></center>

<!--footer end-->
<hr size="2" noshade>
</body>
</html>