std::atomic<T>::fetch_sub

 

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>

atomic<整数型>(C++11) および atomic<浮動小数点型>(C++20) テンプレート特殊化のみのメンバ
	(1)
T fetch_sub( T arg, std::memory_order order = std::memory_order_seq_cst ) noexcept;
T fetch_sub( T arg, std::memory_order order = std::memory_order_seq_cst ) volatile noexcept;
atomic<T*> テンプレート特殊化のみのメンバ
		(2)
T* fetch_sub( std::ptrdiff_t arg, std::memory_order order = std::memory_order_seq_cst ) noexcept;
T* fetch_sub( std::ptrdiff_t arg, std::memory_order order = std::memory_order_seq_cst ) volatile noexcept;

現在の値と arg の算術減算の結果で現在の値をアトミックに置き換えます。 この操作は読み込み-変更-書き込み操作です。 メモリは order の値に従って影響を受けます。

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

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

(C++20以上)

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

引数

arg	-	算術減算のもう一方の引数
order	-	強制するメモリ順序制約

戻り値

*this の変更順序における、この関数の効果の直前の値。

欠陥報告

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

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

関連項目

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

アトミックオブジェクトから非アトミック値を減算し、アトミックの以前の値を取得します (関数テンプレート)