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

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

Returns true if the most recent I/O operation on the stream completed successfully. Specifically, returns result of rdstate() == 0.

## Official Specification Summary (cppreference)

```cpp
bool good() const;
```

Returns `true` if the most recent I/O operation on the stream completed successfully. Specifically, returns result of `rdstate() == 0`.

See `ios_base::iostate` for the list of conditions that set the stream status bits.

### Parameters

(none)

### Return value

`true` if the stream error flags are all false, `false` otherwise.

### Example

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

int main()
{
    const char* fname = "/tmp/test.txt";
    std::ofstream ofile{fname};
    ofile << "10 " << "11 " << "12 " << "non-int";
    ofile.close();

    std::ifstream file{fname};
    if (!file.good())
    {
        std::cout << "#1. Opening file test.txt failed - "
                     "one of the error flags is true\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 << "#2. I/O error while reading - badbit is true\n";
        return EXIT_FAILURE;
    }
    else if (file.eof())
        std::cout << "#3. End of file reached successfully - eofbit is true\n"
            "This is fine even though file.good() is false\n";
    else if (file.fail())
        std::cout << "#4. Non-integer data encountered - failbit is true\n";
}
```

Possible output:

```text
10 11 12
#4. Non-integer data encountered - failbit is true
```

### See also

The following table shows the value of [`basic_ios`](https://en.cppreference.com/w/cpp/io/basic_ios) accessors (`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()` | [`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!`](https://en.cppreference.com/w/cpp/io/basic_ios/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/good (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.