NAME
towlower,
towlower_l, towupper,
towupper_l —
wide-character case letter conversion
utilities
SYNOPSIS
#include
<wctype.h>
wint_t
towlower(wint_t
wc);
wint_t
towlower_l(wint_t
wc, locale_t
locale);
wint_t
towupper(wint_t
wc);
wint_t
towupper_l(wint_t
wc, locale_t
locale);
DESCRIPTION
The
towlower()
and towlower_l() functions convert an upper-case
wide character to the corresponding lower-case letter. The
towupper()
and towupper_l() functions convert a lower-case wide
character to the corresponding upper-case letter.
The functions
towlower_l()
and
towupper_l()
use the specified locale, whereas
towlower() and towupper()
use the thread-specific locale set with
uselocale(3), falling back to the global locale set with
setlocale(3).
RETURN VALUES
These functions return the corresponding character, if any. Otherwise, wc is returned unchanged.
SEE ALSO
STANDARDS
The functions towlower() and
towupper() conform to ISO/IEC
9899/AMD1:1995 (“ISO C90, Amendment 1”) and
ISO/IEC 9899:1999 (“ISO C99”),
and towlower_l() and
towupper_l() to IEEE Std
1003.1-2008 (“POSIX.1”).
HISTORY
The functions towlower() and
towupper() have been available since
OpenBSD 3.8, and
towlower_l() and
towupper_l() since OpenBSD
6.2.