The Single UNIX ® Specification, Version 2
Copyright © 1997 The Open Group

 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 .

UNIX ® is a registered Trademark of The Open Group.
Copyright © 1997 The Open Group
[ Main Index | XSH | XCU | XBD | XCURSES | XNS ]