towctrans()

Updated: April 19, 2023

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:

ANSI, POSIX 1003.1

Safety:  
Cancellation point No
Interrupt handler Yes
Signal handler Yes
Thread Yes