std::wctrans(3)

okay bestie, welcome to the std::wctrans(3) page from the C++ Standard Libary (yes, the header spells "Libary" like that — not me, I promise 😭). It's giving wide-character mapping, and we're gonna get through it together. 💖

✨ NAME ✨

std::wctrans — std::wctrans

That's it. That's the name. Iconic minimalism. 💅

🌸 Synopsis 🌸

Defined in header <cwctype>
std::wctrans_t wctrans( const char* str );

So std::wctrans constructs a value of type std::wctrans_t that describes an LC_CTYPE category of wide character mapping. It may be one of the standard mappings, or a locale-specific mapping, such as "tojhira" or "tojkata". Slay. ✨

🎀 Parameters 🎀

• str — a C string holding the name of the desired mapping.

The following values of str are supported in all C locales:

• "toupper" — identifies the mapping used by towupper
• "tolower" — identifies the mapping used by towlower

💖 Return value 💖

It gives you a std::wctrans_t object suitable for use with std::towctrans to map wide characters according to the named mapping of the current C locale.

Or it gives you zero if str does not name a mapping supported by the current C locale. Zero. As in, no mapping for you, bestie. 🫶

😭 Example 😭

This section is incomplete.

Reason: no example

Not me staring at this blank example section like 👁️👄👁️ — the page literally says no example. That's the whole tea. 🍵

👑 See also 👑

• towctrans — performs character mapping according to the specified LC_CTYPE mapping category (function).
• C documentation for wctrans.

🌈 Category 🌈

• Todo no example

Signing off with the source/version and date cuteness: this is the std::wctrans(3) page, source/version http://cppreference.com, dated 2024.06.10. Bye bestie, go map those wide characters responsibly 💜🦋✨