C++ Locale Library - toupper

---

---

Description

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>).

Declaration

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

C++98

	
char_type toupper (char_type c) const;

C++11

char_type toupper (char_type c) const;

Parameters

• 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.

Exceptions

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.

Example

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