4. polar

最終更新日時:
が更新

履歴 編集

function template
<simd>

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

namespace std::simd {
  template<simd-floating-point V>
  rebind_t<complex<typename V::value_type>, V> polar(const V& x, const V& y = {}); // C++26
}

概要

実数型を要素とするbasic_vecから、極形式で指定した複素数を要素ごとに生成する。xが絶対値、yが偏角（位相角）を表す。

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

戻り値

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

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

備考

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

例

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

namespace simd = std::simd;

int main()
{
  simd::vec<float, 2> rho = 1.0f; // {1, 1}
  simd::vec<float, 2> theta = std::numbers::pi_v<float> / 4.0f; // {π/4, π/4}

  // 極形式から複素数を要素ごとに生成する
  simd::vec<std::complex<float>, 2> r = simd::polar(rho, theta);

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

出力例

(0.707107, 0.707107) (0.707107, 0.707107)

バージョン

言語

  • C++26

処理系

関連項目

参照