std::coroutine_handle<Promise>::from_address

 
 
工具库
通用工具
日期和时间
函数对象
格式化库 (C++20)
(C++11)
关系运算符 (C++20 中弃用)
整数比较函数
(C++20)
swap 与类型运算
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
常用词汇类型
(C++11)
(C++17)
(C++17)
(C++17)
(C++17)

初等字符串转换
(C++17)
(C++17)
 
协程支持
协程特征
协程柄
无操作协程
平凡可等待体
 
 
static constexpr coroutine_handle from_address( void *addr );
(C++20 起)

从空指针值或另一 coroutine_handle 的底层地址创建 coroutine_handle 。返回值的底层地址为 addr

addr 既非空指针值亦非 coroutine_handle 的底层地址,则行为未定义。

此函数不对特化 std::coroutine_handle<std::noop_coroutine_promise> 声明,从而 std::noop_coroutine_handle::from_addressstd::coroutine_handle<>::from_address 是同一函数。

参数

addr - 要导入的底层地址

返回值

底层地址为 addrstd::coroutine_handle<Promise> ,除了若 Promisestd::noop_coroutine_promise 则返回类型为 std::coroutine_handle<>

注解

addr 不是空指针值,则它必须从先前在指代某个协程的 coroutine_handle 上调用 address() 获得。

此函数能创建指代承诺类型异于 Promise 的协程的 std::coroutine_handle<Promise>

示例

参阅

构造 coroutine_handle 对象
(公开成员函数)
[静态] (C++20)
从协程的承诺对象创建 coroutine_handle
(公开静态成员函数)
创建在等待或销毁时无操作的协程柄
(函数)