std::ostrea...tor::failed(3)

💖 NAME 💖

Okay bestie, this is the page for std::ostrea...tor::failed(3) from the C++ Standard Libary manual — and yes, the original spells it “Libary,” so we are keeping that exact spelling, no autocorrect erasure 💅.

The NAME section is short and iconic: std::ostreambuf_iterator::failed — and the description is literally std::ostreambuf_iterator::failed again. It’s giving “I said what I said” energy, and honestly? Slay.

🦋 Synopsis 🦋

Two flavors, depending on your C++ era, bestie:

bool failed() const throw();   (until C++11)
bool failed() const noexcept;  (since C++11)

It returns true if the iterator has encountered the end-of-file condition — meaning an earlier call to std::basic_streambuf::sputc (the one made by operator=) came back with Traits::eof. No cap, that’s the whole vibe check 🔥.

🎀 Parameters 🎀

(none) — literally none. Zero. The parameter list is not parametering. It’s empty and unbothered ✨.

💅 Return value 💅

true if this iterator has encountered the end-of-file condition on output, and false otherwise. That’s it, that’s the tea 🍓.

🌈 Example 🌈

This section is incomplete Reason: no example

Not me showing up to the example section and finding it empty 😭. The original says it’s incomplete, and we’re respecting the incomplete-ness. Periodt.

👑 Category 👑

• Todo no example

Mwah 💋 — this little page comes from http://cppreference.com, dated 2024.06.10, and its footer title is std::ostrea...tor::failed(3). Byeee, go write that example maybe 🫶💜