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

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

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