Struct Stopper 

pub struct Stopper { /* private fields */ }

A cancellation primitive with unified clone semantics.

This is the recommended default for most use cases. Clone it to share the cancellation state - any clone can cancel or check status.

Example

use almost_enough::{Stopper, Stop};

let stop = Stopper::new();

// Pass a clone to another thread
let stop2 = stop.clone();
std::thread::spawn(move || {
    while !stop2.should_stop() {
        // do work
        break;
    }
}).join().unwrap();

// Cancel from original
stop.cancel();

Performance

• Size: 8 bytes (one pointer)
• check(): ~1-2ns (single atomic load with Relaxed ordering)
• clone(): atomic increment
• cancel(): atomic store

Implementations

impl Stopper

pub fn new() -> Self

Create a new stopper.

pub fn cancelled() -> Self

Create a stopper that is already cancelled.

Useful for testing or when you want to signal immediate stop.

pub fn cancel(&self)

Signal all clones to stop.

This is idempotent - calling it multiple times has no additional effect.

pub fn is_cancelled(&self) -> bool

Check if cancellation has been requested.

Trait Implementations

impl Cancellable for Stopper

fn stop(&self)

Request stop/cancellation.

impl Clone for Stopper

fn clone(&self) -> Stopper

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Stopper

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

Formats the value using the given formatter.

impl Default for Stopper

fn default() -> Self

Returns the “default value” for a type.

impl Stop for Stopper

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

Check if the operation should stop.

fn should_stop(&self) -> bool

Returns true if the operation should stop.