toupper _toupper, towupper

Convert character to uppercase.

int toupper( int c );

int _toupper( int c );

int towupper( wint_t c );

For additional compatibility information, see Compatibility in the Introduction.

Libraries

Return Value

Each of these routines converts a copy of c, if possible, and returns the result.

If c is a wide character for which iswlower is true and there is a corresponding wide character for which iswupper is true, towupper returns the corresponding wide character; otherwise, towupper returns c unchanged.

There is no return value reserved to indicate an error.

Parameter

c

Character to convert

Remarks

Each of these routines converts a given lowercase letter to an uppercase letter if possible and appropriate.

Data Conversion Routines

See Also   is Routines, to Functions Overview

Example

/* TOUPPER.C: This program uses toupper and tolower to
 * analyze all characters between 0x0 and 0x7F. It also
 * applies _toupper and _tolower to any code in this
 * range for which these functions make sense.
 */

#include <conio.h>
#include <ctype.h>
#include <string.h>

char msg[] = "Some of THESE letters are Capitals\r\n";
char *p;

void main( void )
{
   _cputs( msg );

   /* Reverse case of message. */
   for( p = msg; p < msg + strlen( msg ); p++ )
   {
      if( islower( *p ) )
         _putch( _toupper( *p ) );
      else if( isupper( *p ) )
         _putch( _tolower( *p ) );
      else
         _putch( *p );
   }
}

Output

Some of THESE letters are Capitals
sOME OF these LETTERS ARE cAPITALS