man3/iswlower.3

   1 '\" t
   2 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
   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 (date) "Linux man-pages (unreleased)"
  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 .PP
  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 .PP
  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 .PP
  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 .PP
  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 .PP
  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 .PP
  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 .PP
  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 .PP
  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 .ad l
  79 .nh
  80 .TS
  81 allbox;
  82 lbx lb lb
  83 l l l.
  84 Interface       Attribute       Value
  85 T{
  86 .BR iswlower ()
  87 T}      Thread safety   MT-Safe locale
  88 .TE
  89 .hy
  90 .ad
  91 .sp 1
  92 .SH STANDARDS
  93 POSIX.1-2001, POSIX.1-2008, C99.
  94 .SH NOTES
  95 The behavior of
  96 .BR iswlower ()
  97 depends on the
  98 .B LC_CTYPE
  99 category of the
 100 current locale.
 101 .PP
 102 This function is not very appropriate for dealing with Unicode characters,
 103 because Unicode knows about three cases: upper, lower, and title case.
 104 .SH SEE ALSO
 105 .BR islower (3),
 106 .BR iswctype (3),
 107 .BR towlower (3)