Namespaces
Variants
Views
Actions

Difference between revisions of "cpp/io/io errc"

From cppreference.com
< cpp‎ | io
m (Text replace - "/sidebar" to "/navbar")
m (fmt, headers sorted, langlinks)
 
(10 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 
{{cpp/title|io_errc}}
 
{{cpp/title|io_errc}}
 
{{cpp/io/io_errc/navbar}}
 
{{cpp/io/io_errc/navbar}}
−
{{ddcl list begin}}
+
{{dcl begin}}
−
{{ddcl list header | ios}}
+
{{dcl header|ios}}
−
{{ddcl list item | notes={{mark since c++11}} | 1=
+
{{dcl|since=c++11|1=
−
enum class io_errc;
+
enum class io_errc {
 +
    stream = 1,
 +
};
 
}}
 
}}
−
{{ddcl list end}}
+
{{dcl end}}
  
−
The scoped enumeration {{tt|std::io_errc}} defines the error codes reported by I/O streams in {{c|std::ios_base::failure}} exception objects. Only one error code ({{tt|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 {{tt|std::io_errc}} are implicitly convertible to {{c|std::error_code}}.
+
The scoped enumeration {{tt|std::io_errc}} defines the error codes reported by I/O streams in {{lc|std::ios_base::failure}} exception objects. Only one error code ({{tt|std::io_errc::stream}}) is required, although the implementation may define additional error codes. Because the appropriate specialization of {{lc|std::is_error_code_enum}} is provided, values of type {{tt|std::io_errc}} are implicitly convertible to {{lc|std::error_code}}.
  
 
===Member constants===
 
===Member constants===
−
{{dcl list begin}}
+
{{dsc begin}}
−
{{dcl list hitem | Enumeration constant | Value}}
+
{{dsc hitem|Enumeration constant|Value}}
−
{{dcl list item | {{tt|stream}} | {{c|1}} }}
+
{{dsc|{{tt|stream}}|{{c|1}}}}
−
{{dcl list end}}
+
{{dsc end}}
−
 
+
−
===Helper classes===
+
−
{{dcl list begin}}
+
−
{{dcl list tclass | cpp/io/is_error_code_enum  | title=is_error_code_enum{{dcl small|<std::io_errc>}}| notes={{mark c++11}} | extends the type trait {{c|std::is_error_code_enum}} to identify iostream error codes}}
+
−
{{dcl list end}}
+
  
 
===Non-member functions===
 
===Non-member functions===
−
{{dcl list begin}}
+
{{dsc begin}}
−
{{dcl list fun | cpp/io/io_errc/make_error_code | title=make_error_code{{dcl small|(std::io_errc)}} | notes={{mark c++11}} | constructs an iostream error code}}
+
{{dsc inc|cpp/io/io_errc/dsc make_error_code}}
−
{{dcl list fun | cpp/io/io_errc/make_error_condition | title=make_error_condition{{dcl small|(std::io_errc)}} | notes={{mark c++11}} | constructs an iostream error_condition}}
+
{{dsc inc|cpp/io/io_errc/dsc make_error_condition}}
−
{{dcl list end}}
+
{{dsc end}}
 +
 
 +
===Helper classes===
 +
{{dsc begin}}
 +
{{dsc inc|cpp/io/io_errc/dsc is_error_code_enum}}
 +
{{dsc end}}
  
 
===Example===
 
===Example===
 
{{example
 
{{example
−
|
+
|code=
−
| code=
+
−
#include <iostream>
+
 
#include <fstream>
 
#include <fstream>
 +
#include <iostream>
 +
 
int main()
 
int main()
 
{
 
{
 
     std::ifstream f("doesn't exist");
 
     std::ifstream f("doesn't exist");
−
     try {
+
     try
 +
    {
 
         f.exceptions(f.failbit);
 
         f.exceptions(f.failbit);
−
     } catch (const std::ios_base::failure& e) {
+
     }
 +
    catch (const std::ios_base::failure& e)
 +
    {
 
         std::cout << "Caught an ios_base::failure.\n";
 
         std::cout << "Caught an ios_base::failure.\n";
−
         if(e.code() == std::io_errc::stream)
+
         if (e.code() == std::io_errc::stream)
 
             std::cout << "The error code is std::io_errc::stream\n";
 
             std::cout << "The error code is std::io_errc::stream\n";
 
     }
 
     }
 
}
 
}
−
| output=
+
|output=
 
Caught an ios_base::failure.
 
Caught an ios_base::failure.
 
The error code is std::io_errc::stream
 
The error code is std::io_errc::stream
Line 50: Line 55:
  
 
===See also===
 
===See also===
−
{{dcl list begin}}
+
{{dsc begin}}
−
{{dcl list template | cpp/error/dcl list error_code}}
+
{{dsc inc|cpp/error/dsc error_code}}
−
{{dcl list template | cpp/error/dcl list error_condition}}
+
{{dsc inc|cpp/error/dsc error_condition}}
−
{{dcl list template | cpp/io/ios_base/dcl list failure | mem=std::ios_base}}
+
{{dsc inc|cpp/io/ios_base/dsc failure|mem=std::ios_base}}
−
{{dcl list end}}
+
{{dsc end}}
 +
 
 +
{{langlinks|de|es|fr|it|ja|pt|ru|zh}}

Latest revision as of 10:50, 15 September 2023

 
C++
 
Input/output library
 
std::io_errc
 
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.

Contents

[edit] Member constants

Enumeration constant Value
stream 1

[edit] Non-member functions

(C++11)
 constructs an iostream error code
(function) [edit]
(C++11)
 constructs an iostream error condition
(function) [edit]

[edit] Helper classes

(C++11)
 extends the type trait std::is_error_code_enum to identify iostream error codes
(class template specialization) [edit]

[edit] Example

Run this code
#include <fstream>
#include <iostream>
 
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

[edit] See also

(C++11)
 holds a platform-dependent error code
(class) [edit]
(C++11)
 holds a portable error code
(class) [edit]
stream exception
(public member class of std::ios_base) [edit]
Retrieved from "https://en.cppreference.com/mwiki/index.php?title=cpp/io/io_errc&oldid=159106"