std::ios_base::getloc(3)

std::ios_base::getloc(3) 💅

okay so this page is from the C++ Standard Libary manual — yes, Libary, that's the spelling in the header, don't come for me 💀. It's all about std::ios_base::getloc, aka the little member function that tells you which locale your stream is currently vibing with. very locale-core, no cap 🎀

🌸 NAME 🌸

std::ios_base::getloc — std::ios_base::getloc

✨ Synopsis ✨

std::locale getloc() const;

Returns the current locale associated with the stream. that's the whole job, bestie ✨

🎀 Parameters 🎀

• (none) — literally no parameters. she takes nothing, she gives locale. iconic 🫶

💖 Return value 💖

The locale object associated with the stream. that's the return value, periodt 💖

🦋 Example 🦋

The output shown was obtained using the clang compiler. (compiler lore, iykyk 🔥)

       // Run this code

        #include <codecvt>
        #include <ctime>
        #include <iomanip>
        #include <iostream>

        int main()
        {
            std::wbuffer_convert<std::codecvt_utf8<wchar_t>>
       conv(std::cout.rdbuf());
            std::wostream out(&conv);

            out.imbue(std::locale(out.getloc(),
                                  new
       std::time_put_byname<wchar_t>("ja_JP.utf8")));

            std::time_t t = std::time(nullptr);
            out << std::put_time(std::localtime(&t), L"%A %c") << '\n';
        }

⭐ Possible output ⭐

        木曜日 2023年10月05日 19時47分58秒

💀 Defect reports 💀

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

• DR: LWG 47 — Applied to: C++98 — Behavior as published: the return value was misspecified as the return value of imbue() — Correct behavior: corrected

👑 See also 👑

• imbue — sets locale (public member function)

shoutout to http://cppreference.com for the source, version/date 2024.06.10, page std::ios_base::getloc(3) — bye bestie, go get that locale 💖✨