store.md

store

• atomic[meta header]
• std[meta namespace]
• atomic_ref[meta class]
• function[meta id-type]
• cpp20[meta cpp]

void store(T desired, memory_order order = memory_order_seq_cst) const noexcept;

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

概要

値を書き込む

要件

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

• memory_order_consume
• memory_order_acquire
• memory_order_acq_rel

効果

orderで指定されたメモリオーダーにしたがって、現在の値をdesiredでアトミックに置き換える。 この関数は、戻り値のないexchange()と見なせる。

戻り値

なし

例外

投げない

例

#include <iostream>
#include <atomic>
#include <thread>

int main()
{
  int value = 3;
  std::atomic_ref<int> x{value};

  std::thread t{[&x]{
    // アトミックに値を書き込む
    x.store(2);
  }};
  t.join();

  std::cout << value << std::endl;
}

• store[color ff0000]

出力

2

バージョン

言語

• C++20

処理系

• Clang: (9.0時点で実装なし)
• GCC: 10.1
• Visual C++: ??