• Class / Function / Type

      std::
    • Header file

      <>
    • Other / All

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

    履歴 編集

    function template
    <linalg>

    std::linalg::scaled

    namespace std::linalg {
      template<class ScalingFactor,
               class ElementType, class Extents, class Layout, class Accessor>
      constexpr auto scaled(ScalingFactor alpha, mdspan<ElementType, Extents, Layout, Accessor> x);
    }
    

    概要

    多次元配列ビューstd::mdspanに対して、要素値がスカラー倍された新しい多次元配列ビューを作る。

    本操作によりmdspan参照先メモリブロックが書き換えられることはなく、戻り値mdspanを介した要素アクセス時にスケーリング係数の乗算が行われる。

    戻り値

    説明用の型SAscaled_accessor<ScalingFactor, Accessor>として、次の値を返す。

    mdspan<typename SA::element_type, Extents, Layout, SA>(
      x.data_handle(), x.mapping(), SA(alpha, x.accessor()))
    

    #include <cassert>
    #include <linalg>
    #include <mdspan>
    
    int main()
    {
      int arr[] = {1, 2, 3, 4};
      std::mdspan vec0{arr, 4};
      // 1 2 3 4
    
      auto vec1 = std::linalg::scaled(2, vec0);
      // 2 4 6 8
      assert(vec1[0] == 2);
    
      // linalg::scaled適用後のmdspan要素は読み取り専用となり、
      // 例えば vec1[0] = 42; はコンパイルエラーを引き起こす。
    }
    

    出力

    バージョン

    言語

    • C++26

    処理系

    関連項目

    参照