Debian Codegraph @

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