man3/iswlower.3

   1 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
   2 .\"
   3 .\" This is free documentation; you can redistribute it and/or
   4 .\" modify it under the terms of the GNU General Public License as
   5 .\" published by the Free Software Foundation; either version 2 of
   6 .\" the License, or (at your option) any later version.
   7 .\"
   8 .\" References consulted:
   9 .\"   GNU glibc-2 source code and manual
  10 .\"   Dinkumware C library reference http://www.dinkumware.com/
  11 .\"   OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html
  12 .\"   ISO/IEC 9899:1999
  13 .\"
  14 .TH ISWLOWER 3  1999-07-25 "GNU" "Linux Programmer's Manual"
  15 .SH NAME
  16 iswlower \- test for lowercase wide character
  17 .SH SYNOPSIS
  18 .nf
  19 .B #include <wctype.h>
  20 .sp
  21 .BI "int iswlower(wint_t " wc );
  22 .fi
  23 .SH DESCRIPTION
  24 The
  25 .BR iswlower ()
  26 function is the wide-character equivalent of the
  27 .BR islower (3)
  28 function.
  29 It tests whether \fIwc\fP is a wide character
  30 belonging to the wide-character class "lower".
  31 .PP
  32 The wide-character class "lower" is a subclass of the wide-character class
  33 "alpha", and therefore also a subclass
  34 of the wide-character class "alnum", of
  35 the wide-character class "graph" and of the wide-character class "print".
  36 .PP
  37 Being a subclass of the wide-character class "print",
  38 the wide-character class
  39 "lower" is disjoint from the wide-character class "cntrl".
  40 .PP
  41 Being a subclass of the wide-character class "graph",
  42 the wide-character class "lower" is disjoint from the
  43 wide-character class "space" and its subclass "blank".
  44 .PP
  45 Being a subclass of the wide-character class "alnum",
  46 the wide-character class
  47 "lower" is disjoint from the wide-character class "punct".
  48 .PP
  49 Being a subclass of the wide-character class "alpha",
  50 the wide-character class
  51 "lower" is disjoint from the wide-character class "digit".
  52 .PP
  53 The wide-character class "lower" contains at least
  54 those characters \fIwc\fP
  55 which are equal to \fItowlower(wc)\fP and different
  56 from \fItowupper(wc)\fP.
  57 .PP
  58 The wide-character class "lower" always contains
  59 at least the letters 'a'
  60 to 'z'.
  61 .SH "RETURN VALUE"
  62 The
  63 .BR iswlower ()
  64 function returns non-zero
  65 if \fIwc\fP is a wide character
  66 belonging to the wide-character class "lower".
  67 Otherwise it returns zero.
  68 .SH "CONFORMING TO"
  69 C99.
  70 .SH NOTES
  71 The behavior of
  72 .BR iswlower ()
  73 depends on the LC_CTYPE category of the
  74 current locale.
  75 .PP
  76 This function is not very appropriate for dealing with Unicode characters,
  77 because Unicode knows about three cases: upper, lower and title case.
  78 .SH "SEE ALSO"
  79 .BR islower (3),
  80 .BR iswctype (3),
  81 .BR towlower (3)