std::ios_base::failure
| 定义于头文件 <ios> |
||
| class failure; |
||
std::ios_base::failure 类定义了一个异常对象，当输入/输出库中的函数失败时会抛出该异常。
|
|
(C++17 起) |
 继承图 |
(C++11 前) |
 继承图 |
(C++11 起) |
目录 |
[编辑] 成员函数
| (构造函数) |
构造一个新的带给定消息的 failure 对象(公开成员函数) |
| operator= |
替换 failure 对象(公开成员函数) |
| what |
返回解释字符串 (公开成员函数) |
std::ios_base::failure::failure
| (1) | ||
explicit failure( const std::string& message ); |
(C++11 前) | |
| explicit failure( const std::string& message, const std::error_code& ec = std::io_errc::stream ); |
(C++11 起) | |
| explicit failure( const char* message, const std::error_code& ec = std::io_errc::stream ); |
(2) | (C++11 起) |
| (3) | ||
failure( const failure& other ); |
(C++11 前) | |
| failure( const failure& other ) noexcept; |
(C++11 起) | |
std::ios_base::failure，则 std::strcmp(what(), other.what()) == 0。(C++11 起)参数
| message | - | 解释性字符串 |
| ec | - | 错误码，用于标识失败的具体原因 |
| 其他 | - | 另一个要复制的 failure 对象 |
注意
因为不允许复制 std::ios_base::failure 抛出异常，所以此消息通常在内部存储为单独分配的引用计数字符串。这也是为什么没有接受 std::string&& 的构造函数：无论如何它都必须复制内容。
std::ios_base::failure::operator=
| failure& operator=( const failure& other ); |
(C++11 前) | |
| failure& operator=( const failure& other ) noexcept; |
(C++11 起) | |
将内容赋值为 other 的内容。如果赋值后 *this 和 other 都具有动态类型 std::ios_base::failure，则 std::strcmp(what(), other.what()) == 0。(C++11 起)
参数
| 其他 | - | 用于赋值的另一个异常对象 |
返回值
*this
std::ios_base::failure::what
| virtual const char* what() const throw(); |
(C++11 前) | |
virtual const char* what() const noexcept; |
(C++11 起) | |
返回解释字符串。
返回值
指向一个实现定义的以 null 结尾的字符串，其中包含解释信息。该字符串适合转换为 std::wstring 并显示。该指针保证在获取它的异常对象被销毁或在该异常对象上调用非常量成员函数（例如复制赋值运算符）之前一直有效。
|
在常量求值期间，返回的字符串使用普通字面量编码进行编码。 |
(C++26 起) |
注意
允许但不要求实现重写 what()。
继承自 std::system_error
成员函数
| 返回错误码 ( std::system_error 的公共成员函数) | |
| [虚函数] |
返回解释字符串 ( std::system_error 的虚公共成员函数) |
继承自 std::exception
成员函数
| [虚函数] |
销毁异常对象 ( std::exception 的虚公共成员函数) |
| [虚函数] |
返回解释字符串 ( std::exception 的虚公共成员函数) |
[编辑] 注意
在解决 LWG issue 331 之前，std::ios_base::failure 声明了一个没有 throw() 的析构函数，而 std::exception::~exception() 声明带有 throw()[1]。这意味着 std::ios_base::failure::~failure() 的异常规范更弱。解决方案是移除该声明，以保留非抛出异常规范。
LWG issue 363 针对的是相同的缺陷，其解决方案是向 std::ios_base::failure::~failure() 的声明中添加 throw()。该解决方案由于与两个解决方案之间的冲突而未被应用。
[编辑] 示例
#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" << "Explanatory string: " << e.what() << '\n' << "Error code: " << e.code() << '\n'; } }
可能的输出
Caught an ios_base::failure. Explanatory string: ios_base::clear: unspecified iostream_category error Error code: iostream:1
[编辑] 缺陷报告
下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。
| 缺陷报告 | 应用于 | 发布时的行为 | 正确的行为 |
|---|---|---|---|
| LWG 48 | C++98 | 构造函数重载 (1) 初始化了基类 std::exception 使用 msg，但基类没有匹配的构造函数 |
相应地 描述已移除 |
| LWG 331 | C++98 | std::ios_base::failure 声明了一个没有 throw() 的析构函数 |
移除了析构函数声明 |
[编辑] 另请参阅
| (C++11) |
I/O 流错误码 (枚举) |
