include/Zycore/API/Thread.h
#include <Zycore/Defines.h>
#include <Zycore/Status.h>
ZYCORE_EXPORT ZyanStatus
ZyanThreadGetCurrentThread (ZyanThread *thread)
ZYCORE_EXPORT ZyanStatus ZyanThreadGetCurrentThreadId
(ZyanThreadId *thread_id)
ZYCORE_EXPORT ZyanStatus ZyanThreadTlsAlloc
(ZyanThreadTlsIndex *index, ZyanThreadTlsCallback destructor)
ZYCORE_EXPORT ZyanStatus ZyanThreadTlsFree
(ZyanThreadTlsIndex index)
ZYCORE_EXPORT ZyanStatus ZyanThreadTlsGetValue
(ZyanThreadTlsIndex index, void **data)
ZYCORE_EXPORT ZyanStatus ZyanThreadTlsSetValue
(ZyanThreadTlsIndex index, void *data)
ZYCORE_EXPORT ZyanStatus ZyanThreadGetCurrentThread
(ZyanThread * thread)
Returns the handle of the current thread.
Parameters
thread Receives the handle of the current
thread.
Returns
A zyan status code.
ZYCORE_EXPORT ZyanStatus
ZyanThreadGetCurrentThreadId (ZyanThreadId * thread_id)
Returns the unique id of the current thread.
Parameters
thread_id Receives the unique id of the current
thread.
Returns
A zyan status code.
ZYCORE_EXPORT ZyanStatus ZyanThreadTlsAlloc
(ZyanThreadTlsIndex * index, ZyanThreadTlsCallback destructor)
Allocates a new Thread Local Storage (TLS) slot.
Parameters
index Receives the TLS slot index.
destructor A pointer to a destructor callback which is invoked to
finalize the data in the TLS slot or ZYAN_NULL, if not needed.
The maximum available number of TLS slots is implementation
specific and different on each platform:
- •
- Windows
- •
- A total amount of 128 slots per process are guaranteed
- •
- POSIX
- •
- A total amount of 128 slots per process are guaranteed
- •
- Some systems guarantee larger amounts like e.g. 1024 slots per
process
Note that the invocation rules for the destructor callback are
implementation specific and different on each platform:
- •
- Windows
- •
- The callback is invoked when a thread exits
- •
- The callback is invoked when the process exits
- •
- The callback is invoked when the TLS slot is released
- •
- POSIX
- •
- The callback is invoked when a thread exits and the stored value is not
null
- •
- The callback is NOT invoked when the process exits
- •
- The callback is NOT invoked when the TLS slot is released
Returns
A zyan status code.
ZYCORE_EXPORT ZyanStatus ZyanThreadTlsFree
(ZyanThreadTlsIndex index)
Releases a Thread Local Storage (TLS) slot.
Parameters
index The TLS slot index.
Returns
A zyan status code.
ZYCORE_EXPORT ZyanStatus ZyanThreadTlsGetValue
(ZyanThreadTlsIndex index, void ** data)
Returns the value inside the given Thread Local Storage (TLS) slot
for the calling thread.
Parameters
index The TLS slot index.
data Receives the value inside the given Thread Local Storage (TLS) slot
for the calling thread.
Returns
A zyan status code.
ZYCORE_EXPORT ZyanStatus ZyanThreadTlsSetValue
(ZyanThreadTlsIndex index, void * data)
Set the value of the given Thread Local Storage (TLS) slot for the
calling thread.
Parameters
index The TLS slot index.
data The value to store inside the given Thread Local Storage (TLS) slot
for the calling thread
Returns
A zyan status code.
Generated automatically by Doxygen for Zycore from the source
code.