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

tolower(3) Guardian Native C Library Calls Reference Manual
NAME
tolower - Translates uppercase characters to lowercase
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 <ctype.h>
int tolower (
int c);
PARAMETERS
c Specifies the character to be converted.
DESCRIPTION
The tolower() function translates all characters, including multibyte characters, to their specified
character values.
The tolower() function takes an int value that can be represented as an unsigned char or the
value of EOF (defined in the stdio.h header file) as its input.
When the input of the tolower() function expresses an uppercase letter, as defined by character
type information in the program locale (category LC_CTYPE), the corresponding lowercase
letter is returned. All other input values in the domain are returned unchanged. The tolower()
function has as its domain the range -1 through 255.
NOTES
In the C locale, or in a locale where case-conversion information is not defined, the tolower()
function determines the case of characters according to the rules of the ASCII-coded character
set. Characters outside the ASCII range of characters are returned unchanged.
The _tolower() macro is equivalent to the tolower() function, but executes faster.
The LC_CTYPE category of the setlocale() function affects all conversions. See the setlo-
cale() function for more information.
RETURN VALUES
When the c parameter is a character for which the isupper() function is TRUE, there is a
corresponding character for which the islower() function is also TRUE. That lowercase charac-
ter is returned by the tolower() function. Otherwise, the c parameter is returned.
RELATED INFORMATION
Functions: setlocale(3), _tolower(3), toupper(3), _toupper(3).
7−24 Hewlett-Packard Company 527192-005