std::atomic<T>::operator+=,-=,&=,|=,^=

 

C++

言語

標準ライブラリヘッダ

フリースタンディング処理系とホスト処理系

名前付き要件

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

ユーティリティライブラリ

文字列ライブラリ

コンテナライブラリ

イテレータライブラリ

範囲ライブラリ (C++20)

アルゴリズムライブラリ

数値演算ライブラリ

ローカライゼーションライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

正規表現ライブラリ (C++11)

アトミック操作ライブラリ (C++11)

スレッドサポートライブラリ (C++11)

技術仕様書

 

アトミック操作ライブラリ

型

atomic (C++11)

atomic_ref (C++20)

関数

atomic_storeatomic_store_explicit (C++11)(C++11)

atomic_loadatomic_load_explicit (C++11)(C++11)

atomic_exchangeatomic_exchange_explicit (C++11)(C++11)

atomic_compare_exchange_weakatomic_compare_exchange_weak_explicitatomic_compare_exchange_strongatomic_compare_exchange_strong_explicit (C++11)(C++11)(C++11)(C++11)

atomic_fetch_addatomic_fetch_add_explicit (C++11)(C++11)

atomic_fetch_subatomic_fetch_sub_explicit (C++11)(C++11)

atomic_fetch_andatomic_fetch_and_explicit (C++11)(C++11)

atomic_fetch_oratomic_fetch_or_explicit (C++11)(C++11)

atomic_fetch_xoratomic_fetch_xor_explicit (C++11)(C++11)

atomic_is_lock_free (C++11)

atomic_waitatomic_wait_explicit (C++20)(C++20)

atomic_notify_one (C++20)

atomic_notify_all (C++20)

アトミックフラグ

atomic_flag (C++11)

atomic_flag_test_and_setatomic_flag_test_and_set_explicit (C++11)(C++11)

atomic_flag_clearatomic_flag_clear_explicit (C++11)(C++11)

atomic_flag_testatomic_flag_test_explicit (C++20)(C++20)

atomic_flag_waitatomic_flag_wait_explicit (C++20)(C++20)

atomic_flag_notify_one (C++20)

atomic_flag_notify_all (C++20)

初期化

atomic_init (C++11)(C++20で非推奨)

ATOMIC_VAR_INIT (C++11)(C++20で非推奨)

ATOMIC_FLAG_INIT (C++11)(C++20で非推奨)

メモリ順序

memory_order (C++11)

kill_dependency (C++11)

atomic_thread_fence (C++11)

atomic_signal_fence (C++11)

 

std::atomic

メンバ関数

atomic::atomic

atomic::operator=

atomic::is_lock_free

atomic::store

atomic::load

atomic::operator T

atomic::exchange

atomic::compare_exchange_strongatomic::compare_exchange_weak

atomic::wait (C++20)

atomic::notify_one (C++20)

atomic::notify_all (C++20)

定数

atomic::is_always_lock_free (C++17)

特殊化メンバ関数

atomic::fetch_add

atomic::fetch_sub

atomic::fetch_and

atomic::fetch_or

atomic::fetch_xor

atomic::operator++atomic::operator++(int)atomic::operator--atomic::operator--(int)

atomic::operator+=atomic::operator-=atomic::operator&=atomic::operator|=atomic::operator^=

 

<tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody>

atomic<整数型>(C++11) および atomic<浮動小数点型>(C++20) テンプレート特殊化のみのメンバ
	(1)
T operator+=( T arg ) noexcept;
T operator+=( T arg ) volatile noexcept;
atomic<T*> テンプレート特殊化のみのメンバ
		(1)
T* operator+=( std::ptrdiff_t arg ) noexcept;
T* operator+=( std::ptrdiff_t arg ) volatile noexcept;
atomic<整数型>(C++11) および atomic<浮動小数点型>(C++20) テンプレート特殊化のみのメンバ
			(2)
T operator-=( T arg ) noexcept;
T operator-=( T arg ) volatile noexcept;
atomic<T*> テンプレート特殊化のみのメンバ
				(2)
T* operator-=( std::ptrdiff_t arg ) noexcept;
T* operator-=( std::ptrdiff_t arg ) volatile noexcept;
atomic<整数型> テンプレート特殊化のみのメンバ
					(3)
T operator&=( T arg ) noexcept;
T operator&=( T arg ) volatile noexcept;
						(4)
T operator|=( T arg ) noexcept;
T operator|=( T arg ) volatile noexcept;
							(5)
T operator^=( T arg ) noexcept;
T operator^=( T arg ) volatile noexcept;

直前の値と arg から計算した結果で現在の値をアトミックに置き換えます。 この操作は読み込み-変更-書き込み操作です。

1) アトミックな加算を行います。 fetch_add(arg) + arg と同等です。

2) アトミックな減算を行います。 fetch_sub(arg) - arg と同等です。

3) アトミックなビット単位の論理積を行います。 fetch_and(arg) & arg と同等です。

4) アトミックなビット単位の論理和を行います。 fetch_or(arg) | arg と同等です。

5) アトミックなビット単位の排他的論理和を行います。 fetch_xor(arg) ^ arg と同等です。

符号付きの整数型の場合、算術演算は2の補数表現を使用すると定義されています。 未定義の結果はありません。

浮動小数点型の場合、有効な浮動小数点環境は呼び出し元スレッドの浮動小数点環境と異なることがあります。 演算が対応する std::numeric_limits 型特性に従うことは、必要ではありませんが、推奨されます。 結果がその型で表現可能な値でない場合、結果は未規定ですが、それを除けば演算は未定義動作を持ちません。

(C++20以上)

T* 型の場合、結果が未定義のアドレスとなることはありますが、それを除けば演算は未定義動作を持ちません。 T がオブジェクト型でない場合、プログラムは ill-formed です。

引数

arg

-

算術演算の引数

戻り値

結果の値。 つまり、 *this の変更順序における、対応するメンバ関数の効果の直前の値に、対応する二項演算子を適用した結果。

ノート

ほとんどの複合代入演算子と異なり、アトミック型の複合代入演算子は左側の引数を指す参照を返しません。 代わりに格納された値のコピーを返します。

欠陥報告

以下の動作変更欠陥報告は以前に発行された C++ 標準に遡って適用されました。

DR	適用先	発行時の動作	正しい動作
P0558R1	C++11	arithmetic permitted on pointers to cv void or function	made ill-formed

関連項目

operator++operator++(int)operator--operator--(int)

アトミック値を1つインクリメントまたはデクリメントします (パブリックメンバ関数)