towlower()

convert wide character to lowercase 

Function


SYNOPSIS

#include <wctype.h>

wint_t towlower(wint_t wc);


DESCRIPTION

The 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.


RETURN VALUES

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


CONFORMANCE

ANSI/ISO 9899-1990/AM 1-1995.


MULTITHREAD SAFETY LEVEL

MT-Safe, with exceptions.

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


PORTING ISSUES

None.


AVAILABILITY

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


SEE ALSO

Functions:
iswlower(), iswupper(), setlocale(), towctrans(), towupper(), wctrans()


MKS Toolkit 9.2 Documentation Build 16.