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

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



NAME    [Toc]    [Back]

       towctrans  - Convert a wide character according to a property
 defined in the current locale

SYNOPSIS    [Toc]    [Back]

       #include <wctype.h>

       wint_t towctrans(
               wint_t wc,
               wctrans_t conversion_handle );

LIBRARY    [Toc]    [Back]

       Standard C Library (libc)

STANDARDS    [Toc]    [Back]

       Interfaces documented on this reference  page  conform  to
       industry standards as follows:

       towctrans(): ISO C

       Refer to the standards(5) reference page for more information
 about industry standards and associated tags.

PARAMETERS    [Toc]    [Back]

       Specifies a wide-character value Calls the wctrans() function
  to  return the wide character mapped to wc according
       to a valid property in the LC_CTYPE category of  the  current

DESCRIPTION    [Toc]    [Back]

       The  towctrans()  function  maps  a  wide character to its
       counterpart value according to a specified  property,  for
       example,  tolower or toupper.  Before calling towctrans(),
       you must call wctrans() to determine if  the  property  is
       valid  for  the  current locale and to create a handle for
       the property map. You then call towctrans() to return  the
       wide-character  value that corresponds to the wide-character
 value specified by wc. The following example  shows  a
       call  to towctrans() that returns the lowercase equivalent
       of wc:

       towctrans(wc, wctrans("tolower"));

       The preceding call is equivalent to the following call:


       Unlike the towlower() and towupper() functions, which deal
       specifically   with   case  mapping,  the  combination  of
       wctrans() and towctrans() functions  are  designed  to  be
       used  with  other  properties  that  can  be  defined in a

RESTRICTIONS    [Toc]    [Back]

       Currently, tolower and  toupper  are  the  only  supported
       property values. 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]

       The  towctrans()  function  returns the mapped value of wc
       according to the mapping described  by  conversion_handle.
       If EOF is encountered or conversion_handle cannot be used,
       the function returns 0 (zero).

EXAMPLES    [Toc]    [Back]

       The following example converts the  value  in  from_wc  to

       wint_t     from_wc, to_wc; wctrans_t  conv_handle;
         .       conv_handle=wctrans("toupper");      to_wc=towctrans(from_wc,conv_handle);

SEE ALSO    [Toc]    [Back]

       Functions: iswctype(3), towlower(3), wctrans(3), wctype(3)

       Files: locale(4)

[ Back ]
 Similar pages
Name OS Title
wcsxfrm Tru64 Transform wide-character strings for collation in the current locale
nl_langinfo Tru64 Return language or cultural data defined in the current locale
MB_CUR_MAX Linux maximum length of a multibyte character in the current locale
localedef Tru64 Builds a locale from locale and character map source files
wcrtomb FreeBSD convert a wide-character code to a character (restartable)
mbrtowc FreeBSD convert a character to a wide-character code (restartable)
wcrtomb Tru64 Convert a wide character into a multibyte character
wctomb Tru64 Convert a wide character into a multibyte character
mbtowc Tru64 Convert a multibyte character to a wide character
mbrtowc Tru64 Convert a multibyte character to a wide character
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service