wctrans(3)wctrans(3)NAMEwctrans - Map wide characters to a property
SYNOPSIS
#include <wctype.h>
wctrans_t wctrans(
const char *property );
LIBRARY
Standard C Library (libc)
STANDARDS
Interfaces documented on this reference page conform to industry stan‐
dards as follows:
wctrans(): XSH5.0
Refer to the standards(5) reference page for more information about
industry standards and associated tags.
PARAMETERS
Identifies a definition that maps one wide character to another in the
LC_TYPE category of a locale.
DESCRIPTION
The wctrans() function constructs a wctrans_t value that maps wide
characters in the current locale according to the specified property.
Because all locales include ASCII letter characters through the Porta‐
ble Character Set and because you can apply case conversion to ASCII
letter charaters, two properties that are valid for all locales are
toupper and tolower.
After a successful call to the wctrans() function to map associated
characters according to a specified property, you can call the towc‐
trans() function to convert characters according to this property.
Refer to the towctrans(3) reference page for an example that uses these
functions.
RESTRICTIONS
Currently, tolower and toupper are the only supported values for prop‐
erty. Defining additional properties in locales requires an extension
to the localedef utility. The rules for implementing this extension are
not yet available in current issues of the industry standards that
apply to this utility.
RETURN VALUES
If property identifies a wide-character mapping that is defined in the
LC_CTYPE category of the current locale, the wctrans() function returns
a nonzero value that is valid as the second argument of the towctrans()
function; otherwise, the wctrans() function returns zero.
SEE ALSO
Commands: localedef(1)
Functions: iswctype(3), towctrans(3), wctype(3)
Files: locale(4)wctrans(3)
