atomic_load.md

atomic_load

• atomic[meta header]
• std[meta namespace]
• function template[meta id-type]
• cpp11[meta cpp]

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

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

• atomic[link /reference/atomic/atomic.md]

概要

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

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

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

効果

memory_order_seq_cstのメモリオーダーにしたがって、アトミックに値を読み込む

戻り値

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

例外

投げない

備考

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

例

#include <iostream>
#include <atomic>

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

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

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

• std::atomic_load[color ff0000]

出力

3

バージョン

言語

• C++11

処理系

• Clang: 9.0.1 [mark verified]
• GCC: 4.7.0 [mark verified]
• Visual C++: 2012 [mark verified], 2013 [mark verified]

関連項目

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

参照

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