ATOMIC_VAR_INIT

From cppreference.com
< cpp‎ | atomic
 
 
Concurrency support library
Threads
(C++11)
(C++20)
this_thread namespace
(C++11)
(C++11)
(C++11)
Cooperative cancellation
Mutual exclusion
(C++11)
Generic lock management
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
Condition variables
(C++11)
Semaphores
Latches and Barriers
(C++20)
(C++20)
Futures
(C++11)
(C++11)
(C++11)
(C++11)
Safe Reclamation
(C++26)
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