# std::basic_ios<CharT,Traits>::operator!

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

Returns true if an error has occurred on the associated stream. Specifically, returns true if badbit or failbit is set in rdstate().

## Official Specification Summary (cppreference)

```cpp
bool operator!() const;
```

Returns `true` if an error has occurred on the associated stream. Specifically, returns `true` if `badbit` or `failbit` is set in `rdstate()`.

### Parameters

(none)

### Return value

`true` if an error has occurred, `false` otherwise.

### Example

```cpp
#include <cstdlib>
#include <fstream>
#include <iostream>

int main()
{
    std::ifstream file("test.txt");
    if (!file) // operator! is used here
    {
        std::cout << "File opening failed\n";
        return EXIT_FAILURE;
    }

    // typical C++ I/O loop uses the return value of the I/O function
    // as the loop controlling condition, operator bool() is used here
    for (int n; file >> n;)
       std::cout << n << ' ';
    std::cout << '\n';

    if (file.bad())
        std::cout << "I/O error while reading\n";
    else if (file.eof())
        std::cout << "End of file reached successfully\n";
    else if (file.fail())
        std::cout << "Non-integer data encountered\n";
}
```

### See also

The following table shows the value of [`basic_ios`](https://en.cppreference.com/w/cpp/io/basic_ios) accessors ([`good()`](https://en.cppreference.com/w/cpp/io/basic_ios/good), [`fail()`](https://en.cppreference.com/w/cpp/io/basic_ios/fail), etc.) for all possible combinations of [`ios_base::iostate`](https://en.cppreference.com/w/cpp/io/ios_base/iostate) flags:

|   |   |   |   |   |   |   |   |   |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| [`ios_base::iostate`](https://en.cppreference.com/w/cpp/io/ios_base/iostate) flags |   |   | `basic_ios` accessors |   |   |   |   |   |
| `eofbit` | `failbit` | `badbit` | [`good()`](https://en.cppreference.com/w/cpp/io/basic_ios/good) | [`fail()`](https://en.cppreference.com/w/cpp/io/basic_ios/fail) | [`bad()`](https://en.cppreference.com/w/cpp/io/basic_ios/bad) | [`eof()`](https://en.cppreference.com/w/cpp/io/basic_ios/eof) | [`operator bool`](https://en.cppreference.com/w/cpp/io/basic_ios/operator_bool) | `operator!` |
| false | false | false | true | false | false | false | true | false |
| false | false | true | false | true | true | false | false | true |
| false | true | false | false | true | false | false | false | true |
| false | true | true | false | true | true | false | false | true |
| true | false | false | false | false | false | true | true | false |
| true | false | true | false | true | true | true | false | true |
| true | true | false | false | true | false | true | false | true |
| true | true | true | false | true | true | true | false | true |

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