std::fputwc(3)

💖 std::fputwc(3) 💖

okay so bestie, welcome to the C++ Standard Libary manual moment — yes, that's the manual name, and we're talking about std::fputwc(3). It's a little wide-character writer with main character energy, and the vibe check is: write one wide char to a stream, periodt. ✨

🎀 NAME 🎀

std::fputwc — std::fputwc. That's it. That's the name. No notes. 💅

🌈 SYNOPSIS 🌈

Defined in header <cwchar>:

std::wint_t fputwc( wchar_t ch, std::FILE* stream ); (1)
std::wint_t putwc( wchar_t ch, std::FILE* stream );  (2)

Writes a wide character ch to the given output stream stream.

Bestie, read the fine print: (2) may be implemented as a macro and may evaluate stream more than once. That's not a drill, that's literally what the page says 🫶.

🦋 PARAMETERS 🦋

• ch — wide character to be written. The little Unicode star of the show 💖
• stream — the output stream. The destination. The place where ch is headed.

👑 RETURN VALUE 👑

• Returns ch on success. Slay ✅
• Returns WEOF on failure. Sad girl hours 😭
• If an encoding error occurs, errno is set to EILSEQ.

🧚 EXAMPLE 🧚

The original literally says // Run this code, so we're running it. Here's the example, verbatim, no edits, no crumb snatching:

// Run this code

#include <cerrno>
#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'\n',
        L'∀',
    })
    {
        if (errno = 0; std::fputwc(ch, stdout) == WEOF)
        {
            std::puts(errno == EILSEQ
                ? "Encoding error in fputwc"
                : "I/O error in fputwc"
            );
            return EXIT_FAILURE;
        }
    }
    return EXIT_SUCCESS;
}

🦋 POSSIBLE OUTPUT 🦋

Possible output, exactly:

∀
∀

🌸 SEE ALSO 🌸

• fputc — writes a character to a file stream.
• putc — (function).
• fputws — writes a wide string to a file stream (function).
• fgetwc — gets a wide character from a file stream.
• getwc — (function).
• C documentation for fputwc.

okay bestie, that's the whole page 💅 it's from the C++ Standard Libary manual, the source/version line is http://cppreference.com, and the date is 2024.06.10 — std::fputwc(3), signing off with a little sparkle 🫶✨