[c++] Thread-local storage

In multi-threaded C++ applications, thread-local storage (TLS) allows each thread to have its own unique copy of a variable. This is important for cases where you want to have thread-specific data without the risk of data corruption from concurrent access.

What is Thread-Local Storage?

Thread-local storage in C++ is declared using the thread_local keyword. When a variable is declared as thread_local, a separate instance of that variable is created for each thread.

thread_local int tls_var;

In the above example, tls_var will have a unique instance in each thread that accesses it.

Benefits of Thread-Local Storage

Using thread-local storage can be beneficial for various reasons, including:

Example Usage

#include <iostream>
#include <thread>

thread_local int tls_var;

void threadFunction() {
    tls_var += 5;
    std::cout << "Thread-local variable value: " << tls_var << std::endl;

int main() {
    std::thread t1(threadFunction);
    std::thread t2(threadFunction);


    return 0;

In the example above, each thread will have its own copy of tls_var, and incrementing it in one thread will not affect the value in the other thread.


Thread-local storage in C++ provides a convenient way to manage thread-specific data without the complexities of manually synchronizing access to shared variables. It can be a powerful tool for writing efficient and thread-safe code in multi-threaded applications.

For more information, you can refer to the C++ Thread Local Storage documentation on cppreference.com.