1 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
3 .\" SPDX-License-Identifier: GPL-2.0-or-later
5 .\" References consulted:
6 .\" GNU glibc-2 source code and manual
7 .\" Dinkumware C library reference http://www.dinkumware.com/
8 .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
11 .TH iswupper 3 (date) "Linux man-pages (unreleased)"
13 iswupper \- test for uppercase wide character
16 .RI ( libc ", " \-lc )
19 .B #include <wctype.h>
21 .BI "int iswupper(wint_t " wc );
26 function is the wide-character equivalent of the
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
58 The wide-character class "upper" always contains at least the
59 letters \(aqA\(aq to \(aqZ\(aq.
63 function returns nonzero if
66 belonging to the wide-character class "upper".
67 Otherwise, it returns zero.
69 For an explanation of the terms used in this section, see
77 Interface Attribute Value
80 T} Thread safety MT-Safe locale
86 POSIX.1-2001, POSIX.1-2008, C99.
95 This function is not very appropriate for dealing with Unicode characters,
96 because Unicode knows about three cases: upper, lower, and title case.