名前空間
変種
操作

std::atomic_fetch_xor, std::atomic_fetch_xor_explicit

From cppreference.com
< cpp‎ | atomic
 
 
並行性サポートライブラリ
スレッド
(C++11)
(C++20)
this_thread 名前空間
(C++11)
(C++11)
(C++11)
協調的なキャンセル
排他制御
(C++11)
汎用ロック管理
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
条件変数
(C++11)
セマフォ
ラッチとバリア
(C++20)
(C++20)
future
(C++11)
(C++11)
(C++11)
(C++11)
安全なメモリ解放 (Safe Reclamation)
(C++26)
ハザードポインタ
アトミック型
(C++11)
(C++20)
アトミック型の初期化
(C++11)(C++20で非推奨)
(C++11)(C++20で非推奨)
メモリオーダー
(C++11)(C++26で非推奨)
アトミック操作のためのフリー関数
atomic_fetch_xoratomic_fetch_xor_explicit
(C++11)(C++11)
アトミックフラグのためのフリー関数
 
ヘッダー <atomic> で定義
template< class T >

T atomic_fetch_xor( std::atomic<T>* obj,

                    typename std::atomic<T>::value_type arg ) noexcept;
(1) (C++11以降)
template< class T >

T atomic_fetch_xor( volatile std::atomic<T>* obj,

                    typename std::atomic<T>::value_type arg ) noexcept;
(2) (C++11以降)
template< class T >

T atomic_fetch_xor_explicit( std::atomic<T>* obj,
                             typename std::atomic<T>::value_type arg,

                             std::memory_order order) noexcept;
(3) (C++11以降)
template< class T >

T atomic_fetch_xor_explicit( volatile std::atomic<T>* obj,
                             typename std::atomic<T>::value_type arg,

                             std::memory_order order) noexcept;
(4) (C++11以降)

obj が指す値を、obj の古い値と arg のビットごとのXOR演算の結果でアトミックに置き換えます。obj が以前に保持していた値を返します。

この操作は、以下が実行されるかのように行われます。

1,2) obj->fetch_xor(arg)
3,4) obj->fetch_xor(arg, order)

std::atomic<T>fetch_xor メンバーがない場合(このメンバーは bool を除く 整数型 のみに提供されています)、プログラムは不定形です。

目次

[edit] パラメータ

obj - 操作対象のアトミックオブジェクトへのポインタ
arg - アトミックオブジェクトに格納されている値とビットごとのXOR演算する値
order - メモリ同期順序

[edit] 戻り値

*obj修正順序において、この関数の効果の直前の値。

[edit]

[edit] 不具合報告

以下の動作変更を伴う欠陥報告が、以前に公開されたC++標準に遡って適用されました。

DR 適用対象 公開された動作 正しい動作
P0558R1 C++11 厳密な型一致が必要であったため
Tは複数の引数から推論された
Tは推論されるのみ
obj から

[edit] 関連項目

引数とアトミックオブジェクトの値との間でビット単位XORをアトミックに実行し、以前に保持されていた値を取得する
(std::atomic<T> の公開メンバ関数) [edit]
アトミックオブジェクトを非アトミックな引数とのビット単位ORの結果で置き換え、アトミックオブジェクトの以前の値を取得する
(関数テンプレート) [編集]
アトミックオブジェクトを非アトミックな引数とのビット単位ANDの結果で置き換え、アトミックオブジェクトの以前の値を取得する
(関数テンプレート) [編集]
C言語のドキュメントatomic_fetch_xor, atomic_fetch_xor_explicit
English 日本語 中文(简体) 中文(繁體)