TOWCTRANS(P) POSIX Programmer's Manual TOWCTRANS(P)
towctrans - wide-character transliteration
wint_t towctrans(wint_t wc, wctrans_t desc);
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 dur-
ing 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.
If successful, the towctrans() function shall return the mapped value of wc using the map-
ping described by desc. Otherwise, it shall return wc unchanged.
The towctrans() function may fail if:
EINVAL desc contains an invalid transliteration descriptor.
The following sections are informative.
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
towlower(wc) towctrans(wc, wctrans("tolower"))
towupper(wc) towctrans(wc, wctrans("toupper"))
towlower() , towupper() , wctrans() , the Base Definitions volume of IEEE Std 1003.1-2001,
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 orig-
inal Standard can be obtained online at http://www.opengroup.org/unix/online.html .
IEEE/The Open Group 2003 TOWCTRANS(P)