ADC Home > Reference Library > Reference > Mac OS X > Mac OS X Man Pages
|
This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles. For more information about the manual page format, see the manual page for manpages(5). |
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 repre-sents represents sents 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 success-ful, successful, ful, 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 |