Debian Codegraph @

upstream/debian-unstable/man3/iswupper.3

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