C++ Locale Library - toupper


It converts to uppercase and internally, this function simply calls the virtual protected member do_toupper, which does the above by default in both the generic template and the char specialization (ctype<char>).


Following is the declaration for std::ctype::toupper.


char_type toupper (char_type c) const;


char_type toupper (char_type c) const;


  • m − It is a bitmask of member type mask.

  • low,high − It is a pointer to the beginning and end of the sequence of characters.

Return Value

It returns the uppercase equivalent of c.


If an exception is thrown, there are no changes in the facet object, although characters in the range may have been affected.

Data races

The object, and the elements in the range [low,high), are accessed.


In below example explains about std::ctype::toupper.

#include <iostream>
#include <locale>

int main () {
   std::locale loc;

   char site[] = "Tutorialspoint.com";

   std::cout << "The first letter of " << site << " as an uppercase is: ";
   std::cout << std::use_facet< std::ctype<char> >(loc).toupper(*site);
   std::cout << '\n';

   std::cout << "The result of converting " << site << " to uppercase is: ";
   std::use_facet< std::ctype<char> >(loc).toupper ( site, site+sizeof(site) );
   std::cout << site << '\n';

   return 0;

Let us compile and run the above program, this will produce the following result −

The first letter of Tutorialspoint.com as an uppercase is: T
The result of converting Tutorialspoint.com to uppercase is: TUTORIALSPOINT.COM