std::towctrans(3)

💖 std::towctrans(3) 💖

okay so this is the std::towctrans(3) page from the C++ Standard Libary manual — yes, that spelling is the manual’s, bestie 🫶 — and it’s all about mapping wide characters through the current C locale’s LC_CTYPE mapping category. iconic behavior, honestly ✨

---

🌸 NAME 🌸

std::towctrans — std::towctrans (that’s literally the name, no cap 💅)

---

✨ Synopsis ✨

Defined in header <cwctype>:

std::wint_t towctrans( std::wint_t ch, std::wctrans_t desc );

Maps the wide character ch using the current C locale’s LC_CTYPE mapping category identified by desc 💖

careful, bestie: if the value of ch is neither representable as a wchar_t nor equal to the value of the macro WEOF, the behavior is undefined 🙈💀

---

💅 Parameters 💅

• ch — the wide character to map 🎀
• desc — the LC_CTYPE mapping, obtained from a call to std::wctrans ✨

---

🦋 Return value 🦋

The mapped value of ch using the mapping identified by desc in the LC_CTYPE facet of the current C locale. that’s the whole vibe 🫶

---

🔥 Example 🔥

The following example demonstrates katakana to hiragana character mapping — literally so cute 🌸

Run this code, bestie 👇

#include <algorithm>
#include <clocale>
#include <cwctype>
#include <iostream>

std::wstring tohira(std::wstring str)
{
    std::transform(str.begin(), str.end(), str.begin(), [](wchar_t c)
    {
         return std::towctrans(c, std::wctrans("tojhira"));
    });
    return str;
}

int main()
{
    std::setlocale(LC_ALL, "ja_JP.UTF-8");
    std::wstring kana = L"ヒラガナ";
    std::wcout << "katakana characters " << kana
               << " are " << tohira(kana) << " in hiragana\n";
}

---

🍓 Output 🍓

katakana characters ヒラガナ are ひらがな in hiragana

---

👑 See also 👑

• wctrans — looks up a character mapping category in the current C locale (function) 💖
• C documentation for towctrans ✨

---

mwah 💋 this page came from http://cppreference.com, dated 2024.06.10, and it’s the std::towctrans(3) page 🫶🌈