1.\" $MirOS: src/lib/libc/locale/iswoctet.3,v 1.2 2009/07/03 18:15:03 tg Exp $
2.\"-
3.\" Copyright (c) 2008, 2009
4.\"	Thorsten Glaser <tg@mirbsd.org>
5.\"
6.\" Provided that these terms and disclaimer and all copyright notices
7.\" are retained or reproduced in an accompanying document, permission
8.\" is granted to deal in this work without restriction, including un-
9.\" limited rights to use, publicly perform, distribute, sell, modify,
10.\" merge, give away, or sublicence.
11.\"
12.\" This work is provided "AS IS" and WITHOUT WARRANTY of any kind, to
13.\" the utmost extent permitted by applicable law, neither express nor
14.\" implied; without malicious intent or gross negligence. In no event
15.\" may a licensor, author or contributor be held liable for indirect,
16.\" direct, other damage, loss, or other issues arising in any way out
17.\" of dealing in the work, even if advised of the possibility of such
18.\" damage or existence of a defect, except proven that it results out
19.\" of said person's immediate fault when using the work as intended.
20.\"-
21.Dd $Mdocdate: July 3 2009 $
22.Dt ISWOCTET 3
23.Os MirBSD
24.Sh NAME
25.Nm iswoctet
26.Nd OPTU-16 Raw Octet identification macro
27.Sh SYNOPSIS
28.Fd #define _ALL_SOURCE
29.In wchar.h
30.Ft bool
31.Fn iswoctet "wchar_t wc"
32.Sh DESCRIPTION
33The
34.Nm
35macro is a character classification utility function,
36for use with wide characters
37.Po
38.Fa wchar_t
39or
40.Fa wint_t
41.Pc .
42Note that there is no companion function with external linkage available.
43.Sh RETURN VALUES
44The macro evaluates to true if the wide character is in the MirOS OPTU\-16
45raw octet range (U+EF80 .. U+EFFF), false otherwise.
46.Sh SEE ALSO
47.Xr optu16to8 3 ,
48.Xr optu8to16 3
49.Sh HISTORY
50The
51.Nm
52macro first appeared in
53.Mx 11 .
54.Sh AUTHORS
55.An Thorsten Glaser Aq tg@mirbsd.org
56wrote the entire internationalisation implementation in
57.Mx .
58He is also the steward for the OPTU encoding.
59.Sh CAVEATS
60The current macro expansion assumes a 16-bit
61.Vt wchar_t .
62