std::io_errc

 

C++

语言

标准库头文件

自立与有宿主实现

具名要求

语言支持库

概念库 (C++20)

诊断库

工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

原子操作库 (C++11)

线程支持库 (C++11)

技术规范

 

输入/输出库

I/O 操纵符

C 风格 I/O

缓冲

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (C++98 中弃用)

basic_syncbuf (C++20)

流

抽象

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

文件 I/O

basic_ifstream

basic_ofstream

basic_fstream

字符串 I/O

basic_istringstream

basic_ostringstream

basic_stringstream

数组 I/O

basic_ispanstream (C++23)

basic_ospanstream (C++23)

basic_spanstream (C++23)

istrstream (C++98 中弃用)

ostrstream (C++98 中弃用)

strstream (C++98 中弃用)

同步的输出

basic_osyncstream (C++20)

类型

streamoff

streamsize

fpos

错误类别接口

iostream_category (C++11)

io_errc (C++11)

 

std::io_errc

非成员函数

make_error_code(std::io_errc)

make_error_condition(std::io_errc)

帮助类

is_error_code_enum<std::io_errc>

 

定义于头文件 <ios>
enum class io_errc;		(C++11 起)

带作用域枚举 std::io_errc 定义 I/O 流报告于 std::ios_base::failure 异常对象的错误码。只要求一个错误码（ std::io_errc::stream ），虽然实现可以定义额外的错误码。因为提供了 std::is_error_code_enum 的适当特化，故 std::io_errc 类型的值能隐式转换成 std::error_code 。

成员常量

枚举常量	值
stream	1

非成员函数

make_error_code(std::io_errc) (C++11)	构造一个 iostream 错误码 (函数)
make_error_condition(std::io_errc) (C++11)	构造一个 iostream error_condition (函数)

帮助类

is_error_code_enum<std::io_errc> (C++11)

扩充类型特征 std::is_error_code_enum 以鉴别 iostream 错误码 (类模板特化)

示例

运行此代码

#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";
    }
}

输出：

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

参阅

error_code (C++11)	保有依赖于平台的错误码 (类)
error_condition (C++11)	保有可移植的错误码 (类)
failure	流异常 (std::ios_base 的公开成员类)