Struct thread_local::ThreadLocal

pub struct ThreadLocal<T: ?Sized + Send> { /* fields omitted */ }

Thread-local variable wrapper

See the module-level documentation for more.

Methods

impl<T: ?Sized + Send> ThreadLocal<T>

pub fn new() -> ThreadLocal<T>

Creates a new empty ThreadLocal.

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

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

Important traits for &'a mut R

impl<'a, R> Read for &'a mut R where
    R: Read + ?Sized, impl<'a, W> Write for &'a mut W where
    W: Write + ?Sized, impl<'a, I> Iterator for &'a mut I where
    I: Iterator + ?Sized,  type Item = <I as Iterator>::Item;

pub 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.

pub 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.

Important traits for IterMut<'a, T>

impl<'a, T: ?Sized + Send + 'a> Iterator for IterMut<'a, T> type Item = &'a mut Box<T>;

pub fn iter_mut(&mut self) -> IterMut<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.

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.

impl<T: Send + Default> ThreadLocal<T>

Important traits for &'a mut R

impl<'a, R> Read for &'a mut R where
    R: Read + ?Sized, impl<'a, W> Write for &'a mut W where
    W: Write + ?Sized, impl<'a, I> Iterator for &'a mut I where
    I: Iterator + ?Sized,  type Item = <I as Iterator>::Item;

pub 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 ThreadLocal<T>

impl<T: ?Sized + Send> Default for ThreadLocal<T>

fn default() -> ThreadLocal<T>

Returns the "default value" for a type.

impl<T: ?Sized + Send> Drop for ThreadLocal<T>

fn drop(&mut self)

Executes the destructor for this type.

impl<T: ?Sized + Send> IntoIterator for ThreadLocal<T>

type Item = Box<T>

The type of the elements being iterated over.

type IntoIter = IntoIter<T>

Which kind of iterator are we turning this into?

Important traits for IntoIter<T>

impl<T: ?Sized + Send> Iterator for IntoIter<T> type Item = Box<T>;

fn into_iter(self) -> IntoIter<T>

Creates an iterator from a value.

impl<'a, T: ?Sized + Send + 'a> IntoIterator for &'a mut ThreadLocal<T>

type Item = &'a mut Box<T>

The type of the elements being iterated over.

type IntoIter = IterMut<'a, T>

Which kind of iterator are we turning this into?

Important traits for IterMut<'a, T>

impl<'a, T: ?Sized + Send + 'a> Iterator for IterMut<'a, T> type Item = &'a mut Box<T>;

fn into_iter(self) -> IterMut<'a, T>

Creates an iterator from a value.

impl<T: ?Sized + Send + Debug> Debug for ThreadLocal<T>

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.

impl<T: ?Sized + Send + UnwindSafe> UnwindSafe for ThreadLocal<T>