ATOMIC_VAR_INIT

From cppreference.com
Concurrency support library
Threads
(C++11)
(C++20)
this_thread namespace
(C++11)
(C++11)
Cooperative cancellation
Mutual exclusion
Generic lock management
Condition variables
(C++11)
Semaphores
Latches and Barriers
(C++20)
(C++20)
Futures
(C++11)
(C++11)
(C++11)
Safe Reclamation
Hazard Pointers
Atomic types
(C++11)
(C++20)
Initialization of atomic types
(C++11) (deprecated in C++20)
ATOMIC_VAR_INIT
(C++11) (deprecated in C++20)
Memory ordering
Free functions for atomic operations
Free functions for atomic flags
Defined in header <atomic>
#define ATOMIC_VAR_INIT(value) /* implementation-defined */
(since C++11)
(deprecated in C++20)

Expands to an expression which can be used to initialize an std::atomic object that can be initialized from value . If the atomic object has static storage duration, this initialization is constant initialization .

Notes

Accessing the variable during initialization from another thread, even through an atomic operation, is a data race (it may happen if the address is immediately passed to another thread with a std::memory_order_relaxed operation)

This macro is primarily provided for compatibility with C; it behaves the same as the constructor of std::atomic .

Example

#include <atomic>
#include <iostream>
 
int main()
{
    std::atomic<int> a = ATOMIC_VAR_INIT(1);
    // std::atomic<int> a(1);   // C++-only alternative
    std::cout << "Initialized std::atomic<int> as: " << a << '\n';
}

Output:

Initialized std::atomic<int> as: 1

See also

(C++11) (deprecated in C++20)
non-atomic initialization of a default-constructed atomic object
(function template)
constructs an atomic object
(public member function of std::atomic<T> )
C documentation for ATOMIC_VAR_INIT