[Previous] [Contents] [Next]

towctrans()

Convert characters (esp. transliteration to uppercase or lowercase)

Synopsis:

#include <wctype.h>

wint_t towctrans( wint_t wc,
                  wctrans_t category);

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 is returned.

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:

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


[Previous] [Contents] [Next]