man3/iswupper.3

   1 '\" t
   2 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
   3 .\"
   4 .\" SPDX-License-Identifier: GPL-2.0-or-later
   5 .\"
   6 .\" References consulted:
   7 .\"   GNU glibc-2 source code and manual
   8 .\"   Dinkumware C library reference http://www.dinkumware.com/
   9 .\"   OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
  10 .\"   ISO/IEC 9899:1999
  11 .\"
  12 .TH iswupper 3 (date) "Linux man-pages (unreleased)"
  13 .SH NAME
  14 iswupper \- test for uppercase wide character
  15 .SH LIBRARY
  16 Standard C library
  17 .RI ( libc ", " \-lc )
  18 .SH SYNOPSIS
  19 .nf
  20 .B #include <wctype.h>
  21 .P
  22 .BI "int iswupper(wint_t " wc );
  23 .fi
  24 .SH DESCRIPTION
  25 The
  26 .BR iswupper ()
  27 function is the wide-character equivalent of the
  28 .BR isupper (3)
  29 function.
  30 It tests whether
  31 .I wc
  32 is a wide character
  33 belonging to the wide-character class "upper".
  34 .P
  35 The wide-character class "upper" is a subclass of the wide-character class
  36 "alpha", and therefore also a subclass of the wide-character class "alnum", of
  37 the wide-character class "graph" and of the wide-character class "print".
  38 .P
  39 Being a subclass of the wide-character class "print", the wide-character class
  40 "upper" is disjoint from the wide-character class "cntrl".
  41 .P
  42 Being a subclass of the wide-character class "graph", the wide-character class
  43 "upper" is disjoint from the wide-character class "space" and its subclass
  44 "blank".
  45 .P
  46 Being a subclass of the wide-character class "alnum", the wide-character class
  47 "upper" is disjoint from the wide-character class "punct".
  48 .P
  49 Being a subclass of the wide-character class "alpha", the wide-character class
  50 "upper" is disjoint from the wide-character class "digit".
  51 .P
  52 The wide-character class "upper" contains at least those characters
  53 .I wc
  54 which are equal to
  55 .I towupper(wc)
  56 and different from
  57 .IR towlower(wc) .
  58 .P
  59 The wide-character class "upper" always contains at least the
  60 letters \[aq]A\[aq] to \[aq]Z\[aq].
  61 .SH RETURN VALUE
  62 The
  63 .BR iswupper ()
  64 function returns nonzero if
  65 .I wc
  66 is a wide character
  67 belonging to the wide-character class "upper".
  68 Otherwise, it returns zero.
  69 .SH ATTRIBUTES
  70 For an explanation of the terms used in this section, see
  71 .BR attributes (7).
  72 .TS
  73 allbox;
  74 lbx lb lb
  75 l l l.
  76 Interface       Attribute       Value
  77 T{
  78 .na
  79 .nh
  80 .BR iswupper ()
  81 T}      Thread safety   MT-Safe locale
  82 .TE
  83 .SH STANDARDS
  84 C11, POSIX.1-2008.
  85 .SH HISTORY
  86 POSIX.1-2001, C99.
  87 .SH NOTES
  88 The behavior of
  89 .BR iswupper ()
  90 depends on the
  91 .B LC_CTYPE
  92 category of the
  93 current locale.
  94 .P
  95 This function is not very appropriate for dealing with Unicode characters,
  96 because Unicode knows about three cases: upper, lower, and title case.
  97 .SH SEE ALSO
  98 .BR isupper (3),
  99 .BR iswctype (3),
 100 .BR towupper (3)