Struct futures_util::abortable::AbortHandle

pub struct AbortHandle {
    inner: Arc<AbortInner>,
}

A handle to an Abortable task.

Fields

inner: Arc<AbortInner>

Implementations

impl AbortHandle

pub fn new_pair() -> (Self, AbortRegistration)

Creates an (AbortHandle, AbortRegistration) pair which can be used to abort a running future or stream.

This function is usually paired with a call to Abortable::new.

impl AbortHandle

pub fn abort(&self)

Abort the Abortable stream/future associated with this handle.

Notifies the Abortable task associated with this handle that it should abort. Note that if the task is currently being polled on another thread, it will not immediately stop running. Instead, it will continue to run until its poll method returns.

pub fn is_aborted(&self) -> bool

Checks whether AbortHandle::abort was called on any associated AbortHandles, which includes all the AbortHandles linked with the same AbortRegistration. This means that it will return true even if:

• abort was called after the task had completed.
• abort was called while the task was being polled - the task may still be running and will not be stopped until poll returns.

This operation has a Relaxed ordering.

Trait Implementations

impl Clone for AbortHandle

fn clone(&self) -> AbortHandle

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for AbortHandle

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

Formats the value using the given formatter.