[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]

Technical Reference: Base Operating System and Extensions , 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 (towlower Subroutine) subroutine, towupper (towupper Subroutine) subroutine, wctrans (wctrans Subroutine) subroutine.

The wctype.h file.


[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]