wctrans

C

Language

Headers

Type support

Program utilities

Variadic function support

Error handling

Dynamic memory management

Date and time utilities

Strings library

Algorithms

Numerics

Input/output support

Localization support

Atomic operations (C11)

Thread support (C11)

Technical Specifications

Strings library

Byte strings

Multibyte strings

Wide strings

Null-terminated wide strings

Functions
Character manipulation
iswalnum (C95) iswalpha (C95) iswlower (C95) iswupper (C95) iswdigit (C95) iswxdigit (C95) iswblank (C99) wctype (C95) iswctype (C95)	iswcntrl (C95) iswgraph (C95) iswspace (C95) iswprint (C95) iswpunct (C95) towlower (C95) towupper (C95) wctrans (C95) towctrans (C95)
Conversions to numeric formats
wcstolwcstoll (C95)(C99) wcstoulwcstoull (C95)(C99)	wcstofwcstodwcstold (C99)(C95)(C99) wcstoimaxwcstoumax (C99)(C99)
String manipulation
wcslenwcsnlen_s (C95)(C11) wcscpywcscpy_s (C95)(C11) wcsncpywcsncpy_s (C95)(C11) wcscatwcscat_s (C95)(C11) wcsncatwcsncat_s (C95)(C11) wcsstr (C95)	wcscmp (C95) wcsncmp (C95) wcscoll (C95) wcsxfrm (C95) wcschr (C95) wcsrchr (C95) wcspbrk (C95) wcsspn (C95) wcscspn (C95) wcstokwcstok_s (C95)(C11)
Array manipulation
wmemcpywmemcpy_s (C95)(C11) wmemmovewmemmove_s (C95)(C11)	wmemcmp (C95) wmemchr (C95) wmemset (C95)

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 "tojkana".

Parameters

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.

References

• C11 standard (ISO/IEC 9899:2011):

• 7.30.3.2.2 The wctrans function (p: 454)

• C99 standard (ISO/IEC 9899:1999):

• 7.25.3.2,2 The wctrans function (p: 400)

See also

towctrans (C95)

performs character mapping according to the specified LC_CTYPE mapping category (function)