NAME
ACE_TSS -
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.
SYNOPSIS
#include <ace/Synch_T.h>
template<class TYPE>
class ACE_TSS
{
public:
ACE_TSS (TYPE *ts_obj = 0);
virtual ~ACE_TSS (void);
TYPE *ts_object (void) const;
TYPE *ts_object (TYPE *);
TYPE *operator-> () const;
operator TYPE *(void) const;
virtual TYPE *make_TSS_TYPE (void) const;
void dump (void) const;
protected:
TYPE *ts_get (void) const;
TYPE *type_;
ACE_Thread_Mutex keylock_;
int once_;
ACE_thread_key_t key_;
static void cleanup (void *ptr);
inline ACE_UNIMPLEMENTED_FUNC (
void operator= (const ACE_TSS<TYPE> &)
);
};
DESCRIPTION
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.
Initialization and termination methods.
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.
virtual ~ACE_TSS (void);
Deregister with thread-key administration.
Accessors.
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.
TYPE *ts_object (TYPE *);
Set 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 previous value for the data.
TYPE *operator-> () const;
Use a "smart pointer" to get the thread-specific object
associated with the key_
.
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.
Utility methods.
void dump (void) const;
Dump the state of an object.
ACE_ALLOC_HOOK_DECLARE;
Declare the dynamic allocation hooks.
Disallow copying...
inline ACE_UNIMPLEMENTED_FUNC (
void operator= (const ACE_TSS<TYPE> &)
);
AUTHOR
Doug Schmidt
LIBRARY
ace