Operating systems, development tools, and professional services
for connected embedded systems
for connected embedded systems
![]() |
![]() |
![]() |
![]() |
towctrans()
Convert a wide character in a specified manner
Synopsis:
#include <wctype.h>
wint_t towctrans( wint_t wc,
wctrans_t category );
Arguments:
- wc
- The wide character that you want to convert.
- category
- How you want to convert the character; get this by calling wctrans().
Library:
libc
Use the -l c option to qcc to link against this library. This library is usually included automatically.
Description:
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") ) |
Returns:
The corresponding converted wide character when the argument is valid; otherwise, the original wide character.
Errors:
- EINVAL
- The conversion descriptor in category is invalid.
Classification:
| Safety: | |
|---|---|
| Cancellation point | No |
| Interrupt handler | Yes |
| Signal handler | Yes |
| Thread | Yes |
See also:
"Character manipulation functions" and "Wide-character functions" in Library Reference Summary
![]() |
![]() |
![]() |
![]() |

![[Previous]](../prev.gif)
![[Contents]](../contents.gif)
![[Index]](../keyword_index.gif)
![[Next]](../next.gif)