wctrans - Map wide characters to a property
const char *property );
Standard C Library (libc)
Interfaces documented on this reference page conform to
industry standards as follows:
Refer to the standards(5) reference page for more information
about industry standards and associated tags.
Identifies a definition that maps one wide character to
another in the LC_TYPE category of a locale.
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 Portable 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 towctrans() function to convert characters
according to this property. Refer to the towctrans(3)
reference page for an example that uses these functions.
Currently, tolower and toupper are the only supported values
for property. 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.
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.
Functions: iswctype(3), towctrans(3), wctype(3)
[ Back ]