Debian Codegraph @

upstream/debian-trixie/man3/iswlower.3

raw
1 '\" t
2 .\" Copyright (c) Bruno Haible <[email protected]>
3 .\"
4 .\" SPDX-License-Identifier: GPL-2.0-or-later
5 .\"
6 .\" References consulted:
7 .\" GNU glibc-2 source code and manual
8 .\" Dinkumware C library reference http://www.dinkumware.com/
9 .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
10 .\" ISO/IEC 9899:1999
11 .\"
12 .TH iswlower 3 2024-05-02 "Linux man-pages 6.9.1"
13 .SH NAME
14 iswlower \- test for lowercase wide character
15 .SH LIBRARY
16 Standard C library
17 .RI ( libc ", " \-lc )
18 .SH SYNOPSIS
19 .nf
20 .B #include <wctype.h>
21 .P
22 .BI "int iswlower(wint_t " wc );
23 .fi
24 .SH DESCRIPTION
25 The
26 .BR iswlower ()
27 function is the wide-character equivalent of the
28 .BR islower (3)
29 function.
30 It tests whether
31 .I wc
32 is a wide character
33 belonging to the wide-character class "lower".
34 .P
35 The wide-character class "lower" is a subclass of the wide-character class
36 "alpha", and therefore also a subclass
37 of the wide-character class "alnum", of
38 the wide-character class "graph" and of the wide-character class "print".
39 .P
40 Being a subclass of the wide-character class "print",
41 the wide-character class
42 "lower" is disjoint from the wide-character class "cntrl".
43 .P
44 Being a subclass of the wide-character class "graph",
45 the wide-character class "lower" is disjoint from the
46 wide-character class "space" and its subclass "blank".
47 .P
48 Being a subclass of the wide-character class "alnum",
49 the wide-character class
50 "lower" is disjoint from the wide-character class "punct".
51 .P
52 Being a subclass of the wide-character class "alpha",
53 the wide-character class
54 "lower" is disjoint from the wide-character class "digit".
55 .P
56 The wide-character class "lower" contains at least
57 those characters
58 .I wc
59 which are equal to
60 .I towlower(wc)
61 and different from
62 .IR towupper(wc) .
63 .P
64 The wide-character class "lower" always contains
65 at least the letters \[aq]a\[aq] to \[aq]z\[aq].
66 .SH RETURN VALUE
67 The
68 .BR iswlower ()
69 function returns nonzero
70 if
71 .I wc
72 is a wide character
73 belonging to the wide-character class "lower".
74 Otherwise, it returns zero.
75 .SH ATTRIBUTES
76 For an explanation of the terms used in this section, see
77 .BR attributes (7).
78 .TS
79 allbox;
80 lbx lb lb
81 l l l.
82 Interface Attribute Value
83 T{
84 .na
85 .nh
86 .BR iswlower ()
87 T} Thread safety MT-Safe locale
88 .TE
89 .SH STANDARDS
90 C11, POSIX.1-2008.
91 .SH HISTORY
92 POSIX.1-2001, C99.
93 .SH NOTES
94 The behavior of
95 .BR iswlower ()
96 depends on the
97 .B LC_CTYPE
98 category of the
99 current locale.
100 .P
101 This function is not very appropriate for dealing with Unicode characters,
102 because Unicode knows about three cases: upper, lower, and title case.
103 .SH SEE ALSO
104 .BR islower (3),
105 .BR iswctype (3),
106 .BR towlower (3)