std::ios_base::imbue(3)

📦 version 2024.07.05, in nixpkgs unstable, opensuse-leap 16.0

💖 std::ios_base::imbue(3) 💖

okay so this is the C++ Standard Libary manual page for std::ios_base::imbue, and we're gonna make locale-swapping make sense, bestie ✨

🌸 NAME 🌸

std::ios_base::imbue — std::ios_base::imbue (yes, the name section is literally just the name twice, and honestly? iconic 💅)

✨ Synopsis ✨

std::locale imbue( const std::locale& loc );

Okay so this sets the associated locale of the stream to loc. Before returning, each function, registered by register_callback(), is called with imbue_event as a parameter. That's the whole tea, no cap 🫖

🎀 Parameters 🎀

  • loc — the new locale to associate the stream to. New locale, new vibe, same stream 💖

🦋 Return value 🦋

The locale object associated with the stream before the operation. So it hands back the locale that was there before the swap — old-locale energy, literally 🔥

🌈 Example 🌈

This section is incomplete 😭

Reason: no example.

Not me being left on read by the example section... but that's literally what the page says, so we're not making one up 🙈

🧚 Defect reports 🧚

The following behavior-changing defect reports were applied retroactively to previously published C++ standards.

  • LWG 47 — applied to C++98. Behavior as published: "the return value was misspecified as the return value of getloc()". Correct behavior: corrected.
  • LWG 156 — applied to C++98. Behavior as published: "the type of loc was const std::locale". Correct behavior: corrected to const std::locale&.

⭐ See also ⭐

  • getloc — returns current locale (public member function). The "where am I?" of locales, iykyk 💅

🎀 Category 🎀

  • Todo — no example.

okay that's the page, bestie 🫶 source/version/date sign-off: http://cppreference.com, 2024.06.10, std::ios_base::imbue(3). Slay and happy locale-ing ✨💅

📦 where this page comes from