function
<cwctype>

towctrans

wint_t towctrans(wint_t c, wctrans_t desc);
Convert using transformation
Applies a the transformation specified by desc to the wide character c.

A specific locale can accept multiple transformations for characters. At least the following transformations are recognized by all locales:

string passed to wctransdescriptionequivalent function
"tolower"to lowercasetowlower
"toupper"to uppercasetowupper

The setting of the LC_CTYPE locale category at the time of calling the function shall be the same as when wcttrans was called to obtain desc.

Parameters

c
Wide character to be transformed, casted to a wint_t value, or WEOF.
wint_t is an integral type.
desc
A value returned by a call to wctrans (with the same LC_CTYPE locale category selected as in this call).
wctrans_t is the scalar type used as return type for wctrans.

Return Value

The character transformation of 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
17
18
19
20
/* towctrans example */
#include <stdio.h>
#include <wctype.h>
int main ()
{
  int i=0;
  wchar_t str[] = L"Test String.\n";
  wchar_t c;
  wctype_t check = wctype("lower");
  wctrans_t trans = wctrans("toupper");
  while (str[i])
  {
    c = str[i];
    if (iswctype(c,check)) c = towctrans(c,trans);
    putwchar (c);
    i++;
  }
  return 0;
}


Output:
TEST STRING.

See also