Debian Codegraph @

upstream/debian-unstable/man3/iswgraph.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 iswgraph 3 2026-02-08 "Linux man-pages 6.18"
8 .SH NAME
9 iswgraph \- test for graphic 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 iswgraph(wint_t " wc );
18 .fi
19 .SH DESCRIPTION
20 The
21 .BR iswgraph ()
22 function is the wide-character equivalent of the
23 .BR isgraph (3)
24 function.
25 It tests whether
26 .I wc
27 is a wide character
28 belonging to the wide-character class "graph".
29 .P
30 The wide-character class "graph" is a subclass of the wide-character class
31 "print".
32 .P
33 Being a subclass of the wide-character class "print",
34 the wide-character class
35 "graph" is disjoint from the wide-character class "cntrl".
36 .P
37 The wide-character class "graph" is disjoint from the wide-character class
38 "space" and therefore also disjoint from its subclass "blank".
39 .\" Note: UNIX98 (susv2/xbd/locale.html) says that "graph" and "space" may
40 .\" have characters in common, except U+0020. But C99 (ISO/IEC 9899:1999
41 .\" section 7.25.2.1.10) says that "space" and "graph" are disjoint.
42 .P
43 The wide-character class "graph" contains all the wide characters from the
44 wide-character class "print" except the space character.
45 It therefore contains
46 the wide-character classes "alnum" and "punct".
47 .SH RETURN VALUE
48 The
49 .BR iswgraph ()
50 function returns nonzero
51 if
52 .I wc
53 is a wide character
54 belonging to the wide-character class "graph".
55 Otherwise, it returns zero.
56 .SH ATTRIBUTES
57 For an explanation of the terms used in this section, see
58 .BR attributes (7).
59 .TS
60 allbox;
61 lbx lb lb
62 l l l.
63 Interface Attribute Value
64 T{
65 .na
66 .nh
67 .BR iswgraph ()
68 T} Thread safety MT-Safe locale
69 .TE
70 .SH STANDARDS
71 C11, POSIX.1-2008.
72 .SH HISTORY
73 POSIX.1-2001, C99.
74 .SH NOTES
75 The behavior of
76 .BR iswgraph ()
77 depends on the
78 .B LC_CTYPE
79 category of the
80 current locale.
81 .SH SEE ALSO
82 .BR isgraph (3),
83 .BR iswctype (3)