4. atomic_store_explicit

    • Class / Function / Type

      std::

    • Header file

      <>

    • Other / All

    crsearch v3.0.23

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

    履歴 編集

    function template
    <atomic>

    std::atomic_store_explicit

    namespace std {
  template <class T>
  void
    atomic_store_explicit(
         volatile atomic<T>* object,
         T desired,
         memory_order order) noexcept;           // (1) C++11
  template <class T>
  void
    atomic_store_explicit(
         volatile atomic<T>* object,
         typename atomic<T>::value_type desired,
         memory_order order) noexcept;           // (1) C++17

  template <class T>
  void
    atomic_store_explicit(
         atomic<T>* object,
         T desired,
         memory_order order) noexcept;           // (2) C++11

  template <class T>
  void
    atomic_store_explicit(
         atomic<T>* object,
         typename atomic<T>::value_type desired,
         memory_order order) noexcept;           // (2) C++17
  template <class T>
  constexpr void
    atomic_store_explicit(
         atomic<T>* object,
         typename atomic<T>::value_type desired,
         memory_order order) noexcept;           // (2) C++26
}

    概要

    アトミックに値を書き込む

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

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

    効果

    指定されたメモリオーダーにしたがって、objectが指す値をdesiredでアトミックに置き換える。

    この関数は、戻り値のないatomic_exchange_explicit()と見なせる。

    戻り値

    なし

    例外

    投げない

    備考

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

    例

    #include <iostream>
#include <atomic>

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

  // 2を書き込む
  std::atomic_store_explicit(&x, 2, std::memory_order_release);

  std::cout << x.load() << std::endl;
}

    出力

    2

    バージョン

    言語

    • C++11

    処理系

    関連項目

    参照