27 Input/output library [input.output]

27.5 Iostreams base classes [iostreams.base]

27.5.5 Class template basic_ios [ios]

27.5.5.4 basic_ios flags functions [iostate.flags]

explicit operator bool() const;

1

Returns: !fail().

bool operator!() const;

2

Returns: fail().

iostate rdstate() const;

3

Returns: The error state of the stream buffer.

void clear(iostate state = goodbit);

4

Postcondition: If rdbuf()!=0 then state == rdstate(); otherwise rdstate()==(state | ios_base::badbit).

5

Effects: If ((state | (rdbuf() ? goodbit : badbit)) & exceptions()) == 0, returns. Otherwise, the function throws an object fail of class basic_ios::failure ([ios::failure]), constructed with implementation-defined argument values.

void setstate(iostate state);

6

Effects: Calls clear(rdstate() | state) (which may throw basic_ios::failure ([ios::failure])).

bool good() const;

7

Returns: rdstate() == 0

bool eof() const;

8

Returns: true if eofbit is set in rdstate().

bool fail() const;

9

Returns: true if failbit or badbit is set in rdstate().304

bool bad() const;

10

Returns: true if badbit is set in rdstate().

iostate exceptions() const;

11

Returns: A mask that determines what elements set in rdstate() cause exceptions to be thrown.

void exceptions(iostate except);

12

Postcondition: except == exceptions().

13

Effects: Calls clear(rdstate()).

303)

Checking badbit also for fail() is historical practice.