norm.md

norm

• simd[meta header]
• std::simd[meta namespace]
• function template[meta id-type]
• cpp26[meta cpp]

namespace std::simd {
  template<simd-complex V>
  constexpr rebind_t<simd-complex-value-type<V>, V> norm(const V& v); // C++26
}

• simd-complex-value-type[link /reference/simd/simd-complex-value-type.md]
• simd-complex[link /reference/simd/simd-complex.md]
• complex[link /reference/complex/complex.md]

概要

要素型がstd::complex<T>のbasic_vecについて、各要素のノルム（絶対値の2乗）を求め、実数型Tを要素とするbasic_vecとして返す。

制約simd-complexは、Vが要素型std::complex<T>のbasic_vecであることを表す説明専用のコンセプトである。simd-complex-value-type<V>はVの要素型std::complex<T>におけるT（実数型）を表す。戻り値の型はVの要素数はそのままに要素型をTとしたbasic_vecとなる。

戻り値

各要素i（0以上V::size()未満）について、v[i]に<complex>のnormを適用した結果で初期化されたbasic_vecオブジェクトを返す。

ある要素iについて定義域エラー・極エラー・値域エラーが発生する場合、その要素の値は未規定である。

備考

errnoにアクセスするか否かは未規定である。

例

#include <simd>
#include <complex>
#include <print>

namespace simd = std::simd;

int main()
{
  simd::vec<std::complex<float>, 2> v{
    [](int i) { return std::complex<float>(i + 1.0f, i + 2.0f); }
  };  // {(1, 2), (2, 3)}

  // 各要素のノルム（絶対値の2乗）を求める
  simd::vec<float, 2> n = simd::norm(v);

  for (std::size_t i = 0; i < n.size(); ++i)
    std::print("{} ", n[i]);
  std::println("");
}

• simd::norm[color ff0000]

出力例

5 13 

バージョン

言語

• C++26

処理系

• Clang: 22 [mark noimpl]
• GCC: 16.1 [mark noimpl]
• Visual C++: 2026 Update 2 [mark noimpl]

関連項目

• std::simd::abs
• std::simd::arg
• std::simd::conj
• std::simd::real
• std::simd::imag
• std::complex::norm

参照

• P1928R15 std::simd — merge data-parallel types from the Parallelism TS 2
  • C++26でstd::simdライブラリが追加された
• P2663R7 Interleaved complex values support in std::simd
  • 要素型が複素数のbasic_vecに対する複素数関連の関数が追加された