4. atomic_load_explicit

最終更新日時(UTC):
が更新

履歴 編集

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
}

概要

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

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

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

事前条件

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

効果

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

処理系

参照