std::ios_base::failure

< cpp‎ | io‎ | ios base
 
C++
 
输入/输出库
 
std::ios_base
 
定义于头文件 <ios>
class failure;

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

std::ios_base::failure 可以定义为 std::ios_base 的成员类，或拥有等价功能的另一个类的同义词（ typedef ）。

(C++17 起)
cpp/error/exceptionstd-ios base-failure-2003-inheritance.svg

继承图

(C++11 前)
cpp/error/exceptioncpp/error/runtime errorcpp/error/system errorstd-ios base-failure-inheritance.svg

继承图

(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

成员函数

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

继承自 std::runtime_error


继承自 std::exception

成员函数

[虚]
 析构该异常对象
(std::exception 的虚公开成员函数)
[虚]
 返回解释性字符串
(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

参阅

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