Thread-local storage (TLS) is a computer programming method that uses static or global memory local to a thread.
C and C++[edit]
In C11, the keyword _Thread_local
is used to define thread-local variables. The header <threads.h>
, if supported, defines thread_local
as a synonym for that keyword. Example usage:
#include <threads.h>
thread_local int foo = 0;
Objective-C[edit]
In Cocoa, GNUstep, and OpenStep, each NSThread object has a thread-local dictionary that can be accessed through the thread's threadDictionary method.
NSMutableDictionary *dict = [[NSThread currentThread] threadDictionary];
dict[@"A key"] = @"Some data";
https://en.wikipedia.org/wiki/Thread-local_storage
Configuring Thread-Local Storage
Each thread maintains a dictionary of key-value pairs that can be accessed from anywhere in the thread. You can use this dictionary to store information that you want to persist throughout the execution of your thread. For example, you could use it to store state information that you want to persist through multiple iterations of your thread’s run loop.
Cocoa and POSIX store the thread dictionary in different ways, so you cannot mix and match calls to the two technologies. As long as you stick with one technology inside your thread code, however, the end results should be similar. In Cocoa, you use the threadDictionary
method of an NSThread
object to retrieve an NSMutableDictionary
object, to which you can add any keys required by your thread. In POSIX, you use the pthread_setspecific
and pthread_getspecific
functions to set and get the keys and values of your thread.
https://developer.apple.com/library/content/documentation/Cocoa/Conceptual/Multithreading/CreatingThreads/CreatingThreads.html