Section: Linux Programmer's Manual (3)
Return to Main Contents
towupper, towupper_l - convert a wide character to uppercase
wint_t towupper(wint_t wc);
wint_t towupper_l(wint_t wc, locale_t locale);
Feature Test Macro Requirements for glibc (see
- Since glibc 2.10:
_XOPEN_SOURCE >= 700
- Before glibc 2.10:
function is the wide-character equivalent of the
is a lowercase wide character,
and there exists an uppercase equivalent in the current locale,
it returns the uppercase equivalent of
In all other cases,
is returned unchanged.
function performs the same task,
but performs the conversion based on the character type information in
the locale specified by
The behavior of
is undefined if
is the special locale object
or is not a valid locale object handle.
must be representable as a
and be a valid character in the locale or be the value
was convertible to uppercase,
returns its uppercase equivalent;
otherwise it returns
Multithreading (see pthreads(7))
function is thread-safe with exceptions.
It can be safely used in multithreaded applications, as long as
is not called to change the locale during its execution.
function first appeared in glibc 2.3.
C99, POSIX.1-2001 (XSI);
present as an XSI extension in POSIX.1-2008, but marked obsolete.
The behavior of these functions depends on the
category of the locale.
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 3.74 of the Linux
A description of the project,
information about reporting bugs,
and the latest version of this page,
can be found at
- RETURN VALUE
- Multithreading (see pthreads(7))
- CONFORMING TO
- SEE ALSO