| Updated: October 28, 2024 | 
Convert a wide character in a specified manner
#include <wctype.h>
wint_t towctrans( wint_t wc,
                  wctrans_t category );
libc
Use the -l c option to qcc to link against this library. This library is usually included automatically.
The towctrans() function converts wc, using the mapping described by category. The following functions are equivalent:
| Function | Equivalent wctrans() call | 
|---|---|
| towlower( wc ) | towctrans( wc, wctrans("tolower") ) | 
| towupper( wc ) | towctrans( wc, wctrans("toupper") ) | 
The corresponding converted wide character when the argument is valid; otherwise, the original wide character.
| Safety: | |
|---|---|
| Cancellation point | No | 
| Interrupt handler | Yes | 
| Signal handler | Yes | 
| Thread | Yes |