Section: Linux Programmer's Manual (3)
Return to Main Contents
towlower, towlower_l - convert a wide character to lowercase
wint_t towlower(wint_t wc);
wint_t towlower_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 an uppercase wide character,
and there exists a lowercase equivalent in the current locale,
it returns the lowercase 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 lowercase,
returns its lowercase 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