wctrans(3) [xfree86 man page]
WCTRANS(3) Linux Programmer's Manual WCTRANS(3) NAME
wctrans - wide-character translation mapping SYNOPSIS
#include <wctype.h> wctrans_t wctrans(const char *name); DESCRIPTION
The wctrans_t type represents a mapping which can map a wide character to another wide character. Its nature is implementation-dependent, but the special value (wctrans_t) 0 denotes an invalid mapping. Nonzero wctrans_t values can be passed to the towctrans(3) function to actually perform the wide-character mapping. The wctrans() function returns a mapping, given by its name. The set of valid names depends on the LC_CTYPE category of the current locale, but the following names are valid in all locales. "tolower" - realizes the tolower(3) mapping "toupper" - realizes the toupper(3) mapping RETURN VALUE
The wctrans() function returns a mapping descriptor if the name is valid. Otherwise, it returns (wctrans_t) 0. ATTRIBUTES
For an explanation of the terms used in this section, see attributes(7). +----------+---------------+----------------+ |Interface | Attribute | Value | +----------+---------------+----------------+ |wctrans() | Thread safety | MT-Safe locale | +----------+---------------+----------------+ CONFORMING TO
POSIX.1-2001, POSIX.1-2008, C99. NOTES
The behavior of wctrans() depends on the LC_CTYPE category of the current locale. SEE ALSO
towctrans(3) COLOPHON
This page is part of release 4.15 of the Linux man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at https://www.kernel.org/doc/man-pages/. GNU 2015-08-08 WCTRANS(3)
Check Out this Related Man Page
WCTRANS(3) BSD Library Functions Manual WCTRANS(3) NAME
towctrans, towctrans_l, wctrans, wctrans_l -- wide character mapping functions LIBRARY
Standard C Library (libc, -lc) SYNOPSIS
#include <wctype.h> wint_t towctrans(wint_t wc, wctrans_t desc); wctrans_t wctrans(const char *charclass); #include <wctype.h> #include <xlocale.h> wint_t towctrans_l(wint_t wc, wctrans_t desc, locale_t loc); wctrans_t wctrans_l(const char *charclass, locale_t loc); DESCRIPTION
The wctrans() function returns a value of type wctrans_t, which represents the requested wide character mapping operation and may be used as the second argument for calls to towctrans(). The following character mapping names are recognised: tolower toupper The towctrans() function transliterates the wide character wc, according to the mapping described by desc. While the towctrans() and wctrans() functions use the current locale, the towctrans_l() and wctrans_l() functions may be passed locales directly. See xlocale(3) for more information. RETURN VALUES
The towctrans() function returns the transliterated character if successful, otherwise it returns the character unchanged and sets errno. The wctrans() function returns non-zero if successful, otherwise it returns zero and sets errno. EXAMPLES
Reimplement towupper() in terms of towctrans() and wctrans(): wint_t mytowupper(wint_t wc) { return (towctrans(wc, wctrans("toupper"))); } ERRORS
The towctrans() function will fail if: [EINVAL] The supplied desc argument is invalid. The wctrans() function will fail if: [EINVAL] The requested mapping name is invalid. SEE ALSO
tolower(3), toupper(3), wctype(3), xlocale(3) STANDARDS
The towctrans() and wctrans() functions conform to IEEE Std 1003.1-2001 (``POSIX.1''). HISTORY
The towctrans() and wctrans() functions first appeared in FreeBSD 5.0. BSD
October 3, 2002 BSD