ACE_TSS< TYPE > Class Template Reference

Allows objects that are "physically" in thread specific storage (i.e., private to a thread) to be accessed as though they were "logically" global to a program. More...

#include <TSS_T.h>

Collaboration diagram for ACE_TSS< TYPE >:

[legend]List of all members.

Public Member Functions
	ACE_TSS (TYPE *ts_obj=0)
virtual	~ACE_TSS (void)
	Deregister with thread-key administration.
TYPE *	ts_object (void) const
TYPE *	ts_object (TYPE *)
TYPE *	operator-> () const
	operator TYPE * (void) const
	Return or create and return the calling threads TYPE object.
virtual TYPE *	make_TSS_TYPE (void) const
	Hook for construction parameters.
void	dump (void) const
	Dump the state of an object.
Protected Member Functions
TYPE *	ts_get (void) const
int	ts_init (void) const
void	operator= (const ACE_TSS< TYPE > &)
	ACE_TSS (const ACE_TSS< TYPE > &)
Protected Attributes
TYPE *	type_
	This implementation only works for non-threading systems...

---

Detailed Description

template<class TYPE>
class ACE_TSS< TYPE >

Allows objects that are "physically" in thread specific storage (i.e., private to a thread) to be accessed as though they were "logically" global to a program.

This class is a wrapper around the OS thread library thread-specific functions. It uses the <C++ operator->> to shield applications from the details of accessing thread-specific storage.

Note:

For maximal portability, <TYPE> cannot be a built-in type, but instead should be a user-defined class (some compilers will allow a built-in type, others won't). See template class ACE_TSS_Type_Adapter, below, for adapting built-in types to work with ACE_TSS.

---

Constructor & Destructor Documentation

template<class TYPE>

ACE_BEGIN_VERSIONED_NAMESPACE_DECL ACE_INLINE ACE_TSS< TYPE >::ACE_TSS

(

TYPE *

ts_obj = 0

)

If caller has passed us a non-NULL ts_obj *, then we'll just use this to initialize the thread-specific value (but only for the calling thread). Thus, subsequent calls to <operator->> in this thread will return this value. This is useful since it enables us to assign objects to thread-specific data that have arbitrarily complex constructors.

template<class TYPE>

ACE_BEGIN_VERSIONED_NAMESPACE_DECL ACE_TSS< TYPE >::~ACE_TSS

(

void

)

[virtual]

Deregister with thread-key administration.

template<class TYPE>

ACE_TSS< TYPE >::ACE_TSS

(

const ACE_TSS< TYPE > &

)

[protected]

---

Member Function Documentation

template<class TYPE>

void ACE_TSS< TYPE >::dump

(

void

)

const

Dump the state of an object.

Reimplemented in ACE_TSS_Connection.

template<class TYPE>

TYPE * ACE_TSS< TYPE >::make_TSS_TYPE

(

void

)

const [virtual]

Hook for construction parameters.

Reimplemented in ACE_TSS_Connection.

template<class TYPE>

ACE_TSS< TYPE >::operator TYPE *

(

void

)

const

Return or create and return the calling threads TYPE object.

template<class TYPE>

TYPE * ACE_TSS< TYPE >::operator->

(

)

const

Use a "smart pointer" to get the thread-specific object associated with the <key_>.

template<class TYPE>

void ACE_TSS< TYPE >::operator=

(

const ACE_TSS< TYPE > &

)

[protected]

template<class TYPE>

ACE_INLINE TYPE * ACE_TSS< TYPE >::ts_get

(

void

)

const [protected]

Actually implements the code that retrieves the object from thread-specific storage.

template<class TYPE>

ACE_INLINE int ACE_TSS< TYPE >::ts_init

(

void

)

const [protected]

Factors out common code for initializing TSS. This must NOT be called with the lock held...

template<class TYPE>

ACE_INLINE TYPE * ACE_TSS< TYPE >::ts_object

(

TYPE *

)

Set the thread-specific object for the key associated with this object.

template<class TYPE>

ACE_INLINE TYPE * ACE_TSS< TYPE >::ts_object

(

void

)

const

Get the thread-specific object for the key associated with this object. Returns 0 if the data has never been initialized, otherwise returns a pointer to the data.

---

Member Data Documentation

template<class TYPE>

TYPE* ACE_TSS< TYPE >::type_ [protected]

This implementation only works for non-threading systems...

---

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

• TSS_T.h
• TSS_T.cpp
• TSS_T.inl

---