OSF

NAME

toascii, tolower, _tolower, toupper, _toupper − Translates characters

LIBRARY

Standard C Library (libc.a)

SYNOPSIS

#include <ctype.h>

int toascii(
    int c) ;

int tolower(
    int c) ;

int _tolower(
    int c) ;

int toupper(
    int c) ;

int _toupper(
    int c) ;

PARAMETERS

cSpecifies the character to be converted. 

DESCRIPTION

The toascii(), tolower(), _tolower(), toupper(), and _toupper() functions translate all characters, including extended characters, to their specified character values. 

The toascii() function converts its input to a 7-bit ASCII character. 

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. 

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 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. 

The _toupper() macro is equivalent to the toupper() function, but executes faster. 

NOTES

The setlocale() function affects all conversions.  See the setlocale() function for more information. 

AES Support Level:
Full use (tolower(), toupper())
Trial use (_tolower(), _toupper(), toascii())

RETURN VALUES

The toascii() function returns the logical AND of parameter c and the value 0X7F. 

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 character is returned by the tolower() function or by the _tolower() macro. Otherwise the c parameter is returned. 

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 character is returned by the toupper() function or by the _toupper() macro. Otherwise, the c parameter is returned. 

RELATED INFORMATION

Functions: ctype(3), setlocale(3)