Debian Codegraph @

upstream/debian-unstable/man3/iswlower.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 iswlower 3 2026-02-08 "Linux man-pages 6.18"
8 .SH NAME
9 iswlower \- test for lowercase 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 iswlower(wint_t " wc );
18 .fi
19 .SH DESCRIPTION
20 The
21 .BR iswlower ()
22 function is the wide-character equivalent of the
23 .BR islower (3)
24 function.
25 It tests whether
26 .I wc
27 is a wide character
28 belonging to the wide-character class "lower".
29 .P
30 The wide-character class "lower" is a subclass of the wide-character class
31 "alpha", and therefore also a subclass
32 of the wide-character class "alnum", of
33 the wide-character class "graph" and of the wide-character class "print".
34 .P
35 Being a subclass of the wide-character class "print",
36 the wide-character class
37 "lower" is disjoint from the wide-character class "cntrl".
38 .P
39 Being a subclass of the wide-character class "graph",
40 the wide-character class "lower" is disjoint from the
41 wide-character class "space" and its subclass "blank".
42 .P
43 Being a subclass of the wide-character class "alnum",
44 the wide-character class
45 "lower" is disjoint from the wide-character class "punct".
46 .P
47 Being a subclass of the wide-character class "alpha",
48 the wide-character class
49 "lower" is disjoint from the wide-character class "digit".
50 .P
51 The wide-character class "lower" contains at least
52 those characters
53 .I wc
54 which are equal to
55 .I towlower(wc)
56 and different from
57 .IR towupper(wc) .
58 .P
59 The wide-character class "lower" always contains
60 at least the letters \[aq]a\[aq] to \[aq]z\[aq].
61 .SH RETURN VALUE
62 The
63 .BR iswlower ()
64 function returns nonzero
65 if
66 .I wc
67 is a wide character
68 belonging to the wide-character class "lower".
69 Otherwise, it returns zero.
70 .SH ATTRIBUTES
71 For an explanation of the terms used in this section, see
72 .BR attributes (7).
73 .TS
74 allbox;
75 lbx lb lb
76 l l l.
77 Interface Attribute Value
78 T{
79 .na
80 .nh
81 .BR iswlower ()
82 T} Thread safety MT-Safe locale
83 .TE
84 .SH STANDARDS
85 C11, POSIX.1-2008.
86 .SH HISTORY
87 POSIX.1-2001, C99.
88 .SH NOTES
89 The behavior of
90 .BR iswlower ()
91 depends on the
92 .B LC_CTYPE
93 category of the
94 current locale.
95 .P
96 This function is not very appropriate for dealing with Unicode characters,
97 because Unicode knows about three cases: upper, lower, and title case.
98 .SH SEE ALSO
99 .BR islower (3),
100 .BR iswctype (3),
101 .BR towlower (3)