1 .\" and Copyright (C) 2014 Michael Kerrisk <mtk.manpages@gmail.com>
3 .\" %%%LICENSE_START(GPLv2+_DOC_ONEPARA)
4 .\" This is free documentation; you can redistribute it and/or
5 .\" modify it under the terms of the GNU General Public License as
6 .\" published by the Free Software Foundation; either version 2 of
7 .\" the License, or (at your option) any later version.
10 .\" References consulted:
11 .\" GNU glibc-2 source code and manual
12 .\" Dinkumware C library reference http://www.dinkumware.com/
13 .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
16 .TH TOWUPPER 3 2021-03-22 "GNU" "Linux Programmer's Manual"
18 towupper, towupper_l \- convert a wide character to uppercase
21 .B #include <wctype.h>
23 .BI "wint_t towupper(wint_t " wc );
24 .BI "wint_t towupper_l(wint_t " wc ", locale_t " locale );
28 Feature Test Macro Requirements for glibc (see
29 .BR feature_test_macros (7)):
42 function is the wide-character equivalent of the
47 is a lowercase wide character,
48 and there exists an uppercase equivalent in the current locale,
49 it returns the uppercase equivalent of
53 is returned unchanged.
57 function performs the same task,
58 but performs the conversion based on the character type information in
59 the locale specified by
65 is the special locale object
69 or is not a valid locale object handle.
73 must be representable as a
75 and be a valid character in the locale or be the value
80 was convertible to uppercase,
82 returns its uppercase equivalent;
88 function first appeared in glibc 2.3.
90 For an explanation of the terms used in this section, see
98 Interface Attribute Value
101 T} Thread safety MT-Safe locale
104 T} Thread safety MT-Safe
111 C99, POSIX.1-2001 (XSI);
112 present as an XSI extension in POSIX.1-2008, but marked obsolete.
117 The behavior of these functions depends on the
119 category of the locale.
121 These functions are not very appropriate for dealing with Unicode characters,
122 because Unicode knows about three cases: upper, lower, and title case.