iswupper(3)

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
44       belonging 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
49       attributes(7).
50
51       ┌───────────┬───────────────┬────────────────┐
52       │Interface  │ Attribute     │ Value          │
53       ├───────────┼───────────────┼────────────────┤
54       │iswupper() │ Thread safety │ MT-Safe locale │
55       └───────────┴───────────────┴────────────────┘

CONFORMING TO

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

NOTES

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

COLOPHON

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