Trait core::future::IntoFuture
1.64.0 · source · pub trait IntoFuture {
type Output;
type IntoFuture: Future<Output = Self::Output>;
// Required method
fn into_future(self) -> Self::IntoFuture;
}
Expand description
转换为 Future
。
通过为类型实现 IntoFuture
,您可以定义如何将其转换为 future。
.await
脱糖
在轮询 future 完成之前,.await
关键字首先脱糖到 IntoFuture::into_future
的调用中。
IntoFuture
适用于所有 T: Future
,这意味着 into_future
方法将适用于所有 futures。
use std::future::IntoFuture;
let v = async { "meow" };
let mut fut = v.into_future();
assert_eq!("meow", fut.await);
Run异步构建器
当手动实现 futures 时,通常会在为一个类型实现 Future
或 IntoFuture
之间做出选择。
在大多数情况下,实现 Future
是一个不错的选择。
但是在实现 “async builder” 类型时实现 IntoFuture
是最有用的,它允许在被 .await
编辑之前多次修改它们的值。
use std::future::{ready, Ready, IntoFuture};
/// 最终将两个数字相乘
pub struct Multiply {
num: u16,
factor: u16,
}
impl Multiply {
/// 创建一个新的 `Multiply` 实例。
pub fn new(num: u16, factor: u16) -> Self {
Self { num, factor }
}
/// 设置要乘以因子的数字。
pub fn number(mut self, num: u16) -> Self {
self.num = num;
self
}
/// 设置要与数字相乘的因子。
pub fn factor(mut self, factor: u16) -> Self {
self.factor = factor;
self
}
}
impl IntoFuture for Multiply {
type Output = u16;
type IntoFuture = Ready<Self::Output>;
fn into_future(self) -> Self::IntoFuture {
ready(self.num * self.factor)
}
}
// NOTE: Rust 还没有 `async fn main` 函数,该功能目前仅存在于生态系统中。
async fn run() {
let num = Multiply::new(0, 0) // 将构建器初始化为数字: 0,因子: 0
.number(2) // 将数字更改为 2
.factor(2) // 将因子更改为 2
.await; // 转换为 future 和 .await
assert_eq!(num, 4);
}
Runtrait bounds 中的用法
在 trait 中使用 IntoFuture
bounds 允许函数在 Future
和 IntoFuture
上都是泛型。
这对函数的用户来说很方便,所以当他们使用它时,他们不必对 IntoFuture::into_future
进行额外的调用来获取 Future
的实例:
use std::future::IntoFuture;
/// 将 future 的输出转换为字符串。
async fn fut_to_string<Fut>(fut: Fut) -> String
where
Fut: IntoFuture,
Fut::Output: std::fmt::Debug,
{
format!("{:?}", fut.await)
}
RunRequired Associated Types§
sourcetype IntoFuture: Future<Output = Self::Output>
type IntoFuture: Future<Output = Self::Output>
我们要把它变成哪种 future?