function
<cwctype>

towupper

wint_t towupper (wint_t c);
Convert lowercase wide character to uppercase
Converts c to its uppercase equivalent if c is a lowercase letter and has an uppercase equivalent. If no such conversion is possible, the value returned is c unchanged.

Notice that what is considered a letter may depend on the locale being used.

If a lowercase character has more than one correspondent uppercase character, this function always returns the same character for the same value of c.

This function is the wide-character equivalent of toupper (<cctype>).

In C++, a locale-specific template version of this function (toupper) exists in header <locale> for all character types.

Parameters

c
Wide character to be converted, casted to a wint_t value, or WEOF.
wint_t is an integral type.

Return Value

The uppercase equivalent to c, if such value exists, or c (unchanged) otherwise.
The value is returned as a wint_t value that can be implicitly casted to wchar_t.

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
/* towupper example */
#include <stdio.h>
#include <wctype.h>
int main ()
{
  int i=0;
  wchar_t str[] = L"Test String.\n";
  wchar_t c;
  while (str[i])
  {
    c = str[i];
    putwchar (towupper(c));
    i++;
  }
  return 0;
}

Output:
TEST STRING.


See also