Next: wctrans, Previous: towupper, Up: Ctype [Contents][Index]

### 3.32 `towctrans`, `towctrans_l`—extensible wide-character translation

Synopsis

    #include <wctype.h>
    wint_t towctrans(wint_t c, wctrans_t w);

    #include <wctype.h>
    wint_t towctrans_l(wint_t c, wctrans_t w, locale_t locale);

Description
`towctrans` is a function which converts wide characters based on a specified translation type w. If the translation type is invalid or cannot be applied to the current character, no change to the character is made.

`towctrans_l` is like `towctrans` but performs the function based on the locale specified by the locale object locale. If locale is LC_GLOBAL_LOCALE or not a valid locale object, the behaviour is undefined.

Returns
`towctrans`, `towctrans_l` return the translated equivalent of c when it is a valid for the given translation, otherwise, it returns the input character. When the translation type is invalid, `errno` is set to `EINVAL`.

Portability
`towctrans` is C99. `towctrans_l` is POSIX-1.2008.

No supporting OS subroutines are required.