pub struct CachedThreadLocal<T: Send> { /* private fields */ }
ThreadLocal
insteadExpand description
Wrapper around ThreadLocal
.
This used to add a fast path for a single thread, however that has been
obsoleted by performance improvements to ThreadLocal
itself.
Implementations§
Source§impl<T: Send> CachedThreadLocal<T>
impl<T: Send> CachedThreadLocal<T>
Sourcepub fn new() -> CachedThreadLocal<T>
pub fn new() -> CachedThreadLocal<T>
Creates a new empty CachedThreadLocal
.
Sourcepub fn get_or<F>(&self, create: F) -> &Twhere
F: FnOnce() -> T,
pub fn get_or<F>(&self, create: F) -> &Twhere
F: FnOnce() -> T,
Returns the element for the current thread, or creates it if it doesn’t exist.
Sourcepub fn get_or_try<F, E>(&self, create: F) -> Result<&T, E>
pub fn get_or_try<F, E>(&self, create: F) -> Result<&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.
Sourcepub fn iter_mut(&mut self) -> CachedIterMut<'_, T> ⓘ
pub 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.
Sourcepub fn clear(&mut self)
pub 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.
Source§impl<T: Send + Default> CachedThreadLocal<T>
impl<T: Send + Default> CachedThreadLocal<T>
Sourcepub fn get_or_default(&self) -> &T
pub fn get_or_default(&self) -> &T
Returns the element for the current thread, or creates a default one if it doesn’t exist.