pub trait FnOnce<Args: Tuple> {
type Output;
// Required method
extern "rust-call" fn call_once(self, args: Args) -> Self::Output;
}
Expand description
具有按值接收者的调用运算符的版本。
可以调用 FnOnce
的实例,但可能无法多次调用。因此,如果唯一知道类型的是它实现 FnOnce
,则只能调用一次。
FnOnce
由可能消耗捕获的变量的闭包以及所有实现 FnMut
的类型自动实现,例如 (safe) 函数指针 (因为 FnOnce
是 FnMut
的 super trait)。
由于 Fn
和 FnMut
都是 FnOnce
的子特性,因此可以在期望使用 FnOnce
的情况下使用 Fn
或 FnMut
的任何实例。
当您想接受类似函数类型的参数并且只需要调用一次时,可以使用 FnOnce
作为绑定。
如果需要重复调用该参数,请使用 FnMut
作为界限; 如果还需要它不改变状态,请使用 Fn
。
有关此主题的更多信息,请参见 Rust 编程语言 中关于闭包的章节。
还要注意的是 Fn
traits 的特殊语法 (例如
Fn(usize, bool) -> usize
)。对此技术细节感兴趣的人可以参考 Rustonomicon 中的相关部分。
Examples
使用 FnOnce
参数
fn consume_with_relish<F>(func: F)
where F: FnOnce() -> String
{
// `func` 消耗其捕获的变量,因此不能多次运行。
println!("Consumed: {}", func());
println!("Delicious!");
// 再次尝试调用 `func()` 将为 `func` 引发 `use of moved value` 错误。
}
let x = String::from("x");
let consume_and_return_x = move || x;
consume_with_relish(consume_and_return_x);
// 此时无法再调用 `consume_and_return_x`
Run