Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

towctrans()

Convert a wide character in a specified manner

Synopsis:

#include <wctype.h>
wint_t towctrans( wint_t wc,
 wctrans_t category );

wc: The wide character that you want to convert.
category: How you want to convert the character; get this by calling wctrans().

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.