Guardian Native C Library Calls Reference Manual (G06.28+, H06.05+)

Guardian Native C Library Calls (t - z) towupper(3)
NAME
towupper - Translates lowercase to uppercase wide characters
LIBRARY
G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL
G-series native OSS processes: /G/system/sysnn/zcrtlsrl
H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL
H-series OSS processes: /G/system/zdllnnn/zcrtldll
SYNOPSIS
#include <wchar.h>
wint_t towupper (
wint_t wc);
PARAMETER
wc Specifies the wide character to convert.
DESCRIPTION
The towupper( ) function converts the lowercase wide character specified by the wc parameter
into the corresponding uppercase wide character. The behavior of the towupper( ) function is
affected by the LC_CTYPE category of the program’s locale. In a locale where case conversion
information is not defined, this function determines the case of characters according to the rules
of the C locale.
RETURN VALUES
If the wc parameter contains a lowercase wide character that has a corresponding uppercase wide
character, that wide character is returned. Otherwise, the wc parameter is returned unchanged.
RELATED INFORMATION
Functions: toascii(3), tolower(3), toupper(3), towlower(3), setlocale(3).
527192-007 Hewlett-Packard Company 7−33