最終更新日時(UTC): 2024年12月23日 07時58分47秒
Akira Takahashi が更新

履歴 編集

function
<atomic>

# 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
    constexpr value_type operator--() noexcept;    // (2) C++26

    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
    constexpr value_type operator--(int) noexcept; // (4) C++26

## 概要

値をデクリメントする。

- (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`に変更
- P3309R3 `constexpr atomic` and `atomic_ref`
  - C++26で`constexpr`に対応した