towupper, towupper_l — convert a wide character to uppercase
towupper() function is
the wide-character equivalent of the toupper(3) function. If
wc is a lowercase
wide character, and there exists an uppercase equivalent in
the current locale, it returns the uppercase equivalent of
wc. In all other
wc is returned
performs the same task, but performs the conversion based on
the character type information in the locale specified by
locale. The behavior
towupper_l() is undefined if
locale is the special
(see duplocale(3)) or is not a
valid locale object handle.
must be representable as a wchar_t
and be a valid character in the locale or be the value
convertible to uppercase,
towupper() returns its uppercase
equivalent; otherwise it returns
For an explanation of the terms used in this section, see attributes(7).
||Thread safety||MT-Safe locale|
POSIX.1-2001 (XSI); present as an XSI extension in
POSIX.1-2008, but marked obsolete.
The behavior of these functions depends on the
LC_CTYPE category of the
These functions are not very appropriate for dealing with Unicode characters, because Unicode knows about three cases: upper, lower and title case.
This page is part of release 4.07 of the Linux
man-pages project. A
description of the project, information about reporting bugs,
and the latest version of this page, can be found at
and Copyright (C) 2014 Michael Kerrisk <mtk.manpagesgmail.com>
This is free documentation; you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 2 of
the License, or (at your option) any later version.
GNU glibc-2 source code and manual
Dinkumware C library reference http://www.dinkumware.com/
OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html