Skip to content

abs.md

Latest commit

 

History

History
143 lines (109 loc) · 5.29 KB

abs.md

File metadata and controls

143 lines (109 loc) · 5.29 KB
Raw

abs

  • simd[meta header]
  • std::simd[meta namespace]
  • function template[meta id-type]
  • cpp26[meta cpp]
namespace std::simd {
  // 浮動小数点版
  template<math-floating-point V>
  constexpr deduced-vec-t<V>
    abs(const V& j);                 // (1) C++26

  // 符号付き整数版
  template<std::signed_integral T, class Abi>
  constexpr basic_vec<T, Abi>
    abs(const basic_vec<T, Abi>& j); // (2) C++26

  // 複素数版
  template<simd-complex V>
  constexpr rebind_t<simd-complex-value-type<V>, V>
    abs(const V& v);                 // (3) C++26
}
  • deduced-vec-t[link /reference/simd/deduced-vec-t.md]
  • simd-complex-value-type[link /reference/simd/simd-complex-value-type.md]
  • math-floating-point[link /reference/simd/math-floating-point.md]
  • simd-complex[link /reference/simd/simd-complex.md]
  • std::signed_integral[link /reference/concepts/signed_integral.md]
  • basic_vec[link basic_vec.md]
  • rebind_t[link rebind.md]

概要

basic_vecの各要素について、絶対値を求める。

  • (1) : 浮動小数点要素の各要素の絶対値を求める。
  • (2) : 符号付き整数要素の各要素の絶対値を求める。
  • (3) : 複素数要素の各要素の絶対値（大きさ・マグニチュード）を求め、実数型を要素とするbasic_vecとして返す。

制約math-floating-pointは、Vが浮動小数点要素のbasic_vec、またはそこからbasic_vecを導出可能なスカラー浮動小数点型であることを表す説明専用のコンセプトである。deduced-vec-t<V>は、Vに対応するbasic_vec型を表す。

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

事前条件

  • (2) : all_of(j >= -std::numeric_limits<T>::max())がtrueであること。すなわち、Tの最小値（std::numeric_limits<T>::min()）は許容されない。

戻り値

  • (1) : 各要素iについて、jの対応する要素に<cmath>のabsを適用した結果で初期化されたdeduced-vec-t<V>型のオブジェクトを返す。
  • (2) : 各要素i（0以上j.size()未満）について、abs(j[i])で初期化されたbasic_vecオブジェクトを返す。
  • (3) : 各要素i（0以上V::size()未満）について、v[i]に<complex>のabsを適用した結果で初期化されたbasic_vecオブジェクトを返す。

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

備考

  • (1), (3) : errnoにアクセスするか否かは未規定である。

例

基本的な使い方

#include <simd>
#include <print>

namespace simd = std::simd;

int main()
{
  simd::vec<int, 4> v{[](int i) { return i % 2 == 0 ? -(i + 1) : (i + 1); }};
  // {-1, 2, -3, 4}

  // 各要素の絶対値を求める
  simd::vec<int, 4> a = simd::abs(v);

  for (int i = 0; i < a.size(); ++i)
    std::print("{} ", a[i]);
  std::println("");
}
  • simd::abs[color ff0000]
  • simd::vec[link basic_vec.md]

出力

1 2 3 4

複素数版の例 (C++26)

#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 + 3.0f, i + 4.0f); }
  };  // {(3, 4), (4, 5)}

  // 各要素の絶対値（大きさ）を求める
  simd::vec<float, 2> a = simd::abs(v);

  for (std::size_t i = 0; i < a.size(); ++i)
    std::print("{} ", a[i]);
  std::println("");
}
  • simd::abs[color ff0000]
  • simd::vec[link basic_vec.md]

出力例

5 6.40312

バージョン

言語

  • C++26

処理系

関連項目

参照