trusty (3) towctrans.3posix.gz

Provided by: manpages-posix-dev_2.16-1_all bug

NAME
       towctrans - wide-character transliteration


SYNOPSIS
       #include <wctype.h>

       wint_t towctrans(wint_t wc, wctrans_t desc);


DESCRIPTION
       The  towctrans()  function  shall transliterate the wide-character code wc using the mapping described by
       desc. The current setting of the LC_CTYPE category should be the same as during  the  call  to  wctrans()
       that  returned  the  value  desc.     If the value of desc is invalid (that is, not obtained by a call to
       wctrans() or desc is invalidated by a subsequent call to setlocale() that has affected category  LC_CTYPE
       ), the result is unspecified.

       An application wishing to check for error situations should set errno to 0 before calling towctrans(). If
       errno is non-zero on return, an error has occurred.


RETURN VALUE
       If successful, the towctrans() function shall return the mapped value of wc using the  mapping  described
       by desc. Otherwise, it shall return wc unchanged.


ERRORS
       The towctrans() function may fail if:

       EINVAL desc contains an invalid transliteration descriptor.

       The following sections are informative.


EXAMPLES
       None.


APPLICATION USAGE
       The  strings "tolower" and "toupper" are reserved for the standard mapping names. In the table below, the
       functions in the left column are equivalent to the functions in the right column.

              towlower(wc)    towctrans(wc, wctrans("tolower"))
              towupper(wc)    towctrans(wc, wctrans("toupper"))


RATIONALE
       None.


FUTURE DIRECTIONS
       None.


SEE ALSO
       towlower() , towupper() , wctrans() , the Base Definitions volume of IEEE Std 1003.1-2001, <wctype.h>


       Portions of this text are reprinted and reproduced in electronic form from IEEE Std 1003.1, 2003 Edition,
       Standard  for  Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base
       Specifications Issue 6, Copyright (C) 2001-2003 by the Institute of Electrical and Electronics Engineers,
       Inc  and  The  Open Group. In the event of any discrepancy between this version and the original IEEE and
       The Open Group Standard, the original IEEE and The Open Group  Standard  is  the  referee  document.  The
       original Standard can be obtained online at http://www.opengroup.org/unix/online.html .