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  Locale specification.