std::basic_ios<CharT,Traits>::exceptions

std::ios_base::iostate exceptions() const;	(1)
void exceptions( std::ios_base::iostate except );	(2)

Gets and sets the exception mask of the stream. The exception mask determines which error states trigger exceptions of type failure.

1) Returns the exception mask.

2) Sets the exception mask to except. If the stream has an error state covered by the exception mask when called, an exception is immediately triggered.

Parameters

except

exception mask

Return value

1) The current exception mask.

2) (none)

Notes

Example

#include <fstream>
#include <iostream>
 
int main() 
{
    int ivalue;
    try
    {
        std::ifstream in("in.txt");
        in.exceptions(std::ifstream::failbit); // may throw
        in >> ivalue; // may throw
    }
    catch (const std::ios_base::failure& fail)
    {
        // handle exception here
        std::cout << fail.what() << '\n';
    }
}

Possible output:

basic_ios::clear: iostream error

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/io/basic_ios/exceptions