# ATOMIC_VAR_INIT

> C++ Atlas: `cppatlas.com/w/cpp/atomic/ATOMIC_VAR_INIT` | Source: https://en.cppreference.com/w/cpp/atomic/ATOMIC_VAR_INIT | Domain: atomic | Standards: C++11, 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.

## Official Specification Summary (cppreference)

```cpp
// 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

```cpp
#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:

```text
Initialized std::atomic<int> as: 1
```

### See also

- [`atomic_init`](https://en.cppreference.com/w/cpp/atomic/atomic_init) (C++11)(deprecated in C++20): non-atomic initialization of a default-constructed atomic object (function template)
- [(constructor)](https://en.cppreference.com/w/cpp/atomic/atomic/atomic): constructs an atomic object (public member function of `std::atomic<T>`)
- [C documentation for `ATOMIC_VAR_INIT`](https://en.cppreference.com/w/c/atomic/ATOMIC_VAR_INIT)

---
Attribution: content from https://en.cppreference.com/w/cpp/atomic/ATOMIC_VAR_INIT (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.