std::basic_ios::imbue(3)

🎀 NAME 🎀

bestie, this is std::basic_ios::imbue — literally std::basic_ios::imbue, the locale-swapping member function, and the full header title is std::basic_ios::imbue(3). It comes from the C++ Standard Libary manual (yes, that spelling is what the header says, no cap 💀). The vibe is very “new locale, who dis?” 💅

🌸 Synopsis 🌸

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

Replaces the current locale. It effectively calls ios_base::imbue(loc), and if there is an associated stream buffer (rdbuf() != 0), then it calls rdbuf()->pubimbue(loc). That’s the whole flow, bestie — no extra steps, no hidden drama ✨

🧚 Parameters 🧚

• loc — the new locale. That’s it. Hand over the locale you want and let imbue do its thing 🫶

🫶 Return value 🫶

The previous locale, as returned by ios_base::imbue(loc). So you get the old locale back — cute for “wait, undo” moments 💖

😭 Exceptions 😭

May throw implementation-defined exceptions. Translation: it can throw, and exactly what it throws is implementation-defined — so don’t come for me if your implementation has opinions, okay? 😭💀

✨ Example ✨

// Run this code

#include <iostream>
#include <locale>
#include <sstream>

int main()
{
    std::istringstream iss;
    iss.imbue(std::locale("en_US.UTF8"));

    std::cout << "Current locale: " << iss.getloc().name() << '\n';

    iss.imbue(std::locale());
    std::cout << "Global locale : " << iss.getloc().name() << '\n';
}

🌈 Output 🌈

Current locale: en_US.UTF8
Global locale : C

xoxo, your C++ Standard Libary bestie 💖 source/version: http://cppreference.com, dated 2024.06.10, for std::basic_ios::imbue(3). periodt 🎀