NAME

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

SYNOPSIS

#include <wctype.h>

wint_t towupper(wint_t wc);

DESCRIPTION

The towupper() 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 towupper() represents a lower-case wide-character code, and there exists a corresponding upper-case wide-character code (as defined by character type information in the program locale category LC_CTYPE), the result is the corresponding upper-case wide-character code. All other arguments in the domain are returned unchanged.

RETURN VALUE

Upon successful completion, towupper() returns the upper-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.