1ISWUPPER(3)                Linux Programmer's Manual               ISWUPPER(3)
2
3
4

NAME

6       iswupper - test for uppercase wide character
7

SYNOPSIS

9       #include <wctype.h>
10
11       int iswupper(wint_t wc);
12

DESCRIPTION

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

RETURN VALUE

43       The  iswupper()  function returns nonzero if wc is a wide character be‐
44       longing to the wide-character class  "upper".   Otherwise,  it  returns
45       zero.
46

ATTRIBUTES

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

CONFORMING TO

58       POSIX.1-2001, POSIX.1-2008, C99.
59

NOTES

61       The behavior of iswupper() depends on the LC_CTYPE category of the cur‐
62       rent locale.
63
64       This  function is not very appropriate for dealing with Unicode charac‐
65       ters, because Unicode knows about three cases: upper, lower, and  title
66       case.
67

SEE ALSO

69       isupper(3), iswctype(3), towupper(3)
70

COLOPHON

72       This  page  is  part of release 5.13 of the Linux man-pages project.  A
73       description of the project, information about reporting bugs,  and  the
74       latest     version     of     this    page,    can    be    found    at
75       https://www.kernel.org/doc/man-pages/.
76
77
78
79GNU                               2021-03-22                       ISWUPPER(3)
Impressum