std::atomic::operator--(C++11)

T operator--() volatile noexcept;             // (1) C++11
value_type operator--() volatile noexcept;    // (1) C++20

T operator--() noexcept;                      // (2) C++11
value_type operator--() noexcept;             // (2) C++20

T operator--(int) volatile noexcept;          // (3) C++11
value_type operator--(int) volatile noexcept; // (3) C++20

T operator--(int) noexcept;                   // (4) C++11
value_type operator--(int) noexcept;          // (4) C++20

概要

値をデクリメントする。

• (1) : volatileオブジェクトに対する前置デクリメント
• (2) : 非volatileオブジェクトに対する前置デクリメント
• (3) : volatileオブジェクトに対する後置デクリメント
• (4) : 非volatileオブジェクトに対する後置デクリメント

テンプレートパラメータ制約

• (1), (3) :
  • C++20 : atomic<T>::is_always_lock_freeがtrueであること

戻り値

以下と等価：

• (1), (2) : fetch_sub(1) - 1
• (3), (4) : fetch_sub(1)

例外

投げない

備考

この関数は、atomicクラスの整数型およびポインタに対する特殊化で定義される。

例

基本的な使い方

#include <iostream>
#include <atomic>

int main()
{
  std::atomic<int> x(3);

  --x;

  std::cout << x.load() << std::endl;
}

出力

2

複数スレッドからデクリメントする例

#include <iostream>
#include <atomic>
#include <thread>

int main()
{
  std::atomic<int> x{10};

  // 複数スレッドでデクリメントを呼んでも、
  // 最終的に全てのスレッドでのデクリメントが処理された値になる
  std::thread t1 {[&x] {
    --x;
  }};
  std::thread t2 {[&x] {
    --x;
  }};

  t1.join();
  t2.join();

  std::cout << x.load() << std::endl;
}

出力

8

バージョン

言語

• C++11

処理系

• Clang: 3.2
• GCC: 4.7.0
• Visual C++: 2012, 2013

関連項目

• C++20 ほとんどのvolatileを非推奨化

参照

• P1831R1 Deprecating volatile: library
  • C++20での、volatile版への制約追加
• P1960R0 NB Comment Changes Reviewed by SG1
  • 戻り値の型をTからvalue_typeに変更