]>
Commit | Line | Data |
---|---|---|
fea681da MK |
1 | .\" Copyright (c) Bruno Haible <haible@clisp.cons.org> |
2 | .\" | |
89e3ffe9 | 3 | .\" %%%LICENSE_START(GPLv2+_DOC_ONEPARA) |
fea681da MK |
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. | |
fe382ebf | 8 | .\" %%%LICENSE_END |
fea681da MK |
9 | .\" |
10 | .\" References consulted: | |
11 | .\" GNU glibc-2 source code and manual | |
12 | .\" Dinkumware C library reference http://www.dinkumware.com/ | |
008f1ecc | 13 | .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html |
fea681da MK |
14 | .\" ISO/IEC 9899:1999 |
15 | .\" | |
460495ca | 16 | .TH ISWLOWER 3 2015-08-08 "GNU" "Linux Programmer's Manual" |
fea681da MK |
17 | .SH NAME |
18 | iswlower \- test for lowercase wide character | |
19 | .SH SYNOPSIS | |
20 | .nf | |
21 | .B #include <wctype.h> | |
68e4db0a | 22 | .PP |
fea681da MK |
23 | .BI "int iswlower(wint_t " wc ); |
24 | .fi | |
25 | .SH DESCRIPTION | |
60a90ecd MK |
26 | The |
27 | .BR iswlower () | |
28 | function is the wide-character equivalent of the | |
29 | .BR islower (3) | |
30 | function. | |
35cfd378 MK |
31 | It tests whether |
32 | .I wc | |
33 | is a wide character | |
d0f17b57 | 34 | belonging to the wide-character class "lower". |
fea681da | 35 | .PP |
d0f17b57 | 36 | The wide-character class "lower" is a subclass of the wide-character class |
988db661 | 37 | "alpha", and therefore also a subclass |
d0f17b57 MK |
38 | of the wide-character class "alnum", of |
39 | the wide-character class "graph" and of the wide-character class "print". | |
fea681da | 40 | .PP |
d0f17b57 MK |
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". | |
fea681da | 44 | .PP |
d0f17b57 | 45 | Being a subclass of the wide-character class "graph", |
988db661 | 46 | the wide-character class "lower" is disjoint from the |
d0f17b57 | 47 | wide-character class "space" and its subclass "blank". |
fea681da | 48 | .PP |
d0f17b57 MK |
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". | |
fea681da | 52 | .PP |
d0f17b57 MK |
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". | |
fea681da | 56 | .PP |
d0f17b57 | 57 | The wide-character class "lower" contains at least |
35cfd378 MK |
58 | those characters |
59 | .I wc | |
60 | which are equal to | |
61 | .I towlower(wc) | |
62 | and different from | |
63 | .IR towupper(wc) . | |
fea681da | 64 | .PP |
d0f17b57 | 65 | The wide-character class "lower" always contains |
f81fb444 | 66 | at least the letters \(aqa\(aq to \(aqz\(aq. |
47297adb | 67 | .SH RETURN VALUE |
60a90ecd MK |
68 | The |
69 | .BR iswlower () | |
c7094399 | 70 | function returns nonzero |
35cfd378 MK |
71 | if |
72 | .I wc | |
73 | is a wide character | |
d0f17b57 | 74 | belonging to the wide-character class "lower". |
2b9b829d | 75 | Otherwise, it returns zero. |
44478dbd PH |
76 | .SH ATTRIBUTES |
77 | For an explanation of the terms used in this section, see | |
78 | .BR attributes (7). | |
79 | .TS | |
80 | allbox; | |
81 | lb lb lb | |
82 | l l l. | |
83 | Interface Attribute Value | |
84 | T{ | |
85 | .BR iswlower () | |
86 | T} Thread safety MT-Safe locale | |
87 | .TE | |
47297adb | 88 | .SH CONFORMING TO |
c03a3f00 | 89 | POSIX.1-2001, POSIX.1-2008, C99. |
fea681da | 90 | .SH NOTES |
d9bfdb9c | 91 | The behavior of |
60a90ecd | 92 | .BR iswlower () |
1274071a MK |
93 | depends on the |
94 | .B LC_CTYPE | |
95 | category of the | |
fea681da MK |
96 | current locale. |
97 | .PP | |
98 | This function is not very appropriate for dealing with Unicode characters, | |
99 | because Unicode knows about three cases: upper, lower and title case. | |
47297adb | 100 | .SH SEE ALSO |
e37e3282 MK |
101 | .BR islower (3), |
102 | .BR iswctype (3), | |
103 | .BR towlower (3) |