NAME

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

SYNOPSIS

#include <ctype.h>

int toupper (c)
int c;

int tolower (c)
int c;

int _toupper (c)
int c;

int _tolower (c)
int c;

int toascii (c)
int c;

DESCRIPTION

Toupper and tolower have as domain the range of getc(3S): the integers from −1 through 255. If the argument of toupper represents a lowercase letter, the result is the corresponding uppercase letter.  If the argument of tolower represents an uppercase letter, the result is the corresponding lowercase letter.  All other arguments in the domain are returned unchanged.  Arguments outside the domain cause undefined results. 

Toupper and tolower perform their translations based upon the currently loaded NLS environment (see nl_init(3C)).

The macros _toupper and _tolower perform the same translations as toupper and tolower, but have restricted domains and are faster.  The domains of _toupper and _tolower are the integers from 0 through 255.  Arguments outside of the domain cause undefined results. 

Toascii yields its argument with all bits turned off that are not part of a standard 7-bit ASCII character; it is intended for compatibility with other systems. 

DEPENDENCIES

Series 300, 500
The macros _toupper and _tolower are guaranteed only for ASCII values.  Arguments outside the domain of ASCII values cause undefined results. 

AUTHOR

Conv(3C) was developed by AT&T and HP.

SEE ALSO

ctype(3C), getc(3S), nl_init(3C). 

INTERNATIONAL SUPPORT

8-bit data. 

Hewlett-Packard Company  —  Version B.1,  May 11, 2021