[][src]Struct thread_local::CachedThreadLocal

pub struct CachedThreadLocal<T: Send> { /* fields omitted */ }

Wrapper around ThreadLocal which adds a fast path for a single thread.

This has the same API as ThreadLocal, but will register the first thread that sets a value as its owner. All accesses by the owner will go through a special fast path which is much faster than the normal ThreadLocal path.

Methods

impl<T: Send> CachedThreadLocal<T>[src]

pub fn new() -> CachedThreadLocal<T>[src]

Creates a new empty CachedThreadLocal.

pub fn get(&self) -> Option<&T>[src]

Returns the element for the current thread, if it exists.

pub fn get_or<F>(&self, create: F) -> &T where
    F: FnOnce() -> T, 
[src]

Returns the element for the current thread, or creates it if it doesn't exist.

pub fn get_or_try<F, E>(&self, create: F) -> Result<&T, E> where
    F: FnOnce() -> Result<T, E>, 
[src]

Returns the element for the current thread, or creates it if it doesn't exist. If create fails, that error is returned and no element is added.

pub fn iter_mut(&mut self) -> CachedIterMut<T>[src]

Returns a mutable iterator over the local values of all threads.

Since this call borrows the ThreadLocal mutably, this operation can be done safely---the mutable borrow statically guarantees no other threads are currently accessing their associated values.

pub fn clear(&mut self)[src]

Removes all thread-specific values from the ThreadLocal, effectively reseting it to its original state.

Since this call borrows the ThreadLocal mutably, this operation can be done safely---the mutable borrow statically guarantees no other threads are currently accessing their associated values.

impl<T: Send + Default> CachedThreadLocal<T>[src]

pub fn get_or_default(&self) -> &T[src]

Returns the element for the current thread, or creates a default one if it doesn't exist.

Trait Implementations

impl<T: Send + Debug> Debug for CachedThreadLocal<T>[src]

impl<T: Send> Default for CachedThreadLocal<T>[src]

impl<T: Send> IntoIterator for CachedThreadLocal<T>[src]

type Item = T

The type of the elements being iterated over.

type IntoIter = CachedIntoIter<T>

Which kind of iterator are we turning this into?

impl<'a, T: Send + 'a> IntoIterator for &'a mut CachedThreadLocal<T>[src]

type Item = &'a mut T

The type of the elements being iterated over.

type IntoIter = CachedIterMut<'a, T>

Which kind of iterator are we turning this into?

impl<T: Send> Sync for CachedThreadLocal<T>[src]

impl<T: Send + UnwindSafe> UnwindSafe for CachedThreadLocal<T>[src]

Auto Trait Implementations

impl<T> !RefUnwindSafe for CachedThreadLocal<T>

impl<T> Send for CachedThreadLocal<T>

impl<T> Unpin for CachedThreadLocal<T> where
    T: Unpin

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<I> IntoIterator for I where
    I: Iterator
[src]

type Item = <I as Iterator>::Item

The type of the elements being iterated over.

type IntoIter = I

Which kind of iterator are we turning this into?

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.