std::basic_ios::setstate(3)

✨ NAME ✨

hii bestie!! 💖 welcome to std::basic_ios::setstate(3) from the C++ Standard Libary (yes, that spelling, we are respecting the source, periodt 💅).

std::basic_ios::setstate - std::basic_ios::setstate

okay so the name is literally the same thing twice — iconic redundancy, no cap 💀.

🌸 Synopsis 🌸

void setstate( iostate state );

Sets the stream error flags state in addition to currently set flags. Essentially it calls clear(rdstate() | state). May throw an exception, so don’t act brand new about it 😭.

💖 Parameters 💖

state is the stream error state flags to set. It can be a combination of the following constants, bestie:

Constant Explanation:

• goodbit — no error
• badbit — irrecoverable stream error
• failbit — input/output operation failed (formatting or extraction error)
• eofbit — associated input sequence has reached end-of-file

✨ Return value ✨

(none) — literally no return value, she gives nothing back and that’s on periodt 💅.

🎀 Example 🎀

Run this code, bestie:

#include <iostream>
#include <sstream>

int main()
{
    std::ostringstream stream;

    if (!stream.fail())
        std::cout << "stream is not fail\n";

    stream.setstate(std::ios_base::failbit);

    if (stream.fail())
        std::cout << "now stream is fail\n";

    if (!stream.good())
        std::cout << "and stream is not good\n";
}

Output:

stream is not fail
now stream is fail
and stream is not good

🦋 See also 🦋

• rdstate — returns state flags (public member function)
• clear — modifies state flags (public member function)

xoxo, your fave unix bestie 💖 — source/version: http://cppreference.com; date: 2024.06.10; page: std::basic_ios::setstate(3).