2 .\" and Copyright (C) 2014 Michael Kerrisk <mtk.manpages@gmail.com>
4 .\" %%%LICENSE_START(GPLv2+_DOC_ONEPARA)
5 .\" This is free documentation; you can redistribute it and/or
6 .\" modify it under the terms of the GNU General Public License as
7 .\" published by the Free Software Foundation; either version 2 of
8 .\" the License, or (at your option) any later version.
11 .\" References consulted:
12 .\" GNU glibc-2 source code and manual
13 .\" Dinkumware C library reference http://www.dinkumware.com/
14 .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
17 .TH TOWUPPER 3 2014-03-18 "GNU" "Linux Programmer's Manual"
19 towupper, towupper_l \- convert a wide character to uppercase
22 .B #include <wctype.h>
24 .BI "wint_t towupper(wint_t " wc );
26 .BI "wint_t towupper_l(wint_t " wc ", locale_t " locale );
30 Feature Test Macro Requirements for glibc (see
31 .BR feature_test_macros (7)):
39 _XOPEN_SOURCE\ >=\ 700
48 function is the wide-character equivalent of the
53 is a lowercase wide character,
54 and there exists an uppercase equivalent in the current locale,
55 it returns the uppercase equivalent of
59 is returned unchanged.
63 function performs the same task,
64 but performs the conversion based on the character type information in
65 the locale specified by
71 is the special locale object
75 or is not a valid locale object handle.
79 must be representable as a
81 and be a valid character in the locale or be the value
86 was convertible to uppercase,
88 returns its uppercase equivalent;
92 .SS Multithreading (see pthreads(7))
95 function is thread-safe with exceptions.
96 It can be safely used in multithreaded applications, as long as
98 is not called to change the locale during its execution.
99 .\" FIXME . need a thread-safety statement about towupper_l()
103 function first appeared in glibc 2.3.
106 C99, POSIX.1-2001 (XSI);
107 present as an XSI extension in POSIX.1-2008, but marked obsolete.
112 The behavior of these functions depends on the
114 category of the locale.
116 These functions are not very appropriate for dealing with Unicode characters,
117 because Unicode knows about three cases: upper, lower and title case.
124 This page is part of release 3.79 of the Linux
127 A description of the project,
128 information about reporting bugs,
129 and the latest version of this page,
131 \%http://www.kernel.org/doc/man\-pages/.