std::putwchar(3)

🌸 std::putwchar(3) — C++ Standard Libary energy 🌸

okay so real talk, bestie, you're reading the std::putwchar(3) page, and yes — the manual section literally says "C++ Standard Libary" up there in the header. not a typo I made, that's just how it's spelled, and honestly? we respect the chaos. 💅

✨ NAME ✨

std::putwchar — it's literally std::putwchar, that's the whole name, we're not doing a whole dramatic subtitle here 🎀

✨ SYNOPSIS ✨

okay so first up, it lives right here:

Defined in header <cwchar>

and the signature is exactly this, no cap:

std::wint_t putwchar( wchar_t ch );

Writes a wide character ch to stdout.

that's it. that's the function. one wide char, straight to stdout, main character behavior ✨

✨ PARAMETERS ✨

• ch — the wide character you want to be written. that's it. that's the whole parameter. give her the char, she does the thing 🦋

✨ RETURN VALUE ✨

• ch on success 🎉 (she returns the very character you fed her, iconique)
• WEOF on failure 😭

✨ EXAMPLE ✨

// Run this code — go off, copy it, run it, live your truth:

#include <clocale>
#include <cstdio>
#include <cstdlib>
#include <cwchar>
#include <initializer_list>

int main()
{
    std::setlocale(LC_ALL, "en_US.utf8");

    for (const wchar_t ch : {
        L'\u2200', // Unicode name: "FOR ALL"
        L'∀',
        L'\n'
        })
        if (std::putwchar(ch) == WEOF)
        {
            std::puts("I/O error in std::putwchar");
            return EXIT_FAILURE;
        }

    return EXIT_SUCCESS;
}

lowkey notice how the loop bails out the second std::putwchar(ch) == WEOF hits — then it prints I/O error in std::putwchar with std::puts and returns EXIT_FAILURE. if everything slays, you get EXIT_SUCCESS. periodt 💖

✨ POSSIBLE OUTPUT ✨

∀∀

that's right, two of them — one from the L'\u2200' and one from the L'∀', and the L'\n' did a little invisible goodbye at the end 🌈

✨ SEE ALSO ✨

• putchar — writes a character to stdout. (function) 👑
• fputwc — writes a wide character to a file stream. 🔥
• putwc — (function) bestie, she's right there 💜
• C documentation for putwchar — the C side of the story 🧚

---

okay and before you go, sources & date check because we stan a documented page: this one's from http://cppreference.com, dated 2024.06.10, and it's the std::putwchar(3) page — now go write some wide characters, you absolute icon 🫶✨