pub struct TaskHandle { /* private fields */ }Expand description
A non-owning task handle whose drop does not cancel the task.
Use TaskHandle::owned for cancellation on drop.
Implementations§
Source§impl TaskHandle
impl TaskHandle
Sourcepub fn cancel(&self)
pub fn cancel(&self)
Cancel the task. Component and window tasks require Freya’s current context.
Sourcepub fn try_cancel(&self)
pub fn try_cancel(&self)
Try to cancel the task if Freya’s current context is available.
Unlike TaskHandle::cancel, this does nothing when called outside
Freya’s context. Prefer it in destructors and other cleanup paths where a
context might no longer exist.
Sourcepub fn is_finished(&self) -> bool
pub fn is_finished(&self) -> bool
Check whether the task is no longer scheduled.
Sourcepub fn owned(self) -> OwnedTaskHandle
pub fn owned(self) -> OwnedTaskHandle
Upgrade to an OwnedTaskHandle that cancels the task when its last
clone is dropped.
Retain the returned handle for as long as the task should run. Useful for
a task owned by another long-lived value rather than by a component scope.
Trait Implementations§
Source§impl Clone for TaskHandle
impl Clone for TaskHandle
Source§impl Debug for TaskHandle
impl Debug for TaskHandle
impl Eq for TaskHandle
Source§impl Hash for TaskHandle
impl Hash for TaskHandle
Auto Trait Implementations§
impl !RefUnwindSafe for TaskHandle
impl !Send for TaskHandle
impl !Sync for TaskHandle
impl !UnwindSafe for TaskHandle
impl Freeze for TaskHandle
impl Unpin for TaskHandle
impl UnsafeUnpin for TaskHandle
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Source§impl<T> ComponentProps for T
impl<T> ComponentProps for T
fn changed(&self, other: &(dyn ComponentProps + 'static)) -> bool
Source§impl<T> Instrument for T
impl<T> Instrument for T
Source§fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
Source§fn in_current_span(self) -> Instrumented<Self> ⓘ
fn in_current_span(self) -> Instrumented<Self> ⓘ
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
Converts
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
Converts
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read more