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

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

Returns the current stream error state.

## Official Specification Summary (cppreference)

```cpp
iostate rdstate() const;
```

Returns the current stream error state.

### Parameters

(none)

### Return value

current stream error state. It is a bitmask type and 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

### Example

```cpp
#include <iostream>
#include <sstream>

int main()
{
    std::ostringstream stream;

    if (stream.rdstate() == std::ios_base::goodbit)
        std::cout << "stream state is goodbit\n";

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

    // check state is exactly eofbit (no failbit and no badbit)
    if (stream.rdstate() == std::ios_base::eofbit)
        std::cout << "stream state is eofbit\n";
}
```

Output:

```text
stream state is goodbit
stream state is eofbit
```

### See also

- [`setstate`](https://en.cppreference.com/w/cpp/io/basic_ios/setstate): sets 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/rdstate (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.