Struct thread_local::CachedThreadLocal
[−]
[src]
pub struct CachedThreadLocal<T: ?Sized + 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: ?Sized + Send> CachedThreadLocal<T>
[src]
fn new() -> CachedThreadLocal<T>
Creates a new empty CachedThreadLocal
.
fn get(&self) -> Option<&T>
Returns the element for the current thread, if it exists.
fn get_or<F>(&self, create: F) -> &T where F: FnOnce() -> Box<T>
Returns the element for the current thread, or creates it if it doesn't exist.
fn get_or_try<F, E>(&self, create: F) -> Result<&T, E> where F: FnOnce() -> Result<Box<T>, E>
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.
fn iter_mut(&mut self) -> CachedIterMut<T>
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.
fn clear(&mut self)
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]
fn get_default(&self) -> &T
Returns the element for the current thread, or creates a default one if it doesn't exist.
Trait Implementations
impl<T: ?Sized + Send> Sync for CachedThreadLocal<T>
[src]
impl<T: ?Sized + Send> Default for CachedThreadLocal<T>
[src]
fn default() -> CachedThreadLocal<T>
Returns the "default value" for a type. Read more
impl<T: ?Sized + Send> IntoIterator for CachedThreadLocal<T>
[src]
type Item = Box<T>
The type of the elements being iterated over.
type IntoIter = CachedIntoIter<T>
Which kind of iterator are we turning this into?
fn into_iter(self) -> CachedIntoIter<T>
Creates an iterator from a value. Read more
impl<'a, T: ?Sized + Send + 'a> IntoIterator for &'a mut CachedThreadLocal<T>
[src]
type Item = &'a mut Box<T>
The type of the elements being iterated over.
type IntoIter = CachedIterMut<'a, T>
Which kind of iterator are we turning this into?
fn into_iter(self) -> CachedIterMut<'a, T>
Creates an iterator from a value. Read more