---
name: "towctrans"
section: "3"
platform: "linux"
package: "man-pages"
version: "6.19-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux", "freebsd"]
url: "https://new.carta.tech/towctrans"
---

# towctrans(3)

wide-character transliteration

## NAME

towctrans - wide-character transliteration

## LIBRARY

Standard C library (*libc*, *-lc*)

## SYNOPSIS

```
#include <wctype.h>
```

**wint\_t towctrans(wint\_t** *wc***, wctrans\_t** *desc***);**

## DESCRIPTION

If *wc* is a wide character, then the **towctrans**() function translates it according to the transliteration descriptor *desc*. If *wc* is **WEOF**, **WEOF** is returned.

*desc* must be a transliteration descriptor returned by the [**wctrans**(3)](/wctrans/3.md) function.

## RETURN VALUE

The **towctrans**() function returns the translated wide character, or **WEOF** if *wc* is **WEOF**.

## ATTRIBUTES

For an explanation of the terms used in this section, see [**attributes**(7)](/attributes/7.md).

| | | |
| --- | --- | --- |
| **Interface** | **Attribute** | **Value** |
| **towctrans**() | Thread safety | MT-Safe |

## STANDARDS

C11, POSIX.1-2008.

## HISTORY

POSIX.1-2001, C99.

## NOTES

The behavior of **towctrans**() depends on the **LC\_CTYPE** category of the current locale.

## SEE ALSO

[**towlower**(3)](/towlower/3.md), [**towupper**(3)](/towupper/3.md), [**wctrans**(3)](/wctrans/3.md)