std::atomic_store, std::atomic_store_explicit
From cppreference.com
C++
Feature test macros (C++20)
Concepts library (C++20)
Metaprogramming library (C++11)
Ranges library (C++20)
Filesystem library (C++17)
Concurrency support library (C++11)
Execution control library (C++26)
Concurrency support library
Cooperative cancellation
Mutual exclusion Generic lock management
Condition variables Semaphores Latches and Barriers
Futures
Safe reclamation Hazard pointers
specializes atomic operations for std::shared_ptr
(function template)
(C++11)
(C++20)
(C++11)
(C++11)
(C++20)
(C++26)
(C++26)
(C++20)
(C++26)
(C++20)
(C++26)
(C++26)
(C++26)
(C++26)
(C++26)
(C++26)
(C++11)
(C++11)
(C++17)
(C++11)
(C++14)
(C++11)
(C++11)
(C++11)
(C++11)(C++11)(C++11)(C++11)(C++11)(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++20)(C++20)
(C++20)
(C++20)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++26)
(C++26)
(C++26)
(C++11)
(C++20)
(C++11)
(C++11)(deprecated in C++20)
(C++11)(deprecated in C++20)
(C++11)
(C++11)
(C++11)(deprecated in C++26)
(C++11)
(C++11)
atomic_storeatomic_store_explicit
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++26)(C++26)
(C++26)(C++26)
(C++11)
(C++20)(C++20)
(C++20)
(C++20)
(C++11)(C++11)
(C++11)(C++11)
(C++20)(C++20)
(C++20)(C++20)
(C++20)
(C++20)
Defined in header
<atomic>
template< class T >
(1)
(since C++11)
void atomic_store( std::atomic <T>* obj,
template< class T >
(2)
(since C++11)
void atomic_store( volatile std::atomic <T>* obj,
template< class T >
(3)
(since C++11)
void atomic_store_explicit( std::atomic <T>* obj,
typename std::atomic <T>::value_type desired,
template< class T >
(4)
(since C++11)
void atomic_store_explicit( volatile std::atomic <T>* obj,
typename std::atomic <T>::value_type desired,
1,2) Atomically replaces the value pointed to by obj with the value of desired as if by obj->store(desired).
3,4) Atomically replaces the value pointed to by obj with the value of desired as if by obj->store(desired, order).
If order is one of std::memory_order_consume , std::memory_order_acquire and std::memory_order_acq_rel , the behavior is undefined.
[edit] Parameters
obj
-
pointer to the atomic object to modify
desired
-
the value to store in the atomic object
order
-
the memory synchronization ordering
[edit] Return value
(none)
[edit] Defect reports
The following behavior-changing defect reports were applied retroactively to previously published C++ standards.
| DR | Applied to | Behavior as published | Correct behavior |
|---|---|---|---|
| P0558R1 | C++11 | exact type match was required becauseT was deduced from multiple arguments
|
T is only deducedfrom obj |
[edit] See also
atomically replaces the value of the atomic object with a non-atomic argument
(public member function of
(public member function of
std::atomic<T>) [edit]
(deprecated in C++20)(removed in C++26)
(function template)
C documentation for atomic_store, atomic_store_explicit