linalg : swap_elementsを追加。

Signed-off-by: Yuya Asano <64895419+sukeya@users.noreply.github.com>

Author: sukeya

reference/linalg.md

@@ -61,7 +61,7 @@ BLAS 1, 2, 3のアルゴリズムでテンプレートパラメータが特に
 | [`setup_givens_rotation_result`](linalg/setup_givens_rotation_result.md) | `setup_givens_rotation`の結果型 (class template) | C++26 |
 | [`setup_givens_rotation`](linalg/setup_givens_rotation.md) | xLARTG: ギブンス回転をセットアップする (function template) | C++26 |
 | [`apply_givens_rotation`](linalg/apply_givens_rotation.md) | xROT: ベクトルにギブンス回転を適用する (function template) | C++26 |
-| `swap_elements` | xSWAP: 2つのベクトル／行列の要素を交換する (function template) | C++26 |
+| [`swap_elements`](linalg/swap_elements.md) | xSWAP: 2つのベクトル／行列の要素を交換する (function template) | C++26 |
 | `scale` | xSCAL: ベクトル／行列の要素にスカラ値を乗算する (function template) | C++26 |
 | `copy` | xCOPY: ベクトル／行列の要素をコピーする (function template) | C++26 |
 | `add` | xAXPY: 2つのベクトル／行列の要素を加算する (function template) | C++26 |

reference/linalg/swap_elements.md

@@ -0,0 +1,81 @@
+# swap_elements
+
+* [mathjax enable]
+* linalg[meta header]
+* function template[meta id-type]
+* std::linalg[meta namespace]
+* cpp26[meta cpp]
+
+
+```cpp
+namespace std::linalg {
+  template<inout-object InOutObj1,
+         inout-object InOutObj2>
+  void swap_elements(InOutObj1 x,
+                    InOutObj2 y); // (1)
+
+  template<class ExecutionPolicy,
+          inout-object InOutObj1,
+          inout-object InOutObj2>
+  void swap_elements(ExecutionPolicy&& exec,
+                    InOutObj1 x,
+                    InOutObj2 y); // (2)
+}
+```
+
+
+## 概要
+同じサイズの2つのベクトル`x`と`y`を交換する。
+
+
+## テンプレートパラメータ制約
+`x`と`y`の次元が等しくなければならない。
+- `x.rank() == y.rank()`
+
+
+## 適格要件
+- 0以上`x.rank()`未満の整数rに対して、[`compatible-static-extents`](/reference/linalg/compatible-static-extents.md)`<InOutVec1, InOutVec2>(r,r)`が`true`
+
+
+## 事前条件
+`x`と`y`の各次元の要素数が等しくなければならない。
+- `x.extents() == y.extents()`
+
+
+## 効果
+`x`と`y`の対応する成分全てを交換する。
+
+- (1): 逐次実行する。
+- (2): 指定された実行ポリシーに応じて実行する。
+
+
+## 戻り値
+なし
+
+
+## 例
+
+
+### 出力
+
+
+## バージョン
+### 言語
+- C++26
+
+### 処理系
+- [Clang](/implementation.md#clang): ??
+- [GCC](/implementation.md#gcc): ??
+- [ICC](/implementation.md#icc): ??
+- [Visual C++](/implementation.md#visual_cpp): ??
+
+
+## 関連項目
+- [`execution`](/reference/execution.md)
+- [`mdspan`](/reference/mdspan.md)
+
+
+## 参照
+- [P0788R3 Standard Library Specification in a Concepts and Contracts World](http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2018/p0788r3.pdf)
+- [`LAPACK: cswap`](https://netlib.org/lapack/explore-html/d1/d45/group__rot_ga25544801d45dcabdec7b24d863ebea9c.html#ga25544801d45dcabdec7b24d863ebea9c)
+