[Previous] [Contents] [Index] [Next]

towctrans()

Transliterate a wide character

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

Description:

The towctrans() function transliterates 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 transliterated wide character when the argument is valid; otherwise, the original wide character.

Errors:

EINVAL
The transliterator descriptor in category is invalid.

Classification:

ANSI

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

See also:

wctrans()

"Character manipulation functions" and "Wide-character functions" in Library Reference Summary


[Previous] [Contents] [Index] [Next]