wctrans.md

description	title	ms.date	api_name	api_location	api_type	topic_type	f1_keywords	helpviewer_keywords	ms.assetid
Learn more about: wctrans	wctrans	11/04/2016	wctrans	msvcrt.dll msvcr80.dll msvcr90.dll msvcr100.dll msvcr100_clr0400.dll msvcr110.dll msvcr110_clr0400.dll msvcr120.dll msvcr120_clr0400.dll ucrtbase.dll api-ms-win-crt-convert-l1-1-0.dll	DLLExport	apiref	WCTYPE/wctrans wctrans	character codes, wctrans characters, codes characters, converting wctrans function	215404bf-6d60-489c-9ae9-880e6b586162

wctrans

Determines a mapping from one set of character codes to another.

Syntax

wctrans_t wctrans(
   const char *property
);

Parameters

property
A string that specifies one of the valid transformations.

Return value

If the LC_CTYPE category of the current locale doesn't define a mapping whose name matches the property string property, the function returns zero. Otherwise, it returns a nonzero value suitable for use as the second argument to a subsequent call to towctrans.

Remarks

This function determines a mapping from one set of character codes to another.

The following pairs of calls have the same behavior in all locales, but it's possible to define more mappings even in the "C" locale:

Function	Same As
tolower(c)	towctrans(c, wctrans("towlower"))
towupper(c)	towctrans(c, wctrans("toupper"))

Requirements

Routine	Required Header
wctrans	<wctype.h>

For more compatibility information, see Compatibility.

Example

// crt_wctrans.cpp
// compile with: /EHsc
// This example determines a mapping from one set of character
// codes to another.

#include <wchar.h>
#include <wctype.h>
#include <stdio.h>
#include <iostream>

int main()
{
    wint_t c = 'a';
    printf_s("%d\n",c);

    wctrans_t i = wctrans("toupper");
    printf_s("%d\n",i);

    wctrans_t ii = wctrans("towlower");
    printf_s("%d\n",ii);

    wchar_t wc = towctrans(c, i);
    printf_s("%d\n",wc);
}

97
1
0
65

See also

Data conversion
setlocale, _wsetlocale