wctrans(3C)
NAME
wctrans - define character mapping
SYNOPSIS
#include <wctype.h>
wctrans_t wctrans(const char *charclass);
DESCRIPTION
The wctrans() function is defined for valid character map-
ping names identified in the current locale. The charclass
is a string identifying a generic character mapping name for
which codeset-specific information is required. The follow-
ing character mapping names are defined in all locales -
"tolower" and "toupper".
The function returns a value of type wctrans_t, which can be
used as the second argument to subsequent calls of
towctrans(3C). The wctrans() function determines values of
wctrans_t according to the rules of the coded character set
defined by character mapping information in the program's
locale (category LC_CTYPE). The values returned by wctrans()
are valid until a call to setlocale(3C) that modifies the
category LC_CTYPE.
RETURN VALUES
The wctrans() function returns 0 if the given character map-
ping name is not valid for the current locale (category
LC_CTYPE), otherwise it returns a non-zero object of type
wctrans_t that can be used in calls to towctrans(3C).
ERRORS
The wctrans() function may fail if:
EINVAL
The character mapping name pointed to by charclass is
not valid in the current locale.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| MT-Level | MT-Safe with exceptions |
|_____________________________|_____________________________|
| CSI | Enabled |
|_____________________________|_____________________________|
SEE ALSO
setlocale(3C), towctrans(3C), attributes(5)
Man(1) output converted with
man2html