Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ towupper(3C) — SunOS 5.6

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

iswalpha(3C)

setlocale(3C)

towlower(3C)

attributes(5)

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
MT-Level MT-Safe
CSI Enabled

SEE ALSO

iswalpha(3C), setlocale(3C), towlower(3C), attributes(5)

SunOS 5.6  —  Last change: 20 Dec 1996

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026