Struct TaskSlot 

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

Owns one typed task and its forced-abort state across bounded drain attempts.

Call finish_task to observe the join outcome. Dropping the slot requests abort but cannot asynchronously prove termination.

Implementations

impl<T> TaskSlot<T>

pub const fn new() -> Self

Creates an empty task slot.

pub const fn from_handle(handle: JoinHandle<T>) -> Self

Creates a task slot owning handle.

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

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

Spawns and stores a task before its future can be polled.

Errors

Returns an error if the task stops before its start gate opens. The terminal handle remains owned so its join outcome stays observable.

Panics

Panics if the slot already owns a task.

pub const fn is_some(&self) -> bool

Returns whether the slot owns a task.

pub const fn is_none(&self) -> bool

Returns whether the slot is empty.

pub const fn as_ref(&self) -> Option<&JoinHandle<T>>

Returns the owned task handle, when present.

pub fn insert(&mut self, handle: JoinHandle<T>)

Stores a task in an empty slot.

Panics

Aborts handle and panics if the slot already owns a task.

pub fn abort(&mut self)

Requests task cancellation and records it as owner-initiated.

Trait Implementations

impl<T: Debug> Debug for TaskSlot<T>

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

Formats the value using the given formatter.

impl<T> Default for TaskSlot<T>

fn default() -> Self

Returns the “default value” for a type.

impl<T> Drop for TaskSlot<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.