TOWUPPER(3C) Standard C Library Functions TOWUPPER(3C)

NAME

towupper, towupper_l - transliterate lower-case wide characters to
upper-case

SYNOPSIS

#include <wctype.h>

wint_t towupper(wint_t wc);

wint_t towupper_l(wint_t wc, locale_t loc);

DESCRIPTION

The function towupper() is the wide character equivalent of the
function toupper(3C). It converts the lower-case wide character wc
to the equivalent upper-case wide character, if one exists. If one
does not exist, it returns wc unchanged.

The function towupper_l() is equivalent to the function towupper(),
but instead of operating in the current locale, operates in the
locale specified by loc.

RETURN VALUES

On successful completion, towupper() and towupper_l() return the
upper-case character that corresponds to the argument passed.
Otherwise, they return the argument unchanged.

ERRORS

No errors are defined.

ATTRIBUTES

+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+

SEE ALSO

newlocale(3C), setlocale(3C), toupper(3C), uselocale(3C), locale(7)

June 21, 2014 TOWUPPER(3C)