std::regex_traits::imbue(3)

✨ NAME ✨

Welcome to the <pink>std::regex_traits::imbue(3)</pink> manual page, straight from the <purple>C++ Standard Libary</purple> — yes, that's the manual name, and she's serving. The function in the spotlight is std::regex_traits::imbue, and this page is literally all about her. 💅

🌸 Synopsis 🌸

locale_type imbue( locale_type loc );  (since C++11)

She's been around since C++11, and she's ready to switch up your locale. ✨

Okay so here's the tea: imbue replaces the current locale with a copy of loc. If loc is different than the current locale, then all cached data is invalidated.

⚠️ heads up bestie: that invalidation is the whole caveat. If loc is different than the current locale, then all cached data is invalidated. Not me being dramatic — that's just what the page says. 💀

After the call, getloc() == loc. Slay.

🎀 Parameters 🎀

• loc — the locale to imbue. That's it, that's the parameter. 🎀

🦋 Return value 🦋

The current locale of the traits object. ✨

If imbue() has been never called for this object, then the global locale at the time of the call is returned. Otherwise, the locale passed to the last call to imbue() is returned. So: first time? global locale from the moment of the call. After that? whatever loc you passed last. iykyk. 💖

😭 Example 😭

This section is incomplete Reason: no example

The source really left us on read with no example. 🙈

👑 See also 👑

• getloc — getloc gets the locale (public member function). She's the bestie that tells you what locale you're in. 💅

🍓 Category 🍓

• Todo no example

xoxo, your C++ bestie 💅 — source/version: http://cppreference.com; date: 2024.06.10; page: std::regex_traits::imbue(3). mwah 🫶