最終更新日時:
が更新

履歴 編集

function template
<simd>

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

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

  template<simd-complex V>
  constexpr V cos(const V& v);                 // (2) C++26
}

概要

basic_vecの各要素について、余弦(コサイン)を求める。

  • (1) : 要素型が浮動小数点数のbasic_vec、またはスカラーの浮動小数点数xについて、各要素の余弦を求める。
  • (2) : 要素型がstd::complex<T>basic_vecについて、各要素の余弦を求める。

制約math-floating-pointは、Vが浮動小数点数の「vectorizable type」を要素とするbasic_vec、またはスカラーの浮動小数点数であることを表す説明専用のコンセプトである。deduced-vec-t<V>は、Vに対応するbasic_vec型(decltype(x + x))である。

制約simd-complexは、Vが要素型std::complex<T>basic_vecであることを表す説明専用のコンセプトである。

戻り値

  • (1) : 各要素iについて、xの各要素に<cmath>cosを適用した結果を要素とするbasic_vecオブジェクトを返す。
  • (2) : 各要素i0以上V::size()未満)について、v[i]<complex>cosを適用した結果で初期化されたbasic_vecオブジェクトを返す。

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

備考

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

基本的な使い方

#include <simd>
#include <print>

namespace simd = std::simd;

int main()
{
  simd::vec<float, 4> v([](int i) { return i * 0.5f; }); // {0, 0.5, 1, 1.5}

  // 各要素の余弦を求める
  simd::vec<float, 4> r = simd::cos(v);

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

出力例

1 0.877583 0.540302 0.0707372 

複素数版

#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, 0.0f); }
  };  // {(0, 0), (1, 0)}

  // 各要素の余弦を求める
  simd::vec<std::complex<float>, 2> r = simd::cos(v);

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

出力例

(1, 0) (0.540302, 0) 

バージョン

言語

  • C++26

処理系

関連項目

参照