ios_base::failure

Artikel
03/15/2013

Die Klasse failure definiert die Basisklasse für die Typen aller Objekte, die als Ausnahmen, durch die Funktionen in der iostreams Bibliothek, zu den Berichtsfehlern ausgelöst werden, die während der Streampuffervorgänge erkannt werden.

namespace std {
    class failure : public system_error {
    public:
        explicit failure(
            const string& _Message, 
            const error_code& _Code = io_errc::stream
        );
        explicit failure(
            const char* _Str, 
            const error_code& _Code = io_errc::stream
        );
};

Hinweise

Der Wert, der von what() zurückgegeben wird, wird eine Kopie von _Message, möglicherweise erweitert mit einem Test auf Grundlage _Code.Wenn _Code nicht angegeben wird, ist der Standardwert make_error_code(io_errc::stream).

Beispiel

// ios_base_failure.cpp
// compile with: /EHsc
#include <iostream>
#include <fstream>

int main ( ) 
{
   using namespace std;
   fstream file;
   file.exceptions(ios::failbit);
   try 
   {
      file.open( "rm.txt", ios_base::in );
      // Opens nonexistent file for reading
   }
   catch( ios_base::failure f ) 
   {
      cout << "Caught an exception: " << f.what() << endl;
   }
}