[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]
Base Operating System and Extensions Technical Reference, Volume 2

towctrans Subroutine

Purpose

Character transliteration.

Library

Standard library (libc.a)

Syntax

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

Description

The towctrans function transliterates the wide-character code wc using the mapping described by desc. The current setting of the LC_CTYPE category should be the same as during the call to wctrans that returned the value desc. If the value of desc is invalid (that is, not obtained by a call to wctrans or desc is invalidated by a subsequent call to setlocale that has affected category LC_CTYPE) the result is implementation-dependent.

Return Values

If successful, the towctrans function returns the mapped value of wc using the mapping described by desc. Otherwise it returns wc unchanged.

Error Codes

The towctrans function may fail if:

EINVAL desc contains an invalid transliteration descriptor.

Implementation Specifics

This subroutine is part of Base Operating System (BOS) subroutine.

Related Information

The towlower, towupper, and wctrans subroutines, the wctype.h file.


[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]