atomic_fetch_and, atomic_fetch_and_explicit

ヘッダーで定義 <stdatomic.h>
C atomic_fetch_and ( volatile A * obj, M arg ) ;	(1)	(C11以降)
C atomic_fetch_and_explicit ( volatile A * obj, M arg, memory_order order ) ;	(2)	(C11以降)

obj が指す値を、 obj の旧値と arg のビット単位の論理積の結果で原子的に置き換え、 obj が以前保持していた値を返します。この操作はread-modify-write操作です。最初のバージョンはメモリアクセスを memory_order_seq_cst に従って順序付けし、2番目のバージョンはメモリアクセスを order に従って順序付けします。

これはすべての ジェネリック関数 に対して定義された アトミックオブジェクト型 A です。引数は揮発性アトミック型へのポインタであり、非揮発性と volatile （メモリマップドI/Oなど）の両方のアトミックオブジェクトのアドレスを受け入れます。また、揮発性アトミックオブジェクトにこの操作を適用する際には揮発性セマンティクスが保持されます。 M は、 A がアトミック整数型の場合は A に対応する非アトミック型、または A がアトミックポインタ型の場合は ptrdiff_t です。

ジェネリック関数の名前がマクロであるか、外部リンケージで宣言された識別子であるかは未規定です。実際の関数にアクセスするために（例えば括弧で囲んで ( atomic_fetch_and ) ( ... ) のように）マクロ定義が抑制された場合、またはプログラムがジェネリック関数の名前で外部識別子を定義した場合、動作は未定義です。

目次 1 パラメータ 2 戻り値 3 参考文献 4 関連項目

パラメータ

obj	-	変更対象のアトミックオブジェクトへのポインタ
arg	-	アトミックオブジェクトに格納された値とビット単位AND演算を行う値
order	-	この操作におけるメモリ同期順序：すべての値が許可されます

戻り値

アトミックオブジェクトが以前に保持していた値 obj によって指される。

参考文献

関連項目

atomic_fetch_or atomic_fetch_or_explicit (C11)	アトミックビット単位OR (関数)
atomic_fetch_xor atomic_fetch_xor_explicit (C11)	アトミックビット単位排他的OR (関数)
C++ドキュメント for atomic_fetch_and , atomic_fetch_and_explicit