4. swap_elements

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

履歴 編集

function template
<linalg>

std::linalg::swap_elements(C++26)

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()

適格要件

事前条件

xとyの各次元の要素数が等しくなければならない。

  • x.extents() == y.extents()

効果

xとyの対応する成分全てを交換する。

  • (1): 逐次実行する。
  • (2): 指定された実行ポリシーに応じて実行する。

戻り値

なし

例

[注意] 処理系にあるコンパイラで確認していないため、間違っているかもしれません。

#include <cmath>
#include <execution>
#include <iostream>
#include <linalg>
#include <mdspan>
#include <vector>


template <class Vector>
void print(Vector v) {
  for (int i = 0; i < v.extent(0) - 1; ++i) {
    std::cout << v[i] << ", ";
  }
  std::cout << v[v.extent(0) - 1] << std::endl;
}


int main()
{
  constexpr size_t N = 3;

  std::vector<double> a_vec({1, 2, 3});
  std::mdspan a(a_vec.data(), N);

  std::vector<double> b_vec({4, 5, 6});
  std::mdspan b(b_vec.data(), N);

  // (1)
  std::linalg::swap_elements(a, b);
  std::cout << "(1)\n";
  std::cout << "a\n";
  print(a);
  std::cout << "b\n";
  print(b);

  // (2)
  std::linalg::swap_elements(std::execution::par, a, b);
  std::cout << "(2)\n";
  std::cout << "a\n";
  print(a);
  std::cout << "b\n";
  print(b);

  return 0;
}

出力

(1)
a
4, 5, 6
b
1, 2, 3
(2)
a
1, 2, 3
b
4, 5, 6

バージョン

言語

  • C++26

処理系

関連項目

参照