function

wctrans

wctrans_t wctrans (const char* property);

Return character transformation

Returns a value of type wctrans_t that corresponds to the character transformation by property.

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

string passed as property	description	equivalent function
`"tolower"`	to lowercase	towlower
`"toupper"`	to uppercase	towupper

The value returned by this function depends on the LC_CTYPE locale category selected.

Parameters

property: A string identifying a character transformation (see above).

Return Value

A value of type wctrans_t identifying a specific character category.
This value is locale-dependent.

Example

/* wctrans 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;
}