C++ ios_base Library - failure

Description

This embedded class inherits from system_error and serves as the base class for the exceptions thrown by the elements of the standard input/output library.

Declaration

Following is the declaration for ios_base::failure.

C++98

class ios_base::failure : public exception {
   public:
      explicit failure (const string& msg);
      virtual ~failure();
      virtual const char* what() const throw();
}

C++11

class ios_base::failure : public system_error {
   public:
      explicit failure (const string& msg, const error_code& ec = io_errc::stream);
      explicit failure (const char*   msg, const error_code& ec = io_errc::stream);
}

Return Value

Member what returns the msg with which the exception is constructed.

Errors

These errors are typically categorized either in the iostream_category (if they relate to the operations of the library) or in the system_category (if the error arises from the system). Although the specifics are implementation-defined.

The library implementation may use values of type io_errc to portably identify error conditions of the iostream_category.