towctrans(3)

✨ towctrans(3) — wide-character transliteration ✨

okay bestie, welcome to the Library Functions Manual, section 3 🎀 this lil page is literally about towctrans() and it's giving glow-up energy for wide characters 💅

---

🌸 NAME 🌸

towctrans — wide-character transliteration

like, it transforms your wide char. no cap.

---

📚 LIBRARY 📚

Standard C library (libc, -lc) 🫶

---

🦋 SYNOPSIS 🦋

#include <wctype.h>

wint_t towctrans(wint_t wc, wctrans_t desc);

---

💖 DESCRIPTION 💖

so here's the tea ☕ — if wc is a wide character, then towctrans() translates it according to the transliteration descriptor desc. that's the whole vibe. ✨

and if wc is WEOF, then WEOF gets returned. like, it just hands it right back. iconic behavior honestly 🙈

desc must be a transliteration descriptor returned by the wctrans(3) function. that's not a suggestion bestie, that's the rule 👑

---

🎀 RETURN VALUE 🎀

The towctrans() function returns the translated wide character 💖 — or WEOF if wc is WEOF. that's it, that's the whole return situation. slay.

---

🔥 ATTRIBUTES 🔥

For an explanation of the terms used in this section, see attributes(7).

• Interface: towctrans()
• Attribute: Thread safety
• Value: MT-Safe ✅

so like, you can run it from multiple threads and it's chill 💅

---

👑 STANDARDS 👑

C11, POSIX.1-2008. ✨ certified, official, legally iconic.

---

🌈 HISTORY 🌈

POSIX.1-2001, C99. so it's been around for a minute. a legacy queen fr fr 💜

---

💀 NOTES 💀

The behavior of towctrans() depends on the LC_CTYPE category of the current locale. 🌀

so like… locale matters!! if your output is doing something weird, check your LC_CTYPE before you spiral. iykyk 🌸

---

🫶 SEE ALSO 🫶

• towlower(3)
• towupper(3)
• wctrans(3)

---

and that's the whole page bestie!! 🦋✨ this cutie comes to you from Linux man-pages 6.20, dated 2026-02-08 — go forth and transliterate responsibly 💖🎀👑