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

履歴 編集

function template
<atomic>

# std::atomic_load_explicit(C++11)

    namespace std {
      template <class T>
      T
        atomic_load_explicit(
          const volatile atomic<T>* object,
          memory_order order) noexcept;     // (1) C++11

      template <class T>
      T
        atomic_load_explicit(
          const atomic<T>* object,
          memory_order order) noexcept;     // (2) C++11
      template <class T>
      constexpr T
        atomic_load_explicit(
          const atomic<T>* object,
          memory_order order) noexcept;     // (2) C++26
    }

## 概要

アトミックに値を読み込む

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

- (1) :
  - C++20 : `atomic<T>::is_always_lock_free`が`true`であること

## 事前条件

`order`が以下のメモリオーダーではないこと：

- `memory_order_release`
- `memory_order_acq_rel`

## 効果

`order`で指定されたメモリオーダーにしたがって、アトミックに値を読み込む

## 戻り値

アトミックに読み込まれた値

## 例外

投げない

## 備考

この関数は、特殊化された`atomic`型に対して定義される。

## 例

    #include <iostream>
    #include <atomic>

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

      // 値を読み込む
      int result = std::atomic_load_explicit(&x, std::memory_order_acquire);

      std::cout << result << std::endl;
    }

### 出力

    3

## バージョン

### 言語

- C++11

### 処理系

- Clang: ??
- GCC: 4.7.0 ✅
- ICC: ??
- Visual C++: 2012 ✅, 2013 ✅

## 参照

- P0558R1 Resolving `atomic<T>` named base class inconsistencies
- P1831R1 Deprecating `volatile`: library
  - C++20での、`volatile`版への制約追加
- P3309R3 `constexpr atomic` and `atomic_ref`
  - C++26で`constexpr`に対応した