2.6 KiB
[ios.failure]
31 Input/output library [input.output]
31.5 Iostreams base classes [iostreams.base]
31.5.2 Class ios_base [ios.base]
31.5.2.2 Types [ios.types]
31.5.2.2.1 Class ios_base::failure [ios.failure]
namespace std {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); };}
An implementation is permitted to define ios_base::failure as a synonym for a class with equivalent functionality to class ios_base::failure shown in this subclause.
[Note 1:
When ios_base::failure is a synonym for another type, that type needs to provide a nested type failure to emulate the injected-class-name.
â end note]
The classfailure defines the base class for the types of all objects thrown as exceptions, by functions in the iostreams library, to report errors detected during stream buffer operations.
When throwing ios_base::failure exceptions, implementations should provide values of ec that identify the specific reason for the failure.
[Note 2:
Errors arising from the operating system would typically be reported assystem_category() errors with an error value of the error number reported by the operating system.
Errors arising from within the stream library would typically be reported as error_code(io_errc::stream, iostream_category()).
â end note]
explicit failure(const string& msg, const error_code& ec = io_errc::stream);
Effects: Constructs the base class with msg and ec.
explicit failure(const char* msg, const error_code& ec = io_errc::stream);
Effects: Constructs the base class with msg and ec.