NAME    [Toc]    [Back]

       wctrans - Map wide characters to a property

SYNOPSIS    [Toc]    [Back]

       #include <wctype.h>

       wctrans_t wctrans(
               const char *property );

LIBRARY    [Toc]    [Back]

       Standard C Library (libc)

STANDARDS    [Toc]    [Back]

       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    [Toc]    [Back]

       Identifies  a  definition  that maps one wide character to
       another in the LC_TYPE category of a locale.

DESCRIPTION    [Toc]    [Back]

       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.

RESTRICTIONS    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       Commands: localedef(1)

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

       Files: locale(4)



                                                       wctrans(3)