# std::basic_ios<CharT,Traits>::setstate

> C++ Atlas: `cppatlas.com/w/cpp/io/basic_ios/setstate` | Source: https://en.cppreference.com/w/cpp/io/basic_ios/setstate | Domain: Input/output

Sets the stream error flags state in addition to currently set flags. Essentially calls clear(rdstate() | state). May throw an exception.

## Official Specification Summary (cppreference)

```cpp
void setstate( iostate state );
```

Sets the stream error flags `state` in addition to currently set flags. Essentially calls `clear(rdstate() | state)`. May throw an exception.

### Parameters

- `state` - stream error state flags to set. It can be a combination of the following constants:

  **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)

### Example

```cpp
#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:

```text
stream is not fail
now stream is fail
and stream is not good
```

### See also

- [`rdstate`](https://en.cppreference.com/w/cpp/io/basic_ios/rdstate): returns state flags (public member function)
- [`clear`](https://en.cppreference.com/w/cpp/io/basic_ios/clear): modifies state flags (public member function)

---
Attribution: content from https://en.cppreference.com/w/cpp/io/basic_ios/setstate (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.