NAME

towlower - transliterate upper-case wide-character code to lower-case

 SYNOPSIS

#include <wctype.h>

wint_t towlower(wint_t wc);

 DESCRIPTION

The towlower() function has as a domain a type wint_t, the value of which must be a character representable as a wchar_t, and must be a wide-character code corresponding to a valid character in the current locale or the value of WEOF. If the argument has any other value, the behaviour is undefined. If the argument of towlower() represents an upper-case wide-character code, and there exists a corresponding lower-case wide-character code (as defined by character type information in the program locale category LC_CTYPE), the result is the corresponding lower-case wide-character code. All other arguments in the domain are returned unchanged.

 RETURN VALUE

On successful completion, towlower() returns the lower-case letter corresponding to the argument passed; otherwise it returns the argument unchanged.

 ERRORS

No errors are defined.

 EXAMPLES

None.

 APPLICATION USAGE

None.

 FUTURE DIRECTIONS

None.

 SEE ALSO

setlocale(), <wctype.h>, <wchar.h>, the XBD specification, Locale .