Struct safina_sync::Promise

pub struct Promise<T: Send + 'static> { /* fields omitted */ }

A Future that resolves when you call set on its clone.

Uses Arc internally. All clones of this struct use the same inner struct on the heap.

You can call set on any clone of this struct.

You can call set once and await once, obtaining the value.

Subsequent or concurrent awaits of the struct will wait forever.

Implementations

impl<T: Send + 'static> Promise<T>

#[must_use]pub fn new() -> Self

#[must_use]pub fn is_set(&self) -> bool

Returns true if set has been called.

Panics

Panics if the inner mutex is poisoned.

pub fn set(self, value: T)

Sets the value of the struct and wakes up any awaiting task.

Consumes the struct.

Panics

Panics if the value was already set.

pub fn try_set(&self, value: T) -> Result<(), T>

Sets the value of the struct and wakes up any awaiting task.

Errors

Returns Err(value) if the value was already set. This returns the value just passed in.

Trait Implementations

impl<T: Send + 'static> Clone for Promise<T>

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Send + 'static> Default for Promise<T>

fn default() -> Self

Returns the “default value” for a type.

impl<T: Send + 'static> Future for Promise<T>

type Output = T

The type of value produced on completion.

fn poll(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll<Self::Output>

Attempt to resolve the future to a final value, registering the current task for wakeup if the value is not yet available.