]>
Commit | Line | Data |
---|---|---|
a1eaacb1 | 1 | '\" t |
fea681da MK |
2 | .\" Copyright (c) Bruno Haible <haible@clisp.cons.org> |
3 | .\" | |
e4a74ca8 | 4 | .\" SPDX-License-Identifier: GPL-2.0-or-later |
fea681da MK |
5 | .\" |
6 | .\" References consulted: | |
7 | .\" GNU glibc-2 source code and manual | |
8 | .\" Dinkumware C library reference http://www.dinkumware.com/ | |
008f1ecc | 9 | .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html |
fea681da MK |
10 | .\" ISO/IEC 9899:1999 |
11 | .\" | |
4c1c5274 | 12 | .TH iswcntrl 3 (date) "Linux man-pages (unreleased)" |
fea681da MK |
13 | .SH NAME |
14 | iswcntrl \- test for control wide character | |
98240ee2 AC |
15 | .SH LIBRARY |
16 | Standard C library | |
8fc3b2cf | 17 | .RI ( libc ", " \-lc ) |
fea681da MK |
18 | .SH SYNOPSIS |
19 | .nf | |
20 | .B #include <wctype.h> | |
68e4db0a | 21 | .PP |
fea681da MK |
22 | .BI "int iswcntrl(wint_t " wc ); |
23 | .fi | |
24 | .SH DESCRIPTION | |
60a90ecd MK |
25 | The |
26 | .BR iswcntrl () | |
27 | function is the wide-character equivalent of the | |
28 | .BR iscntrl (3) | |
29 | function. | |
35cfd378 MK |
30 | It tests whether |
31 | .I wc | |
32 | is a wide character | |
d0f17b57 | 33 | belonging to the wide-character class "cntrl". |
fea681da | 34 | .PP |
d0f17b57 | 35 | The wide-character class "cntrl" is disjoint from the wide-character class |
fea681da MK |
36 | "print" and therefore also disjoint from its subclasses "graph", "alpha", |
37 | "upper", "lower", "digit", "xdigit", "punct". | |
38 | .PP | |
35cfd378 MK |
39 | For an unsigned char |
40 | .IR c , | |
41 | .I iscntrl(c) | |
42 | implies | |
43 | .IR iswcntrl(btowc(c)) , | |
fea681da | 44 | but not vice versa. |
47297adb | 45 | .SH RETURN VALUE |
60a90ecd MK |
46 | The |
47 | .BR iswcntrl () | |
35cfd378 MK |
48 | function returns nonzero if |
49 | .I wc | |
50 | is a | |
d0f17b57 | 51 | wide character belonging to the wide-character class "cntrl". |
2b9b829d | 52 | Otherwise, it returns zero. |
65126e61 | 53 | .SH ATTRIBUTES |
249564d0 MK |
54 | For an explanation of the terms used in this section, see |
55 | .BR attributes (7). | |
56 | .TS | |
57 | allbox; | |
c466875e | 58 | lbx lb lb |
249564d0 MK |
59 | l l l. |
60 | Interface Attribute Value | |
61 | T{ | |
9e54434e BR |
62 | .na |
63 | .nh | |
65126e61 | 64 | .BR iswcntrl () |
249564d0 MK |
65 | T} Thread safety MT-Safe locale |
66 | .TE | |
c466875e | 67 | .sp 1 |
3113c7f3 | 68 | .SH STANDARDS |
4131356c AC |
69 | C11, POSIX.1-2008. |
70 | .SH HISTORY | |
71 | POSIX.1-2001, C99. | |
fea681da | 72 | .SH NOTES |
d9bfdb9c | 73 | The behavior of |
60a90ecd | 74 | .BR iswcntrl () |
1274071a MK |
75 | depends on the |
76 | .B LC_CTYPE | |
77 | category of the | |
fea681da | 78 | current locale. |
47297adb | 79 | .SH SEE ALSO |
e37e3282 MK |
80 | .BR iscntrl (3), |
81 | .BR iswctype (3) |