[−][src]Struct tokio::prelude::task::TaskRc
replaced with BiLock
in many cases, otherwise slated for removal due to confusion
A reference to a piece of data that's accessible only within a specific
Task
.
This data is Send
even when A
is not Sync
, because the data stored
within is accessed in a single-threaded way. The thread accessing it may
change over time, if the task migrates, so A
must be Send
.
Methods
impl<A> TaskRc<A>
[src]
pub fn new(a: A) -> TaskRc<A>
[src]
replaced with BiLock
in many cases, otherwise slated for removal due to confusion
Inserts a new piece of task-local data into this task, returning a reference to it.
Ownership of the data will be transferred to the task, and the data will
be destroyed when the task itself is destroyed. The returned value can
be passed to the with
method to get a reference back to the original
data.
Note that the returned handle is cloneable and copyable and can be sent to other futures which will be associated with the same task. All futures will then have access to this data when passed the reference back.
Panics
This function will panic if a task is not currently running.
pub fn with<F, R>(&self, f: F) -> R where
F: FnOnce(&A) -> R,
[src]
F: FnOnce(&A) -> R,
replaced with BiLock
in many cases, otherwise slated for removal due to confusion
Operate with a reference to the underlying data.
This method should be passed a handle previously returned by
Task::insert
. That handle, when passed back into this method, will
retrieve a reference to the original data.
Panics
This method will panic if a task is not currently running or if self
does not belong to the task that is currently running. That is, if
another task generated the data
handle passed in, this method will
panic.
Trait Implementations
impl<A> Sync for TaskRc<A> where
A: Sync,
[src]
A: Sync,
impl<A> Clone for TaskRc<A>
[src]
impl<A> Debug for TaskRc<A> where
A: Debug,
[src]
A: Debug,
impl<A> Send for TaskRc<A> where
A: Send,
[src]
A: Send,
Auto Trait Implementations
Blanket Implementations
impl<T> ToOwned for T where
T: Clone,
[src]
T: Clone,
type Owned = T
The resulting type after obtaining ownership.
fn to_owned(&self) -> T
[src]
fn clone_into(&self, target: &mut T)
[src]
impl<T, U> Into<U> for T where
U: From<T>,
[src]
U: From<T>,
impl<T> From<T> for T
[src]
impl<T, U> TryFrom<U> for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,
type Error = <U as TryFrom<T>>::Error
The type returned in the event of a conversion error.
fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>
[src]
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
T: ?Sized,
ⓘImportant traits for &'_ mut Wfn borrow_mut(&mut self) -> &mut T
[src]
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,