*** UNIX MANUAL PAGE BROWSER ***

TOWCTRANS(3) FreeBSD Library Functions Manual TOWCTRANS(3) NAME towctrans, towctrans_l - convert a wide character with a specified map SYNOPSIS #include <wctype.h> wint_t towctrans(wint_t wc, wctrans_t charmap); wint_t towctrans_l(wint_t wc, wctrans_t charmap, locale_t locale); DESCRIPTION These functions convert the wide character wc with a character mapping charmap. The behaviour is undefined if charmap or wc is invalid. When charmap is retrieved with wctrans(3), it becomes invalid when the thread-specific character encoding locale is changed with uselocale(3) or when the global character encoding locale is changed with setlocale(3). When charmap is retrieved with wctrans_l(3), it is only valid for use with the same locale argument. RETURN VALUES These functions return the resulting wide character, or wc if there is no corresponding character in charmap. SEE ALSO iswctype(3), newlocale(3), setlocale(3), towlower(3), wctrans(3) STANDARDS The towctrans() function conforms to ISO/IEC 9899/AMD1:1995 ("ISO C90, Amendment 1"), and towctrans_l() to IEEE Std 1003.1-2008 ("POSIX.1"). HISTORY The towctrans() function has been available since OpenBSD 3.8, and towctrans_l() since OpenBSD 6.2. FreeBSD 14.1-RELEASE-p8 September 5, 2017 FreeBSD 14.1-RELEASE-p8