TOWLOWER(3C) Standard C Library Functions TOWLOWER(3C)

NAME

towlower, towlower_l - transliterate upper-case wide characters to
lower-case

SYNOPSIS

#include <wctype.h>

wint_t towlower(wint_t wc);

wint_t towlower_l(wint_t wc, locale_t loc);

DESCRIPTION

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

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

RETURN VALUES

On successful completion, towlower() and towlower_l() return the
lower-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), towupper(3C), uselocale(3C), locale(7)

June 21, 2014 TOWLOWER(3C)