4. copysign

最終更新日時:
が更新

履歴 編集

function template
<simd>

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

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

  template<math-floating-point V>
  constexpr deduced-vec-t<V>
    copysign(const deduced-vec-t<V>& x, const V& y); // (2) C++26

  template<math-floating-point V>
  constexpr deduced-vec-t<V>
    copysign(const V& x, const deduced-vec-t<V>& y); // (3) C++26
}

概要

浮動小数点要素型のbasic_vecについて、各要素x[i]の大きさとy[i]の符号を合成した値を求める。各要素にstd::copysignを適用する。

制約math-floating-pointは、Vが浮動小数点要素型のbasic_vec、またはそれと組み合わせてbasic_vecを導出できる型であることを表す説明専用のコンセプトである。deduced-vec-t<V>は、引数から導出されるbasic_vec型である。

戻り値

各要素i（0以上deduced-vec-t<V>::size()未満）について、x[i]の大きさとy[i]の符号を持つ値（x[i]とy[i]にstd::copysignを適用した結果）で初期化されたbasic_vecオブジェクトを返す。

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

備考

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

例

#include <simd>
#include <print>

namespace simd = std::simd;

int main()
{
  simd::vec<float, 4> mag([](int i) { return i + 1.0f; }); // {1, 2, 3, 4}
  simd::vec<float, 4> sign([](int i) { return i % 2 ? 1.0f : -1.0f; }); // {-1, 1, -1, 1}

  // magの大きさとsignの符号を合成する
  simd::vec<float, 4> r = simd::copysign(mag, sign);

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

出力

-1 2 -3 4

バージョン

言語

  • C++26

処理系

関連項目

参照