Skip to content

conjugated.md

Latest commit

 

History

History
91 lines (70 loc) · 2.92 KB

conjugated.md

File metadata and controls

91 lines (70 loc) · 2.92 KB

conjugated

  • linalg[meta header]
  • function template[meta id-type]
  • std::linalg[meta namespace]
  • cpp26[meta cpp]
namespace std::linalg {
  template<class ElementType, class Extents, class Layout, class Accessor>
    constexpr auto conjugated(mdspan<ElementType, Extents, Layout, Accessor> a);
}
  • Extents[link /reference/mdspan/extents.md]
  • Layout[link /reference/mdspan/LayoutMappingPolicy.md]
  • Accessor[link /reference/mdspan/AccessorPolicy.md]
  • mdspan[link /reference/mdspan/mdspan.md]

概要

多次元配列ビューstd::mdspanに対して、要素値の複素共役変換を行なった新しい多次元配列ビューを作る。

本操作によりmdspan参照先メモリブロックが書き換えられることはなく、戻り値mdspanを介した要素アクセス時に複素共役変換が行われる。

戻り値

  • Accessorがconjugated_accessorの特殊化のとき、説明用の型Aをremove_cvref_t<decltype(a.accessor().nested_accessor())>として、

    mdspan<typename A::element_type, Extents, Layout, A>(
  a.data_handle(), a.mapping(), a.accessor().nested_accessor())
    • mdspan[link /reference/mdspan/mdspan.md]
    • Extents[link /reference/mdspan/extents.md]
    • Layout[link /reference/mdspan/LayoutMappingPolicy.md]

  • そうではないとき、説明用の型Aをconjugated_accessor<Accessor>として、

    mdspan<typename A::element_type, Extents, Layout, A>(
  a.data_handle(), a.mapping(), conjugated_accessor(a.accessor()))
    • mdspan[link /reference/mdspan/mdspan.md]
    • Extents[link /reference/mdspan/extents.md]
    • Layout[link /reference/mdspan/LayoutMappingPolicy.md]

例

#include <cassert>
#include <complex>
#include <linalg>
#include <mdspan>

int main()
{
  std::complex<double> arr[] = {{1, 1}, {2, 2}, {3, 3}};
  std::mdspan vec0{arr, 3};
  // 1+i 2+2i 3+3i

  auto vec1 = std::linalg::conjugated(vec0);
  // 1-i 2-2i 3-3i
  assert(real(vec1[0]) == 1 && imag(vec1[0]) == -1);

  // linalg::conjugated適用後のmdspan要素は読み取り専用となり、
  // 例えば vec1[0] = {4, 4}; はコンパイルエラーを引き起こす。
}
  • std::linalg::conjugated[color ff0000]

出力

バージョン

言語

  • C++26

処理系

関連項目

参照