towctrans(3C)towctrans(3C)NAMEtowctrans(), wctrans() - character transliteration
SYNOPSISDESCRIPTION
The function transliterates the wide-character code wc using
the mapping described by desc. The current setting of
the category should be the same as during the call to
that returned the value desc. If the value of desc is
invalidated (that is, not obtained by a call to or desc
is invalidated by a subsequent call to that has affected
category the result is undefined.
The function is defined for valid character mapping 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
following character mapping names are defined in all
locales - "tolower" and "toupper". The function returns
a value of type which can be used as the second argument
to subsequent calls of The function determines values of
according to the rules of the coded character set
defined by character mapping information in the pro‐
gram's locale (category The values returned by are valid
until a call to that modifies the category
APPLICATION USAGE
The strings "tolower" and "toupper" are reserved for the standard map‐
ping names. In the table below, the functions in the left column are
equivalent to the functions in the right column.
The prototypes of these functions are
available to applications
if they are:
a. conformant.
b. Compiled with macro with a value >=500.
c. Compiled with macro with a value >= 200112.
RETURN VALUE
If successful, the function returns the mapped value of
wc using the mapping described by desc. Otherwise it
returns wc unchanged.
The function returns (wchar_t)0 if the given character
mapping name is not valid for the current locale (cate‐
gory otherwise it returns a non-zero object of type that
can be used in calls to
ERRORS
The function may fail if:
desc contains an invalid transliteration
descriptor.
The function may fail if:
The character mapping name pointed to by
charclass is not valid in the cur‐
rent locale.
AUTHOR
were developed by HP and Mitsubishi Electric Corporation.
SEE ALSOwconv(3C), thread_safety(5).
towctrans(3C)