Go to main content

man pages section 3: Basic Library Functions

Exit Print View

Updated: July 2017
 
 

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 argument 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)