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

Guardian Native C Library Calls (t - z) towlower(3)
NAME
towlower - Translate uppercase to lowercase 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 towlower (
wint_t wc);
PARAMETER
wc Specifies the wide character to convert.
DESCRIPTION
The towlower() function converts the uppercase wide character specified by the wc parameter
into the corresponding lowercase wide character. The behavior of the towlower() 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 uppercase wide character that has a corresponding lowercase wide
character, that wide character is returned. Otherwise, the wc parameter is returned unchanged.
RELATED INFORMATION
Functions: toascii(3), tolower(3), toupper(3), towupper(3), setlocale(3).
527192-005 Hewlett-Packard Company 7−27