atomic(_ref) : C++26対応として浮動小数点数のfmax / fmin関連を追加 #1514

Author: faithandbrave

lang/cpp26.md

@@ -292,10 +292,10 @@ C++26とは、2026年中に改訂される予定の、C++バージョンの通
     - メンバ関数
         - [`fetch_max()`](/reference/atomic/atomic/fetch_max.md)
         - [`fetch_min()`](/reference/atomic/atomic/fetch_min.md)
-        - [`fetch_fmaximum()`](/reference/atomic/atomic/fetch_fmaximum.md.nolink) (浮動小数点数用)
-        - [`fetch_fminimum()`](/reference/atomic/atomic/fetch_fminimum.md.nolink) (浮動小数点数用)
-        - [`fetch_fmaximum_num()`](/reference/atomic/atomic/fetch_fmaximum_num.md.nolink) (浮動小数点数用)
-        - [`fetch_fminimum_num()`](/reference/atomic/atomic/fetch_fminimum_num.md.nolink) (浮動小数点数用)
+        - [`fetch_fmaximum()`](/reference/atomic/atomic/fetch_fmaximum.md) (浮動小数点数用)
+        - [`fetch_fminimum()`](/reference/atomic/atomic/fetch_fminimum.md) (浮動小数点数用)
+        - [`fetch_fmaximum_num()`](/reference/atomic/atomic/fetch_fmaximum_num.md) (浮動小数点数用)
+        - [`fetch_fminimum_num()`](/reference/atomic/atomic/fetch_fminimum_num.md) (浮動小数点数用)
     - 非メンバ関数として
         - [`std::atomic_fetch_max()`](/reference/atomic/atomic_fetch_max.md)
         - [`std::atomic_fetch_max_explicit()`](/reference/atomic/atomic_fetch_max_explicit.md)

reference/atomic/atomic.md

@@ -162,8 +162,8 @@ namespace std {
 | [`fetch_and`](atomic/fetch_and.md)        | AND演算        | C++11 |
 | [`fetch_or`](atomic/fetch_or.md)          | OR演算         | C++11 |
 | [`fetch_xor`](atomic/fetch_xor.md)        | XOR演算        | C++11 |
-| [`fetch_max`](atomic/fetch_max.md)        | 最大値取得     | C++26 |
-| [`fetch_min`](atomic/fetch_min.md)        | 最小値取得     | C++26 |
+| [`fetch_max`](atomic/fetch_max.md)        | 最大値を設定・取得     | C++26 |
+| [`fetch_min`](atomic/fetch_min.md)        | 最小値を設定・取得     | C++26 |
 | [`operator++`](atomic/op_increment.md)    | インクリメント | C++11 |
 | [`operator--`](atomic/op_decrement.md)    | デクリメント   | C++11 |
 | [`operator+=`](atomic/op_plus_assign.md)  | 加算           | C++11 |
@@ -184,10 +184,16 @@ namespace std {
 
 | 名前 | 説明 | 対応バージョン |
 |------|------|----------------|
-| [`fetch_add`](atomic/fetch_add.md)        | 加算 | C++20 |
-| [`fetch_sub`](atomic/fetch_sub.md)        | 減算 | C++20 |
-| [`operator+=`](atomic/op_plus_assign.md)  | 加算 | C++20 |
-| [`operator-=`](atomic/op_minus_assign.md) | 減算 | C++20 |
+| [`fetch_add`](atomic/fetch_add.md)                   | 加算 | C++20 |
+| [`fetch_sub`](atomic/fetch_sub.md)                   | 減算 | C++20 |
+| [`fetch_max`](atomic/fetch_max.md)                   | 最大値を設定・取得    | C++26 |
+| [`fetch_min`](atomic/fetch_min.md)                   | 最小値を設定・取得     | C++26 |
+| [`fetch_fmaximum`](atomic/fetch_fmaximum.md)         | 最大値を設定・取得  (`-0.0`と`+0.0`では`+0.0`、NaNと値ではNaNを返す) | C++26 |
+| [`fetch_fminimum`](atomic/fetch_fminimum.md)         | 最小値を設定・取得  (`-0.0`と`+0.0`では`-0.0`、NaNと値ではNaNを返す) | C++26 |
+| [`fetch_fmaximum_num`](atomic/fetch_fmaximum_num.md) | 最大値を設定・取得  (`-0.0`と`+0.0`では`+0.0`、NaNと値では数値を返す) | C++26 |
+| [`fetch_fminimum_num`](atomic/fetch_fminimum_num.md) | 最小値を設定・取得  (`-0.0`と`+0.0`では`-0.0`、NaNと値では数値を返す) | C++26 |
+| [`operator+=`](atomic/op_plus_assign.md)             | 加算 | C++20 |
+| [`operator-=`](atomic/op_minus_assign.md)            | 減算 | C++20 |
 
 
 ### atomic<floating-point>専用メンバ型
@@ -203,8 +209,8 @@ namespace std {
 |------|------|----------------|
 | [`fetch_add`](atomic/fetch_add.md)        | 加算 | C++11 |
 | [`fetch_sub`](atomic/fetch_sub.md)        | 減算 | C++11 |
-| [`fetch_max`](atomic/fetch_max.md)        | 最大値取得     | C++26 |
-| [`fetch_min`](atomic/fetch_min.md)        | 最小値取得     | C++26 |
+| [`fetch_max`](atomic/fetch_max.md)        | 最大値を設定・取得     | C++26 |
+| [`fetch_min`](atomic/fetch_min.md)        | 最小値を設定・取得     | C++26 |
 | [`operator++`](atomic/op_increment.md)    | インクリメント | C++11 |
 | [`operator--`](atomic/op_decrement.md)    | デクリメント | C++11 |
 | [`operator+=`](atomic/op_plus_assign.md)  | 加算 | C++11 |

reference/atomic/atomic/fetch_fmaximum.md

@@ -0,0 +1,71 @@
+# fetch_fmaximum
+* atomic[meta header]
+* std[meta namespace]
+* atomic[meta class]
+* function[meta id-type]
+* cpp26[meta cpp]
+
+```cpp
+constexpr T
+  fetch_fmaximum(difference_type operand,
+                 memory_order order = memory_order_seq_cst
+                 ) const 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::fmaximum()`](/reference/cmath/fmaximum.md)関数と同様の動作をする
+
+
+## 例
+```cpp example
+#include <iostream>
+#include <atomic>
+
+int main()
+{
+  std::atomic<int> x(2);
+
+  int ret = x.fetch_fmaximum(3);
+
+  std::cout << ret << std::endl;
+  std::cout << x.load() << std::endl;
+}
+```
+* fetch_fmaximum[color ff0000]
+* load()[link load.md]
+
+### 出力
+```
+3
+3
+```
+
+## バージョン
+### 言語
+- C++26
+
+### 処理系
+- [Clang](/implementation.md#clang): 21 [mark noimpl]
+- [GCC](/implementation.md#gcc): 15 [mark noimpl]
+
+
+## 参照
+- [P3008R6 Atomic floating-point min/max](https://open-std.org/jtc1/sc22/wg21/docs/papers/2025/p3008r6.html)

reference/atomic/atomic/fetch_fmaximum_num.md

@@ -0,0 +1,71 @@
+# fetch_fmaximum_num
+* atomic[meta header]
+* std[meta namespace]
+* atomic[meta class]
+* function[meta id-type]
+* cpp26[meta cpp]
+
+```cpp
+constexpr T
+  fetch_fmaximum_num(difference_type operand,
+                     memory_order order = memory_order_seq_cst
+                     ) const 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::fmaximum_num()`](/reference/cmath/fmaximum_num.md)関数と同様の動作をする
+
+
+## 例
+```cpp example
+#include <iostream>
+#include <atomic>
+
+int main()
+{
+  std::atomic<int> x(2);
+
+  int ret = x.fetch_fmaximum_num(3);
+
+  std::cout << ret << std::endl;
+  std::cout << x.load() << std::endl;
+}
+```
+* fetch_fmaximum_num[color ff0000]
+* load()[link load.md]
+
+### 出力
+```
+3
+3
+```
+
+## バージョン
+### 言語
+- C++26
+
+### 処理系
+- [Clang](/implementation.md#clang): 21 [mark noimpl]
+- [GCC](/implementation.md#gcc): 15 [mark noimpl]
+
+
+## 参照
+- [P3008R6 Atomic floating-point min/max](https://open-std.org/jtc1/sc22/wg21/docs/papers/2025/p3008r6.html)

reference/atomic/atomic/fetch_fminimum.md

@@ -0,0 +1,71 @@
+# fetch_fminimum
+* atomic[meta header]
+* std[meta namespace]
+* atomic[meta class]
+* function[meta id-type]
+* cpp26[meta cpp]
+
+```cpp
+constexpr T
+  fetch_fminimum(difference_type operand,
+                 memory_order order = memory_order_seq_cst
+                 ) const 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()`](/reference/cmath/fminimum.md)関数と同様の動作をする
+
+
+## 例
+```cpp example
+#include <iostream>
+#include <atomic>
+
+int main()
+{
+  std::atomic<int> x(3);
+
+  int ret = x.fetch_fminimum(2);
+
+  std::cout << ret << std::endl;
+  std::cout << x.load() << std::endl;
+}
+```
+* fetch_fminimum[color ff0000]
+* load()[link load.md]
+
+### 出力
+```
+2
+2
+```
+
+## バージョン
+### 言語
+- C++26
+
+### 処理系
+- [Clang](/implementation.md#clang): 21 [mark noimpl]
+- [GCC](/implementation.md#gcc): 15 [mark noimpl]
+
+
+## 参照
+- [P3008R6 Atomic floating-point min/max](https://open-std.org/jtc1/sc22/wg21/docs/papers/2025/p3008r6.html)

reference/atomic/atomic/fetch_fminimum_num.md

@@ -0,0 +1,71 @@
+# fetch_fminimum_num
+* atomic[meta header]
+* std[meta namespace]
+* atomic[meta class]
+* function[meta id-type]
+* cpp26[meta cpp]
+
+```cpp
+constexpr T
+  fetch_fminimum_num(difference_type operand,
+                     memory_order order = memory_order_seq_cst
+                     ) const 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()`](/reference/cmath/fminimum_num.md)関数と同様の動作をする
+
+
+## 例
+```cpp example
+#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](/implementation.md#clang): 21 [mark noimpl]
+- [GCC](/implementation.md#gcc): 15 [mark noimpl]
+
+
+## 参照
+- [P3008R6 Atomic floating-point min/max](https://open-std.org/jtc1/sc22/wg21/docs/papers/2025/p3008r6.html)