TOUPPER(3) NEWLIB TOUPPER(3)NAME
3.14 `toupper'--translate characters to uppercase
SYNOPSIS
#include <ctype.h>
int toupper(int C);
int _toupper(int C);
DESCRIPTION
`toupper' is a macro which converts lowercase characters to uppercase,
leaving all other characters unchanged. It is only defined when C is
an integer in the range `EOF' to `255'.
You can use a compiled subroutine instead of the macro definition by
undefining this macro using ``#undef toupper''.
`_toupper' performs the same conversion as `toupper', but should
only be used when C is known to be a lowercase character (`a'-`z').
RETURNS
`toupper' returns the uppercase equivalent of C when it is a character
between `a' and `z', and C otherwise.
`_toupper' returns the uppercase equivalent of C when it is a char‐
acter between `a' and `z'. If C is not one of these characters, the
behaviour of `_toupper' is undefined.
PORTABILITY
`toupper' is ANSI C. `_toupper' is not recommended for portable pro‐
grams.
No supporting OS subroutines are required.
SEE ALSOtoupper is part of the library. The full documentation for is main‐
tained as a Texinfo manual. If info and are properly installed at your
site, the command
info
will give you access to the complete manual.
NEWLIB April 2010 TOUPPER(3)
