[][src]Struct tokio::prelude::task::TaskRc

pub struct TaskRc<A> { /* fields omitted */ }
Deprecated since 0.1.4:

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]

Deprecated since 0.1.4:

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]

Deprecated since 0.1.4:

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> Clone for TaskRc<A>[src]

impl<A> Debug for TaskRc<A> where
    A: Debug
[src]

impl<A> Send for TaskRc<A> where
    A: Send
[src]

impl<A> Sync for TaskRc<A> where
    A: Sync
[src]

Auto Trait Implementations

impl<A> !RefUnwindSafe for TaskRc<A>

impl<A> Unpin for TaskRc<A>

impl<A> !UnwindSafe for TaskRc<A>

Blanket Implementations

impl<T> Any for T where
    T: 'static + ?Sized
[src]

impl<T> Borrow<T> for T where
    T: ?Sized
[src]

impl<T> BorrowMut<T> for T where
    T: ?Sized
[src]

impl<T> From<T> for T[src]

impl<T, U> Into<U> for T where
    U: From<T>, 
[src]

impl<T> ToOwned for T where
    T: Clone
[src]

type Owned = T

The resulting type after obtaining ownership.

impl<T, U> TryFrom<U> for T where
    U: Into<T>, 
[src]

type Error = Infallible

The type returned in the event of a conversion error.

impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 
[src]

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.