fetch_fminimum_num.md

fetch_fminimum_num

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

constexpr T
  fetch_fminimum_num(difference_type operand,
                     memory_order order = memory_order_seq_cst
                     ) noexcept;                               // (1) C++26

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

概要

最小値を設定・取得する。

この関数は、*thisが保持する値とoperandの小さい方を求め、その値をthisに保持させた上でその値を返す。

効果

orderで指定されたメモリオーダーにしたがって、*thisが保持する値とoperandの最小値を求めて、その値をthisに保持させ、その値を返す

例外

投げない

備考

• この関数は、atomicクラスの浮動小数点数型に対する特殊化で定義される
• 浮動小数点数型
  • std::fminimum_num()関数と同様の動作をする

例

#include <iostream>
#include <atomic>

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

  int ret = x.fetch_fminimum_num(2);

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

• fetch_fminimum_num[color ff0000]
• load()[link load.md]

出力

2
2

バージョン

言語

• C++26

処理系

• Clang: 21 [mark noimpl]
• GCC: 15 [mark noimpl]

参照

• P3008R6 Atomic floating-point min/max