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 | - | 错误代码，用于标识失败的具体原因 |
| other | - | 要复制的另一个 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 起)
参数
| other | - | 要分配的另一个异常对象 |
返回值
*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 并显示为 std::wstring。该指针保证在至少从获取它的异常对象被销毁或对异常对象调用非 const 成员函数 (例如复制分配运算符) 之前有效。
备注
允许但不要求实现重写 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()。由于两个解决方案之间的冲突，该解决方案并未被应用。
- ↑ 不抛出异常的异常规范现在已在 整个标准库中全局应用，因此标准库类的析构函数不以 throw() 或 noexcept 声明。
[编辑] 示例
#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++ 标准。
| DR | 应用于 | 已发布的行为 | 正确行为 |
|---|---|---|---|
| LWG 48 | C++98 | 构造函数重载 (1) 初始化了基类 std::exception 使用 msg，但基类没有匹配的构造函数 |
对应 删除了描述 |
| LWG 331 | C++98 | std::ios_base::failure 声明了一个没有 throw() 的析构函数 |
删除了析构函数声明 |
[编辑] 参见
| (C++11) |
IO 流错误代码 (枚举) |
