std::fputc,std::putc(3)

💖 NAME 💖

std::fputc,std::putc — bestie, the NAME section is literally std::fputc,std::putc again, and honestly? Iconic behavior 💅✨

🌸 Synopsis 🌸

Defined in header <cstdio>:

int fputc( int ch, std::FILE* stream );
int putc( int ch, std::FILE* stream );

So here's the tea: this writes a character ch to the given output stream stream. 🫶

Internally, that character gets converted to unsigned char just before it's written. No cap, that's the whole conversion moment right before the write.

In C, putc() may be implemented as a macro, which is disallowed in C++. Therefore, calls to std::fputc() and std::putc() always have the same effect. Periodt. ✨

🎀 Parameters 🎀

• ch — the character to be written 💖
• stream — the output stream 🌊

🔥 Return value 🔥

• On success, it returns the written character. Slay. ✅
• On failure, it returns EOF and sets the error indicator (see std::ferror()) on stream. 😭💀

🦋 Example 🦋

The page says // Run this code, so literally go run it bestie:

#include <cstdio>

int main()
{
    for (char c = 'a'; c != 'z'; c++)
        std::putc(c, stdout);

    // putchar's return value is not equal to the argument
    int r = 0x102A;
    std::printf("\nr = 0x%x\n", r);

    r = std::putchar(r);
    std::printf("\nr = 0x%x\n", r);
}

🔮 Possible output

abcdefghijklmnopqrstuvwxy
r = 0x102A
*
r = 0x2A

🌈 See also 🌈

• putchar writes a character to stdout (function) 👑
• C documentation for fputc, putc 📚

Signing off with source/version cppreference.com and date 2024.06.10 for page std::fputc,std::putc(3) — bye bestie, go write some characters 💜🧚✨