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

Guardian Native C Library Calls (t - z) toupper(3)
NAME
toupper - Translates lowercase characters to uppercase 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 <ctype.h>
int toupper (
int c);
PARAMETERS
c Specifies the character to be converted.
DESCRIPTION
The toupper() function translates all characters, including multibyte characters, to their
specified character values.
The toupper() 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 toupper( ) function expresses a lowercase letter, as defined by character
type information in the program locale (category LC_CTYPE), the corresponding uppercase
letter is returned. All other input values in the domain are returned unchanged. The toupper()
function has as its domain the range -1 through 255.
In the C locale, or in a locale where case-conversion information is not defined, the toupper()
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.
NOTES
The _toupper( ) macro is equivalent to the toupper( ) 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 islower() function is TRUE, there is a
corresponding character for which the isupper( ) function is also TRUE. That uppercase charac-
ter is returned by the toupper( ) function. Otherwise, the c parameter is returned.
RELATED INFORMATION
Functions: setlocale(3), tolower(3), _tolower(3), _toupper(3).
527192-007 Hewlett-Packard Company 7−31