ctype::toupper

Converts a character or a range of characters to upper case.

CharType toupper(
    CharType ch
) const;
const CharType *toupper(
    CharType* first, 
    const CharType* last
) const;

Parameters

• ch
  The character to be converted to uppercase.

• first
  A pointer to the first character in the range of characters whose cases are to be converted.

• last
  A pointer to the character immediately following the last character in the range of characters whose cases are to be converted.

Return Value

The first member function returns the uppercase form of the parameter ch. If no uppercase form exists, it returns ch.

The second member function returns last.

Remarks

The first member function returns do_toupper(ch). The second member function returns do_toupper(first, last).

Example

// ctype_toupper.cpp
// compile with: /EHsc
#include <locale>
#include <iostream>
using namespace std;

int main( )   
{
   locale loc1 ( "German_Germany" );
   
   char string[] = "Hello, my name is John";

   use_facet<ctype<char> > ( loc1 ).toupper
      ( string, string + strlen(string) );
   cout << "The uppercase string is: " << string << endl;
}

The uppercase string is: HELLO, MY NAME IS JOHN

Requirements

Header: <locale>

Namespace: std

See Also

Reference

ctype Class

Other Resources

ctype Members

Change History

Date	History	Reason
March 2009	Corrected.	Customer feedback.