Struct BoxedStop 

pub struct BoxedStop(/* private fields */);

A heap-allocated Stop implementation.

Prefer StopToken which is Clone (via Arc) and supports indirection collapsing. BoxedStop is retained for cases where unique ownership is required.

No-op stops (like Unstoppable) are optimized away at construction — check() short-circuits without any vtable dispatch.

Example

use almost_enough::{BoxedStop, StopSource, Stopper, Unstoppable, Stop};

fn process(stop: BoxedStop) {
    for i in 0..1000 {
        if i % 100 == 0 && stop.should_stop() {
            return;
        }
        // process...
    }
}

// Works with any Stop implementation
process(BoxedStop::new(Unstoppable));
process(BoxedStop::new(StopSource::new()));
process(BoxedStop::new(Stopper::new()));

Implementations

impl BoxedStop

pub fn new<T: Stop + 'static>(stop: T) -> Self

Create a new boxed stop from any Stop implementation.

No-op stops (where may_stop() returns false) are not allocated — check() will short-circuit to Ok(()).

Trait Implementations

impl Debug for BoxedStop

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Stop for BoxedStop

fn check(&self) -> Result<(), StopReason>

Check if the operation should stop.

fn should_stop(&self) -> bool

Returns true if the operation should stop.

fn may_stop(&self) -> bool

Returns true if this stop can ever signal a stop.