uvco::ThreadLocalKey< T > Class Template Reference

#include <async_work.h>

Public Member Functions
	ThreadLocalKey ()
	ThreadLocalKey (const ThreadLocalKey &)=default
	ThreadLocalKey (ThreadLocalKey &&)=default
ThreadLocalKey &	operator= (const ThreadLocalKey &)=default
ThreadLocalKey &	operator= (ThreadLocalKey &&)=default
	~ThreadLocalKey ()=default
void	del ()
T &	getOrDefault ()
	Get the stored value, or create a new one if none exists.
T &	get ()
	Get the stored value. If none exists, this will crash.
void	set (T &&value)
	Set the stored value.
void	setCopy (const T &value)
	Set the stored value.

Private Attributes
uv_key_t	key_ {}

Detailed Description

template<typename T>
class uvco::ThreadLocalKey< T >

Easily access per-thread data. Use get() and getOrDefault() to access the stored value.

NOTE: this inherently leaks the stored objects, unless they are destroyed using del(). in-place.

Constructor & Destructor Documentation

ThreadLocalKey() [1/3]

template<typename T >

uvco::ThreadLocalKey< T >::ThreadLocalKey ( )

inline

{ uv_key_create(&key_); }

ThreadLocalKey() [2/3]

template<typename T >

uvco::ThreadLocalKey< T >::ThreadLocalKey ( const ThreadLocalKey< T > &  )

default

ThreadLocalKey() [3/3]

template<typename T >

uvco::ThreadLocalKey< T >::ThreadLocalKey ( ThreadLocalKey< T > &&  )

default

~ThreadLocalKey()

template<typename T >

uvco::ThreadLocalKey< T >::~ThreadLocalKey ( )

default

Member Function Documentation

del()

template<typename T >

void uvco::ThreadLocalKey< T >::del ( )

inline

Destruct the stored value. The key will be empty afterwards, and getOrDefault() will create a new value.

             {
    auto *value = uv_key_get(&key_);
    if (value != nullptr) {
      delete static_cast<T *>(value);
      uv_key_set(&key_, nullptr);
    }
  }

get()

template<typename T >

T & uvco::ThreadLocalKey< T >::get ( )

inline

Get the stored value. If none exists, this will crash.

{ return *static_cast<T *>(uv_key_get(&key_)); }

getOrDefault()

template<typename T >

T & uvco::ThreadLocalKey< T >::getOrDefault ( )

inline

Get the stored value, or create a new one if none exists.

                    {
    auto *value = uv_key_get(&key_);
    if (value == nullptr) {
      value = new T{};
      uv_key_set(&key_, value);
    }
    return *static_cast<T *>(value);
  }

operator=() [1/2]

template<typename T >

ThreadLocalKey & uvco::ThreadLocalKey< T >::operator= ( const ThreadLocalKey< T > &  )

default

operator=() [2/2]

template<typename T >

ThreadLocalKey & uvco::ThreadLocalKey< T >::operator= ( ThreadLocalKey< T > &&  )

default

set()

template<typename T >

void uvco::ThreadLocalKey< T >::set ( T &&  value )

inline

Set the stored value.

{ getOrDefault() = std::move(value); }

setCopy()

template<typename T >

void uvco::ThreadLocalKey< T >::setCopy ( const T &  value )

inline

Set the stored value.

{ getOrDefault() = value; }

Member Data Documentation

key_

template<typename T >

uv_key_t uvco::ThreadLocalKey< T >::key_ {}

private

{};

---

The documentation for this class was generated from the following file:

• uvco/async_work.h