Debian Codegraph @

upstream/debian-unstable/man3/iswcntrl.3

raw
1 '\" t
2 .\" Copyright, Bruno Haible <[email protected]>
3 .\" Copyright, the authors of the Linux man-pages project
4 .\"
5 .\" SPDX-License-Identifier: GPL-2.0-or-later
6 .\"
7 .TH iswcntrl 3 2026-02-08 "Linux man-pages 6.18"
8 .SH NAME
9 iswcntrl \- test for control wide character
10 .SH LIBRARY
11 Standard C library
12 .RI ( libc ,\~ \-lc )
13 .SH SYNOPSIS
14 .nf
15 .B #include <wctype.h>
16 .P
17 .BI "int iswcntrl(wint_t " wc );
18 .fi
19 .SH DESCRIPTION
20 The
21 .BR iswcntrl ()
22 function is the wide-character equivalent of the
23 .BR iscntrl (3)
24 function.
25 It tests whether
26 .I wc
27 is a wide character
28 belonging to the wide-character class "cntrl".
29 .P
30 The wide-character class "cntrl" is disjoint from the wide-character class
31 "print" and therefore also disjoint from its subclasses "graph", "alpha",
32 "upper", "lower", "digit", "xdigit", "punct".
33 .P
34 For an unsigned char
35 .IR c ,
36 .I iscntrl(c)
37 implies
38 .IR iswcntrl(btowc(c)) ,
39 but not vice versa.
40 .SH RETURN VALUE
41 The
42 .BR iswcntrl ()
43 function returns nonzero if
44 .I wc
45 is a
46 wide character belonging to the wide-character class "cntrl".
47 Otherwise, it returns zero.
48 .SH ATTRIBUTES
49 For an explanation of the terms used in this section, see
50 .BR attributes (7).
51 .TS
52 allbox;
53 lbx lb lb
54 l l l.
55 Interface Attribute Value
56 T{
57 .na
58 .nh
59 .BR iswcntrl ()
60 T} Thread safety MT-Safe locale
61 .TE
62 .SH STANDARDS
63 C11, POSIX.1-2008.
64 .SH HISTORY
65 POSIX.1-2001, C99.
66 .SH NOTES
67 The behavior of
68 .BR iswcntrl ()
69 depends on the
70 .B LC_CTYPE
71 category of the
72 current locale.
73 .SH SEE ALSO
74 .BR iscntrl (3),
75 .BR iswctype (3)