atomic_load_explicit.md

atomic_load_explicit

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

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

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

• atomic[link atomic.md]
• memory_order[link memory_order.md]

概要

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

要件

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;
}

• std::atomic_load_explicit[color ff0000]

出力

3

バージョン

言語

• C++11

処理系

• Clang: ??
• GCC:
• GCC, C++11 mode: 4.7.0
• ICC: ??
• Visual C++: 2012, 2013

参照

• P0558R1 Resolving atomic<T> named base class inconsistencies