1 ///////////////////////////////////////////////////////////////////////////////
3 // Purpose: Implementation of thread local storage
4 // Author: Vadim Zeitlin
7 // Copyright: (c) 2008 Vadim Zeitlin <vadim@wxwidgets.org>
8 // Licence: wxWindows licence
9 ///////////////////////////////////////////////////////////////////////////////
16 // ----------------------------------------------------------------------------
17 // check for compiler support of thread-specific variables
18 // ----------------------------------------------------------------------------
20 // when not using threads at all, there is no need for thread-specific
21 // values to be really thread-specific
23 #define wxHAS_COMPILER_TLS
24 #define wxTHREAD_SPECIFIC_DECL
25 // __thread keyword is supported if configure detected it or when using mingw32
26 // >= 4.3 which is known to have it too
27 #elif defined(HAVE___THREAD_KEYWORD) || \
28 (defined(__MINGW32__) && wxCHECK_GCC_VERSION(4, 3))
29 #define wxHAS_COMPILER_TLS
30 #define wxTHREAD_SPECIFIC_DECL __thread
31 // MSVC has its own version which might be supported by some other Windows
32 // compilers, to be tested
33 #elif wxCHECK_VISUALC_VERSION(7)
34 #define wxHAS_COMPILER_TLS
35 #define wxTHREAD_SPECIFIC_DECL __declspec(thread)
38 // ----------------------------------------------------------------------------
39 // define wxTLS_TYPE()
40 // ----------------------------------------------------------------------------
42 #ifdef wxHAS_COMPILER_TLS
43 #define wxTLS_TYPE(T) wxTHREAD_SPECIFIC_DECL T
44 #define wxTLS_PTR(var) (&(var))
45 #define wxTLS_VALUE(var) (var)
46 #else // !wxHAS_COMPILER_TLS
48 #include "wx/msw/tls.h"
49 #elif defined(__UNIX__)
50 #include "wx/unix/tls.h"
52 // TODO: we could emulate TLS for such platforms...
53 #error Neither compiler nor OS support thread-specific variables.
56 #include <stdlib.h> // for calloc()
58 // wxTlsValue<T> represents a thread-specific value of type T but, unlike
59 // with native compiler thread-specific variables, it behaves like a
60 // (never NULL) pointer to T and so needs to be dereferenced before use
67 // ctor doesn't do anything, the object is created on first access
69 // FIXME: the thread-specific values are currently not freed under
70 // Windows, resulting in memory leaks, this must be implemented
71 // there somehow (probably by keeping a list of all TLS objects
72 // and cleaning them up in wxThread cleanup)
80 // dtor is only called in the main thread context and so is not enough
81 // to free memory allocated by us for the other threads, we use
82 // destructor function when using Pthreads for this (which is not
83 // called for the main thread as it doesn't call pthread_exit() but
84 // just to be safe we also reset the key anyhow) and simply leak the
85 // memory under Windows (see the FIXME above)
88 void * const value
= m_key
.Get();
96 // access the object creating it on demand
99 void *value
= m_key
.Get();
102 // ValueType must be POD to be used in wxHAS_COMPILER_TLS case
103 // anyhow (at least gcc doesn't accept non-POD values being
104 // declared with __thread) so initialize it as a POD too
105 value
= calloc(1, sizeof(ValueType
));
107 if ( !m_key
.Set(value
) )
111 // this will probably result in a crash in the caller but
112 // it's arguably better to crash immediately instead of
113 // slowly dying from out-of-memory errors which would
114 // happen as the next access to this object would allocate
115 // another ValueType instance and so on forever
120 return static_cast<ValueType
*>(value
);
123 // pointer-like accessors
124 ValueType
*operator->() { return Get(); }
125 ValueType
& operator*() { return *Get(); }
130 DECLARE_NO_COPY_TEMPLATE_CLASS(wxTlsValue
, T
)
133 #define wxTLS_TYPE(T) wxTlsValue<T>
134 #define wxTLS_PTR(var) (var)
135 #define wxTLS_VALUE(var) (*(var))
136 #endif // wxHAS_COMPILER_TLS/!wxHAS_COMPILER_TLS