Struct TriggerShutdownToken

pub struct TriggerShutdownToken<T: Clone> { /* private fields */ }

Token that triggers a shutdown when it is dropped.

The token can be cloned and sent to different threads and tasks freely. If one of the cloned tokens is dropped, a shutdown is triggered. Even if the rest of the clones still exist.

Implementations

impl<T: Clone> TriggerShutdownToken<T>

pub fn wrap_future<F: Future>(self, future: F) -> WrapTriggerShutdown<T, F>

Wrap a future to trigger a shutdown when it completes or is dropped.

This consumes the token to avoid accidentally dropping the token after wrapping a future and instantly causing a shutdown.

If you need to keep the token around, you can clone it first:

let future = trigger_shutdown_token.clone().wrap_future(future);

pub fn forget(self)

Drop the token without causing a shutdown.

This is equivalent to calling std::mem::forget() on the token.

Trait Implementations

impl<T: Clone + Clone> Clone for TriggerShutdownToken<T>

fn clone(&self) -> TriggerShutdownToken<T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Clone> Drop for TriggerShutdownToken<T>

fn drop(&mut self)

Executes the destructor for this type.