toupper(3C)

NAME

     toupper - transliterate lower-case characters to upper-case

SYNOPSIS

     #include <ctype.h>

     int toupper(int c);

DESCRIPTION

     The toupper() function has as a domain a type int, the value
     of  which  is representable as an unsigned char or the value
     of EOF.  If the argument has any other value,  the  argument
     is   returned   unchanged.  If  the  argument  of  toupper()
     represents  a  lower-case  letter,  and   there   exists   a
     corresponding  upper-case  letter  (as  defined by character
     type information in the program locale category LC_CTYPE),
      the result is  the  corresponding  upper-case  letter.  All
     other arguments in the domain are returned unchanged.

RETURN VALUES

     On successful completion, toupper() returns  the  upper-case
     letter corresponding to the argument passed.

ERRORS

     No errors are defined.

ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    | MT-Level                    | MT-Safe                     |
    | CSI                         | Enabled                     |
    |_____________________________|_____________________________|

SEE ALSO

     _toupper(3C), setlocale(3C), attributes(5)