Share via


wctrans

 

The latest version of this topic can be found at 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 does not 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 is possible to define additional 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 additional compatibility information, see Compatibility in the Introduction.

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