Struct SyncStopper 

pub struct SyncStopper { /* private fields */ }

A cancellation primitive with Release/Acquire memory ordering.

Unlike Stopper which uses Relaxed ordering, SyncStopper guarantees that all writes before cancel() are visible to any clone that subsequently observes should_stop() == true.

Converts to StopToken via From/Into with zero overhead — the existing Arc is reused, not double-wrapped.

Performance

On x86/x64, Release/Acquire has negligible overhead (strong memory model). On ARM and other weakly-ordered architectures, there’s a small cost for the memory barriers. Use Stopper if you don’t need the synchronization guarantees.

Implementations

impl SyncStopper

pub fn new() -> Self

Create a new synchronized stopper.

pub fn cancelled() -> Self

Create a stopper that is already cancelled.

pub fn cancel(&self)

Cancel with Release ordering.

All memory writes before this call are guaranteed to be visible to any clone that subsequently observes should_stop() == true.

pub fn is_cancelled(&self) -> bool

Check if cancelled with Acquire ordering.

If this returns true, all memory writes that happened before the corresponding cancel() call are guaranteed to be visible.

Trait Implementations

impl Clone for SyncStopper

fn clone(&self) -> SyncStopper

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SyncStopper

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

Formats the value using the given formatter.

impl Default for SyncStopper

fn default() -> Self

Returns the “default value” for a type.

impl From<SyncStopper> for StopToken

Zero-cost conversion: reuses the SyncStopper’s existing Arc via pointer widening.

fn from(stopper: SyncStopper) -> Self

Converts to this type from the input type.

impl Stop for SyncStopper

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.