std::io_errc (3) - Linux Manuals

std::io_errc: std::io_errc

NAME

std::io_errc - std::io_errc

Synopsis

Defined in header <ios>
enum class io_errc {
stream = 1, (since C++11)
};

The scoped enumeration std::io_errc defines the error codes reported by I/O streams in std::ios_base::failure exception objects. Only one error code (std::io_errc::stream) is required, although the implementation may define additional error codes. Because the appropriate specialization of std::is_error_code_enum is provided, values of type std::io_errc are implicitly convertible to std::error_code.

Member constants

Enumeration constant Value
stream 1

Non-member functions

make_error_code(std::io_errc) constructs an iostream error code
                                   (function)
(C++11)

make_error_condition(std::io_errc) constructs an iostream error_condition
                                   (function)
(C++11)

Helper classes

is_error_code_enum<std::io_errc> extends the type trait std::is_error_code_enum to identify iostream error codes
                                 (class template)
(C++11)

Example

// Run this code

  #include <iostream>
  #include <fstream>
  int main()
  {
      std::ifstream f("doesn't exist");
      try {
          f.exceptions(f.failbit);
      } catch (const std::ios_base::failure& e) {
          std::cout << "Caught an ios_base::failure.\n";
          if(e.code() == std::io_errc::stream)
              std::cout << "The error code is std::io_errc::stream\n";
      }
  }

Output:

  Caught an ios_base::failure.
  The error code is std::io_errc::stream