Enum std::ops::ControlFlow1.55.0[−][src]

pub enum ControlFlow<B, C = ()> {
    Continue(C),
    Break(B),
}

Expand description

用于告诉操作是应该提前退出还是像往常一样继续操作。

在将您希望用户能够选择是否提前退出的事物 (例如图形遍历或访问者) 公开时使用。有了枚举可以使它更清晰 - 不必再奇怪 “wait, what did false mean again?” 了 - 并允许包含一个值。

Examples

从 Iterator::try_for_each 提前退出:

use std::ops::ControlFlow;

let r = (2..100).try_for_each(|x| {
    if 403 % x == 0 {
        return ControlFlow::Break(x)
    }

    ControlFlow::Continue(())
});
assert_eq!(r, ControlFlow::Break(13));

Run

基本的树遍历:

use std::ops::ControlFlow;

pub struct TreeNode<T> {
    value: T,
    left: Option<Box<TreeNode<T>>>,
    right: Option<Box<TreeNode<T>>>,
}

impl<T> TreeNode<T> {
    pub fn traverse_inorder<B>(&self, mut f: impl FnMut(&T) -> ControlFlow<B>) -> ControlFlow<B> {
        if let Some(left) = &self.left {
            left.traverse_inorder(&mut f)?;
        }
        f(&self.value)?;
        if let Some(right) = &self.right {
            right.traverse_inorder(&mut f)?;
        }
        ControlFlow::Continue(())
    }
}

Run

Variants

Continue(C)

照常进行操作的下一个阶段。

Break(B)

退出操作而不运行后续阶段。

Implementations

impl<B, C> ControlFlow<B, C>

[src]

pub fn is_break(&self) -> bool

[src]

🔬 This is a nightly-only experimental API. (control_flow_enum #75744)

new API

如果这是 Break 成员，则返回 true。

Examples

#![feature(control_flow_enum)]
use std::ops::ControlFlow;

assert!(ControlFlow::<i32, String>::Break(3).is_break());
assert!(!ControlFlow::<String, i32>::Continue(3).is_break());

Run

pub fn is_continue(&self) -> bool

[src]

🔬 This is a nightly-only experimental API. (control_flow_enum #75744)

new API

如果这是 Continue 成员，则返回 true。

Examples

#![feature(control_flow_enum)]
use std::ops::ControlFlow;

assert!(!ControlFlow::<i32, String>::Break(3).is_continue());
assert!(ControlFlow::<String, i32>::Continue(3).is_continue());

Run

pub fn break_value(self) -> Option

[src]

🔬 This is a nightly-only experimental API. (control_flow_enum #75744)

new API

如果 ControlFlow 为 Break，则将 ControlFlow 转换为 Some，否则为 None。

Examples

#![feature(control_flow_enum)]
use std::ops::ControlFlow;

assert_eq!(ControlFlow::<i32, String>::Break(3).break_value(), Some(3));
assert_eq!(ControlFlow::<String, i32>::Continue(3).break_value(), None);

Run

pub fn map_break<T, F>(self, f: F) -> ControlFlow<T, C> where
F: FnOnce(B) -> T,

[src]

🔬 This is a nightly-only experimental API. (control_flow_enum #75744)

new API

Maps ControlFlow<B, C> 到 ControlFlow<T, C> 通过在中断值 (如果存在) 上应用函数来实现。

impl ControlFlow<B, ()>

[src]

pub const CONTINUE: ControlFlow<B, ()>

[src]

🔬 This is a nightly-only experimental API. (control_flow_enum #75744)

new API

通常，Continue 不需要任何值，因此，如果愿意，这提供了一种避免输入 (()) 的方法。

Examples

#![feature(control_flow_enum)]
use std::ops::ControlFlow;

let mut partial_sum = 0;
let last_used = (1..10).chain(20..25).try_for_each(|x| {
    partial_sum += x;
    if partial_sum > 100 { ControlFlow::Break(x) }
    else { ControlFlow::CONTINUE }
});
assert_eq!(last_used.break_value(), Some(22));

Run

impl<C> ControlFlow<(), C>

[src]

pub const BREAK: ControlFlow<(), C>

[src]

🔬 This is a nightly-only experimental API. (control_flow_enum #75744)

new API

像 try_for_each 这样的 API 不需要 Break 的值，因此，如果您愿意的话，这提供了一种避免输入 (()) 的方法。

Examples

#![feature(control_flow_enum)]
use std::ops::ControlFlow;

let mut partial_sum = 0;
(1..10).chain(20..25).try_for_each(|x| {
    if partial_sum > 100 { ControlFlow::BREAK }
    else { partial_sum += x; ControlFlow::CONTINUE }
});
assert_eq!(partial_sum, 108);