HP-UX Reference (11i v2 07/12) - 3 Library Functions A-M (vol 6)

c
conv(3C) conv(3C)
NAME
conv: toupper(), tolower(), _toupper(), _tolower(), toascii() - translate characters to uppercase, lowercase, or
7-bit ASCII
SYNOPSIS
#include <ctype.h>
int toupper(int c);
int tolower(int c);
int _toupper(int c);
int _tolower(int c);
int toascii(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.
The macros _toupper() and _tolower() are identical to toupper() and tolower(), respec-
tively.
toascii() yields its argument with all bits that are not part of a standard 7-bit ASCII character cleared;
it is intended for compatibility with other systems.
EXTERNAL INFLUENCES
Environment Variables
LC_CTYPE determines the translations to be done.
International Code Set Support
Single-byte character code sets are supported.
WARNINGS
toascii() is supplied both as a library function and as a macro defined in the
<ctype.h> header. To
obtain the library function, either use a
#undef to remove the macro definition or, if compiling in ANSI C
mode, enclose the function name in parenthesis or take its address. The following examples use the library
function for toascii() :
#include <ctype.h>
#undef toascii
main()
{
...
c1 = toascii(c);
...
}
or
#include <ctype.h>
main()
{
int (*conv_func)();
...
c1 = (toascii)(c);
...
conv_func = toascii;
...
}
HP-UX 11i Version 2: December 2007 Update − 1 − Hewlett-Packard Company 207