*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> wctrans (3)              



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)

[ Back ]
 Similar pages
Name OS Title
towctrans Tru64 Convert a wide character according to a property defined in the current locale
wcsspn Linux advance in a wide-character string, skipping any of a set of wide characters
wmemset Linux fill an array of wide-characters with a constant wide character
wcspbrk Linux search a wide-character string for any of a set of wide characters
wcscspn Linux search a wide-character string for any of a set of wide characters
euc FreeBSD EUC encoding of wide characters
wmemmove Linux copy an array of wide-characters
wctype Tru64 Get a handle to classify wide characters
fgetws FreeBSD get a line of wide characters from a stream
wmemcpy Linux copy an array of wide-characters
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service