std::future_error

< cpp‎ | thread
 
C++
 
线程支持库
线程
(C++11)
(C++20)
(C++20)
(C++20)
(C++20)
(C++17)(C++17)
this_thread 命名空间
(C++11)
(C++11)
(C++11)
(C++11)
互斥
(C++11)
(C++11)
(C++17)
通用锁管理
(C++11)
(C++17)
(C++11)
(C++14)
(C++11)(C++11)(C++11)
(C++11)
(C++11)
(C++11)(C++11)(C++11)
(C++11)
(C++11)
条件变量
(C++11)
(C++11)
(C++11)
(C++11)
信号量
(C++20)(C++20)
闩与屏障
(C++20)
(C++20)
future
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
future_error
(C++11)
(C++11)
(C++11)
 
std::future_error
 
定义于头文件 <future>
class future_error;
 (C++11 起)

类 std::future_error 定义异常对象，它为处理异步执行和共享状态（ std::future 、 std::promise 等）的线程库中的函数在失败时抛出。同 std::system_error ，此异常携带与 std::error_code 兼容的错误码。

cpp/error/exceptioncpp/error/logic errorstd-future error-inheritance.svg

继承图

成员函数

 创建 std::future_error 对象
(公开成员函数)
替换 std::future_error 对象
(公开成员函数)
返回错误码
(公开成员函数)
返回对错误码指定的解释性字符串
(公开成员函数)

继承自 std::logic_error

继承自 std::exception

成员函数

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

示例

运行此代码
#include <future>
#include <iostream>
 
int main()
{
    std::future<int> empty;
    try {
        int n = empty.get(); // 行为未定义，但一些实现抛出 std::future_error
    } catch (const std::future_error& e) {
        std::cout << "Caught a future_error with code \"" << e.code()
                  << "\"\nMessage: \"" << e.what() << "\"\n";
    }
}

可能的输出： 

Caught a future_error with code "future:3"
Message: "No associated state"

参阅

(C++11)
 鉴别 future 错误码
(枚举)