Defined in header <wctype.h>
wctrans_t wctrans( const char* str );
(since C95)

Constructs a value of type wctrans_t that describes a LC_CTYPE category of wide character mapping. It may be one of the standard mappings, or a locale-specific mapping, such as "tojhira" or "tojkata".


str - C string holding the name of the desired mapping.

The following values of str are supported in all C locales:

Value of str Effect
"toupper" identifies the mapping used by towupper
"tolower" identifies the mapping used by towlower

Return value

wctrans_t object suitable for use with towctrans to map wide characters according to the named mapping of the current C locale or zero if str does not name a mapping supported by the current C locale.


  • C11 standard (ISO/IEC 9899:2011):
    • The wctrans function (p: 454)
  • C99 standard (ISO/IEC 9899:1999):
    •,2 The wctrans function (p: 400)

See also

performs character mapping according to the specified LC_CTYPE mapping category
C++ documentation for wctrans

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.