4. pow

最終更新日時:
が更新

履歴 編集

function template
<simd>

std::simd::pow(C++26)

namespace std::simd {
  template<math-floating-point V>
  constexpr deduced-vec-t<V> pow(const V& x, const V& y);                // (1) C++26
  template<math-floating-point V>
  constexpr deduced-vec-t<V> pow(const deduced-vec-t<V>& x, const V& y); // (2) C++26
  template<math-floating-point V>
  constexpr deduced-vec-t<V> pow(const V& x, const deduced-vec-t<V>& y); // (3) C++26

  template<simd-complex V>
  constexpr V pow(const V& x, const V& y);                               // (4) C++26
}

概要

basic_vecの各要素について、各要素を底、対応する各要素を指数とする累乗（xy）を求める。

  • (1) : 両引数をV（浮動小数点数型を要素とするbasic_vec）として受け取り、各要素に<cmath>のpowを要素ごとに適用する。
  • (2), (3) : 一方の引数をスカラー値（または対応するbasic_vec）で受け取れるようにするオーバーロードである。
  • (4) : 要素型がstd::complex<T>のbasic_vecについて、各要素に<complex>のpowを要素ごとに適用する。

制約math-floating-pointは、Vが浮動小数点数型を要素とするbasic_vecであることを表す説明専用のコンセプトである。deduced-vec-t<V>はVから導出されるbasic_vec型（通常はV自身）を表す。一方の引数をdeduced-vec-t<V>とするオーバーロードにより、スカラー値を渡して全要素にブロードキャストできる。制約simd-complexは、Vが要素型std::complex<T>のbasic_vecであることを表す説明専用のコンセプトである。

戻り値

各要素i（0以上V::size()未満）について、x[i]とy[i]に対応するpowを適用した結果に要素ごとに等しいbasic_vecオブジェクトを返す。

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

備考

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

例

基本的な使い方

#include <simd>
#include <print>

namespace simd = std::simd;

int main()
{
  simd::vec<float, 4> x([](int i) { return float(i + 2); }); // {2, 3, 4, 5}

  // 全要素を2乗する（スカラー値2.0fが全要素にブロードキャストされる）
  simd::vec<float, 4> r = simd::pow(x, 2.0f);

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

出力例

4 9 16 25

複素数版 (4)

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

namespace simd = std::simd;

int main()
{
  simd::vec<std::complex<float>, 2> x{
    [](int i) { return std::complex<float>(i + 2.0f, 0.0f); }
  };  // {(2, 0), (3, 0)}
  simd::vec<std::complex<float>, 2> y = std::complex<float>(2.0f, 0.0f); // 全要素が (2, 0)

  // 各要素の累乗を求める
  simd::vec<std::complex<float>, 2> r = simd::pow(x, y);

  for (std::size_t i = 0; i < r.size(); ++i) {
    std::complex<float> c = r[i];
    std::print("({}, {}) ", c.real(), c.imag());
  }
  std::println("");
}

出力例

(4, 0) (9, 0)

バージョン

言語

  • C++26

処理系

関連項目

参照