# std::ios_base::failure

< cpp‎ | io‎ | ios base

定义于头文件 `<ios>` |  |
class failure; |  |

类 std::ios_base::failure 定义输入/输出库中的函数在失败时抛出的异常对象。

std::ios_base::failure 可以定义为 std::ios_base 的成员类，或拥有等价功能的另一个类的同义词（ typedef ）。 | (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 起)

1-2) 以 `message` 为解释字符串构造异常对象，能在之后用 `what()` 取得解释字符串。用 `ec` 鉴别特定的失败理由。 (C++11 起)
3) 复制构造函数。以 `other` 的内容初始化内容。若 `*this` 与 `other` 均拥有动态类型 `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 起)

返回解释字符串。

### 参数

（无）

### 返回值

指向有解释信息的空终止字符串的指针。该字符串适合转换并显示为 std::wstring 。保证该指针至少到获得它来源的异常对象被销毁，或在该异常对象上调用非 const 成员函数（例如复制赋值运算符）为止合法。

### 注解

允许但不要求实现覆写 `what()` 。

## 继承自 std::system_error

### 成员函数

code | 返回错误码 (`std::system_error` 的公开成员函数)
what [虚] | 返回解释性字符串 (`std::system_error` 的虚公开成员函数)

## 继承自 std::runtime_error

## 继承自 std::exception

### 成员函数

(析构函数) [虚] | 析构该异常对象 (`std::exception` 的虚公开成员函数)
what [虚] | 返回解释性字符串 (`std::exception` 的虚公开成员函数)

### 示例

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

### 参阅

io_errc (C++11) | IO 流的错误码 (枚举)