towupper(3C) Standard C Library Functions towupper(3C)
NAME
towupper - transliterate lower-case wide-character code to upper-case
SYNOPSIS
#include <wchar.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
argument is returned unchanged. If the argument of towupper() represents a lower-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 VALUES
Upon successful completion, towupper() returns the upper-case letter corresponding to the argument passed. Otherwise, it returns the argu-
ment unchanged.
ERRORS
No errors are defined.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|CSI |Enabled |
+-----------------------------+-----------------------------+
|Interface Stability |Standard |
+-----------------------------+-----------------------------+
|MT-Level |MT-Safe |
+-----------------------------+-----------------------------+
SEE ALSO
iswalpha(3C), setlocale(3C), towlower(3C), attributes(5), standards(5)
SunOS 5.10 14 Aug 2002 towupper(3C)
