Struct LatestRequest 

pub struct LatestRequest<T> { /* private fields */ }

UI-thread inbox for worker results where only the newest request may win.

The owner keeps this value inside its table/list/domain model. Calling Self::begin invalidates every older completion; an accepted completion wakes the application and is drained with Self::try_take. This keeps channels, event-loop proxies, and generation races out of app models.

Implementations

impl<T> LatestRequest<T>

pub fn new() -> LatestRequest<T>

pub fn begin(&mut self) -> RequestCompletion<T>

Start a request, invalidating any older completion capability.

After the generation namespace is exhausted this returns a permanently stale capability which cannot publish. This preserves the original infallible API without aliasing a live generation; long-lived hosts that need to observe exhaustion can use Self::try_begin.

pub fn try_begin(&mut self) -> Option<RequestCompletion<T>>

Fallible form of Self::begin. Returns None without changing state when the captured owner is closed or no unique completion generation remains.

pub fn cancel(&mut self)

Invalidate outstanding work without publishing a replacement.

At the terminal invalidation marker this is a safe no-op because no completion capability is ever issued for that reserved generation. Use Self::try_cancel when the caller needs to observe exhaustion.

pub fn try_cancel(&mut self) -> bool

Fallible form of Self::cancel. Returns false only after the terminal invalidation marker has already been reached.

pub fn is_pending(&self) -> bool

pub fn try_take(&mut self) -> Option<T>

Drain the accepted result, discarding messages from stale generations.

impl<T> LatestRequest<T>

where T: Send + 'static,

pub fn spawn<F>(&mut self, future: F) -> bool

where F: Future<Output = T> + Send + 'static,

Start a request whose result is future’s output.

The future runs on the app runtime (tilo_rt::app), never on the calling UI thread. Its output wakes the event loop and is drained with Self::try_take. A newer request, a cancellation or dropping this inbox aborts the future at its next await point.

Returns false without spawning when the owner is closed or the generation namespace is exhausted (see Self::try_begin).

Trait Implementations

impl<T> Default for LatestRequest<T>

fn default() -> LatestRequest<T>

Returns the “default value” for a type.

impl<T> Drop for LatestRequest<T>

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.