public member function

std::ios::rdstate

iostate rdstate() const;

Get error state flags

Returns the current internal error state flags of the stream.

The internal error state flags are automatically set by calls to input/output functions on the stream to signal certain errors.

Parameters

none

Return Value

An object of type ios_base::iostate that can contain any combination of the following state flag member constants:

`iostate` value (member constant)	indicates	functions to check state flags
`iostate` value (member constant)	indicates	`good()`	`eof()`	`fail()`	`bad()`	`rdstate()`
`goodbit`	No errors (zero value `iostate`)	`true`	`false`	`false`	`false`	`goodbit`
`eofbit`	End-of-File reached on input operation	`false`	`true`	`false`	`false`	`eofbit`
`failbit`	Logical error on i/o operation	`false`	`false`	`true`	`false`	`failbit`
`badbit`	Read/writing error on i/o operation	`false`	`false`	`true`	`true`	`badbit`

eofbit, failbit and badbit are member constants with implementation-defined values that can be combined (as if with the bitwise OR operator).
goodbit is zero, indicating that none of the other bits is set.

Example

// getting the state of stream objects
#include <iostream>     // std::cerr
#include <fstream>      // std::ifstream

int main () {
  std::ifstream is;
  is.open ("test.txt");
  if ( (is.rdstate() & std::ifstream::failbit ) != 0 )
    std::cerr << "Error opening 'test.txt'\n";
  return 0;
}

Data races

Accesses the stream object.
Concurrent access to the same stream object may cause data races.

Exception safety

Strong guarantee: if an exception is thrown, there are no changes in the stream.

types

manipulators

other functions

public members

protected members