1 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
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.
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
16 .TH ISWUPPER 3 1999-07-25 "GNU" "Linux Programmer's Manual"
18 iswupper \- test for uppercase wide character
21 .B #include <wctype.h>
23 .BI "int iswupper(wint_t " wc );
28 function is the wide-character equivalent of the
31 It tests whether \fIwc\fP is a wide character
32 belonging to the wide-character class "upper".
34 The wide-character class "upper" is a subclass of the wide-character class
35 "alpha", and therefore also a subclass of the wide-character class "alnum", of
36 the wide-character class "graph" and of the wide-character class "print".
38 Being a subclass of the wide-character class "print", the wide-character class
39 "upper" is disjoint from the wide-character class "cntrl".
41 Being a subclass of the wide-character class "graph", the wide-character class
42 "upper" is disjoint from the wide-character class "space" and its subclass
45 Being a subclass of the wide-character class "alnum", the wide-character class
46 "upper" is disjoint from the wide-character class "punct".
48 Being a subclass of the wide-character class "alpha", the wide-character class
49 "upper" is disjoint from the wide-character class "digit".
51 The wide-character class "upper" contains at least those characters \fIwc\fP
52 which are equal to \fItowupper(wc)\fP and different from \fItowlower(wc)\fP.
54 The wide-character class "upper" always contains at least the
55 letters \(aqA\(aq to \(aqZ\(aq.
59 function returns nonzero if \fIwc\fP is a wide character
60 belonging to the wide-character class "upper".
61 Otherwise it returns zero.
72 This function is not very appropriate for dealing with Unicode characters,
73 because Unicode knows about three cases: upper, lower and title case.