towlower(), towlower_l()

convert wide character to lowercase 

Function


SYNOPSIS

#include <wctype.h>

wint_t towlower(wint_t wc);

wint_t towlower_l(wint_t wc, locale_t locale);


DESCRIPTION

The towlower() (and towlower()) function converts an uppercase letter to the corresponding lowercase letter. The call towlower(wc) is equivalent to:

towctrans(wc, wctrans("tolower"));

PARAMETERS

wc 

Is a wide character code corresponding to a valid character in the current locale or the value of the macro WEOF.

locale 

Is a locale_t perhaps returned by newlocale() or LC_GLOBAL_LOCALE or 0 for the current thread locale set with uselocale().


RETURN VALUES

If the parameter is a wide character for which iswupper() (or iswupper_l()) is true and there is a corresponding wide character for which iswlower() (or iswupper_l()) is true, the towlower() (and towlower_l()) function returns the corresponding wide character. Otherwise, the parameter is returned unchanged.


CONFORMANCE

towlower() conforms to ANSI/ISO 9899-1990/AM 1-1995.


MULTITHREAD SAFETY LEVEL

MT-Safe, with exceptions.

The function towlower() is MT-Safe as long as no thread calls setlocale() while this function is executing.

The function towlower_l() is MT-Safe as long as no thread calls freelocale() on locale while this function is executing.


PORTING ISSUES

None.


AVAILABILITY

PTC MKS Toolkit for Professional Developers
PTC MKS Toolkit for Professional Developers 64-Bit Edition
PTC MKS Toolkit for Enterprise Developers
PTC MKS Toolkit for Enterprise Developers 64-Bit Edition


SEE ALSO

Functions:
iswlower(), iswlower_l(), iswupper(), iswupper_l(), newlocale(), setlocale(), towctrans(), towctrans_l(), towupper(), towupper_l(), wctrans(), wctrans_l()


PTC MKS Toolkit 10.3 Documentation Build 39.