osf1 man page for wctrans

wctrans(3)						     Library Functions Manual							wctrans(3)

NAME
       wctrans - Maps wide characters to a property

LIBRARY
       Standard C Library (libc)

SYNOPSIS
       #include <wctype.h>

       wctrans_t wctrans(
	       const char *property);

STANDARDS
       Interfaces documented on this reference page conform to industry standards 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 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 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 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.

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.

RELATED INFORMATION
       Commands: localedef(1)

       Functions: iswctype(3), towctrans(3), wctype(3)

       Files: locale(4) delim off

																	wctrans(3)