iswlower(3)

1iswlower(3)                Library Functions Manual                iswlower(3)
2
3
4

NAME

6       iswlower - test for lowercase wide character
7

LIBRARY

9       Standard C library (libc, -lc)
10

SYNOPSIS

12       #include <wctype.h>
13
14       int iswlower(wint_t wc);
15

DESCRIPTION

17       The  iswlower()  function  is  the wide-character equivalent of the is‐
18       lower(3) function.  It tests whether wc is a wide  character  belonging
19       to the wide-character class "lower".
20
21       The  wide-character  class  "lower" is a subclass of the wide-character
22       class "alpha", and therefore also  a  subclass  of  the  wide-character
23       class  "alnum",  of  the  wide-character class "graph" and of the wide-
24       character class "print".
25
26       Being a subclass of the wide-character class "print", the  wide-charac‐
27       ter class "lower" is disjoint from the wide-character class "cntrl".
28
29       Being  a subclass of the wide-character class "graph", the wide-charac‐
30       ter class "lower" is disjoint from the wide-character class "space" and
31       its subclass "blank".
32
33       Being  a subclass of the wide-character class "alnum", the wide-charac‐
34       ter class "lower" is disjoint from the wide-character class "punct".
35
36       Being a subclass of the wide-character class "alpha", the  wide-charac‐
37       ter class "lower" is disjoint from the wide-character class "digit".
38
39       The  wide-character class "lower" contains at least those characters wc
40       which are equal to towlower(wc) and different from towupper(wc).
41
42       The wide-character class "lower" always contains at least  the  letters
43       'a' to 'z'.
44

RETURN VALUE

46       The  iswlower()  function returns nonzero if wc is a wide character be‐
47       longing to the wide-character class  "lower".   Otherwise,  it  returns
48       zero.
49

ATTRIBUTES

51       For  an  explanation  of  the  terms  used  in  this  section,  see at‐
52       tributes(7).
53
54       ┌─────────────────────────────────────┬───────────────┬────────────────┐
55       │Interface                            │ Attribute     │ Value          │
56       ├─────────────────────────────────────┼───────────────┼────────────────┤
57       │iswlower()                           │ Thread safety │ MT-Safe locale │
58       └─────────────────────────────────────┴───────────────┴────────────────┘
59

STANDARDS

61       C11, POSIX.1-2008.
62

HISTORY

64       POSIX.1-2001, C99.
65

NOTES

67       The behavior of iswlower() depends on the LC_CTYPE category of the cur‐
68       rent locale.
69
70       This  function is not very appropriate for dealing with Unicode charac‐
71       ters, because Unicode knows about three cases: upper, lower, and  title
72       case.
73