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 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, 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
Mac OS X 10.8 - Generated Sat Sep 1 06:29:02 CDT 2012