namespace std {
template <class T>
T atomic_exchange(
volatile atomic<T>* object,
T desired) noexcept; // (1) C++11
template <class T>
T atomic_exchange(
volatile atomic<T>* object,
typename atomic<T>::value_type desired) noexcept; // (1) C++17
template <class T>
T atomic_exchange(
atomic<T>* object,
T desired) noexcept; // (2) C++11
template <class T>
T atomic_exchange(
atomic<T>* object,
typename atomic<T>::value_type desired) noexcept; // (2) C++17
}
概要
アトミックに値を入れ替える
テンプレートパラメータ制約
- (1) :
- C++20 :
atomic<T>::is_always_lock_freeがtrueであること
- C++20 :
効果
memory_order_seq_cstのメモリオーダーにしたがって、現在の値をdesiredでアトミックに置き換える
戻り値
変更前の値が返される
例外
投げない
備考
この関数は、特殊化されたatomic型に対して定義される。
例
#include <iostream>
#include <atomic>
int main()
{
std::atomic<int> x(1);
if (std::atomic_exchange(&x, 2) == 1) {
std::cout << "replaced 1 by 2" << std::endl;
}
else {
std::cout << "replace failed" << std::endl;
}
}
出力
replaced 1 by 2
バージョン
言語
- C++11
処理系
- Clang: ??
- GCC: 4.7.0 ✅
- ICC: ??
- Visual C++: 2012 ✅, 2013 ✅
関連項目
参照
- P0558R1 Resolving
atomic<T>named base class inconsistencies - P1831R1 Deprecating
volatile: library- C++20での、
volatile版への制約追加
- C++20での、