toupper


function template
<locale>
template <class charT>
  charT toupper ( charT c, const locale& loc );

Convert lowercase letter to uppercase using locale

Converts parameter c to its uppercase equivalent if c is a lowercase letter and has an uppercase equivalent using ctype facet of locale loc. If no such conversion is possible, the value returned is c unchanged.

This function returns the same as a call to:

 
use_facet < ctype<charT> > (loc).toupper (c)


This function replicates the functionality of its C-library equivalent toupper. See toupper for more info.

Parameters

c
Character to be converted.
loc
Locale to be used. Shall have facet ctype present.


Template parameter charT is the character type.

Return Value

The uppercase equivalent to c, if any. Or c unchanged.

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
// toupper example (C++)
#include <iostream>
#include <string>
#include <locale>
using namespace std;

int main ()
{
  locale loc;
  string str="Test String.\n";
  for (size_t i=0; i<str.length(); ++i)
    cout << toupper(str[i],loc);
  return 0;
}


Output:

TEST STRING.


See also