Changes.old: Add missing entry in 5.13 changelog
[man-pages.git] / man3 / iswlower.3
blob8bf718b6e5f8747474a46f5ad81bb6baa9b20c02
1 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
2 .\"
3 .\" %%%LICENSE_START(GPLv2+_DOC_ONEPARA)
4 .\" This is free documentation; you can redistribute it and/or
5 .\" modify it under the terms of the GNU General Public License as
6 .\" published by the Free Software Foundation; either version 2 of
7 .\" the License, or (at your option) any later version.
8 .\" %%%LICENSE_END
9 .\"
10 .\" References consulted:
11 .\"   GNU glibc-2 source code and manual
12 .\"   Dinkumware C library reference http://www.dinkumware.com/
13 .\"   OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
14 .\"   ISO/IEC 9899:1999
15 .\"
16 .TH ISWLOWER 3  2021-03-22 "GNU" "Linux Programmer's Manual"
17 .SH NAME
18 iswlower \- test for lowercase wide character
19 .SH SYNOPSIS
20 .nf
21 .B #include <wctype.h>
22 .PP
23 .BI "int iswlower(wint_t " wc );
24 .fi
25 .SH DESCRIPTION
26 The
27 .BR iswlower ()
28 function is the wide-character equivalent of the
29 .BR islower (3)
30 function.
31 It tests whether
32 .I wc
33 is a wide character
34 belonging to the wide-character class "lower".
35 .PP
36 The wide-character class "lower" is a subclass of the wide-character class
37 "alpha", and therefore also a subclass
38 of the wide-character class "alnum", of
39 the wide-character class "graph" and of the wide-character class "print".
40 .PP
41 Being a subclass of the wide-character class "print",
42 the wide-character class
43 "lower" is disjoint from the wide-character class "cntrl".
44 .PP
45 Being a subclass of the wide-character class "graph",
46 the wide-character class "lower" is disjoint from the
47 wide-character class "space" and its subclass "blank".
48 .PP
49 Being a subclass of the wide-character class "alnum",
50 the wide-character class
51 "lower" is disjoint from the wide-character class "punct".
52 .PP
53 Being a subclass of the wide-character class "alpha",
54 the wide-character class
55 "lower" is disjoint from the wide-character class "digit".
56 .PP
57 The wide-character class "lower" contains at least
58 those characters
59 .I wc
60 which are equal to
61 .I towlower(wc)
62 and different from
63 .IR towupper(wc) .
64 .PP
65 The wide-character class "lower" always contains
66 at least the letters \(aqa\(aq to \(aqz\(aq.
67 .SH RETURN VALUE
68 The
69 .BR iswlower ()
70 function returns nonzero
72 .I wc
73 is a wide character
74 belonging to the wide-character class "lower".
75 Otherwise, it returns zero.
76 .SH ATTRIBUTES
77 For an explanation of the terms used in this section, see
78 .BR attributes (7).
79 .ad l
80 .nh
81 .TS
82 allbox;
83 lbx lb lb
84 l l l.
85 Interface       Attribute       Value
87 .BR iswlower ()
88 T}      Thread safety   MT-Safe locale
89 .TE
90 .hy
91 .ad
92 .sp 1
93 .SH CONFORMING TO
94 POSIX.1-2001, POSIX.1-2008, C99.
95 .SH NOTES
96 The behavior of
97 .BR iswlower ()
98 depends on the
99 .B LC_CTYPE
100 category of the
101 current locale.
103 This function is not very appropriate for dealing with Unicode characters,
104 because Unicode knows about three cases: upper, lower, and title case.
105 .SH SEE ALSO
106 .BR islower (3),
107 .BR iswctype (3),
108 .BR towlower (3)