#include <threadlocalpointer.h>

Inheritance diagram for ThreadLocalPointer< P >:

Detailed Description

template<typename P>
class maxon::ThreadLocalPointer< P >

Thread local pointer (to a data structure). Different threads may use this class to store different (local) values to it. These values are typically pointers to data which is to be used by the calling thread only.

Note: Thread local pointers are a scarce resource. Only a limited number of them can be allocated: On Windows about 1000 and on OS X about 500. You should only use them if they are the last and only resort to solve a problem. Furthermore for performance reasons it is best to avoid thread local pointers at all and instead use some sort of local context (for a group's jobs or with ParallelFor).; A thread local pointer is bound to a OS thread and the pointer is stored for the lifetime of the thread.

Public Member Functions
	~ThreadLocalPointer ()

Bool	Init ()

P *	Get () const

	operator P* () const

Bool	Set (P *value)

ThreadLocalPointer &	operator= (P *value)

Bool	Reset ()

Bool	IsValid () const

Protected Attributes
pthread_key_t	_key

Static Private Attributes
static const pthread_key_t	INVALID_KEY

Constructor & Destructor Documentation

◆ ~ThreadLocalPointer()

~ThreadLocalPointer ( )

Member Function Documentation

◆ Init()

Bool Init ( )

Allocates and initializes a thread local pointer.

Note: If you Init() an already initialized thread local pointer, a new one will be created and you cannot access the old one anymore. This behaviour is intended.

Returns: False if thread local pointer cannot be created.

◆ Get()

P* Get ( ) const

Returns a thread local pointer value.

Note: If no value has been set yet, this function returns nullptr. THREADSAFE.

Returns: Thread local pointer value.

◆ operator P*()

operator P* ( ) const

◆ Set()

Bool Set ( P * value )

Sets a thread local pointer value.

Parameters

[in] value Thread local pointer value. THREADSAFE.

Returns: True unless an initial memory allocation failed or the initialization was missing.

◆ operator=()

ThreadLocalPointer& operator= ( P * value )

◆ Reset()

Bool Reset ( )

Resets a thread local pointer to the uninitialized state.

Returns: False if previously uninitialized.

◆ IsValid()

Bool IsValid ( ) const

For debugging purposes.

Returns: True if initialized.

Member Data Documentation

◆ INVALID_KEY

const pthread_key_t INVALID_KEY

staticprivate

◆ _key

pthread_key_t _key

protected