towctrans()

transliterate wide character 

Function

SYNOPSIS

#include <wctype.h>

wint_t towctrans(wint_t wc, wctrans_t desc);

DESCRIPTION

The towctrans() function transliterates the specified wide character code using the specified mapping. The current setting of the LC_CTYPE locale category should be the same as during the call to wctrans() that returns the value of desc. If the value of desc is invalid (that is, not obtained by a call to wctrans() or desc is invalidated by a subsequent call to setlocale() that has affected the LC_CTYPE category), the result is undefined.

PARAMETERS

wc 

Is a wide character to transliterate.

desc 

Is the descriptor for the transliteration to be performed, as returned by wctrans().

RETURN VALUES

On success, towctrans() returns the mapped value of wc using the mapping described by desc. Otherwise it returns wc unchanged, and sets errno to one of the following values:

EINVAL 

desc contains an invalid transliteration descriptor.

CONFORMANCE

ANSI/ISO 9899-1990/AM 1-1995

MULTITHREAD SAFETY LEVEL

MT-Safe, with exceptions.

This function is MT-Safe as long as no thread calls setlocale() while this function is executing.

PORTING ISSUES

None.

AVAILABILITY

MKS Toolkit for Professional Developers
MKS Toolkit for Enterprise Developers
MKS Toolkit for Enterprise Developers 64-Bit Edition

SEE ALSO

Functions:
setlocale(), towlower(), towupper(), wctrans()

MKS Toolkit 9.2 Documentation Build 16.