4. reduce_min

最終更新日時:
が更新

履歴 編集

function template
<simd>

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

namespace std::simd {
  template<class T, class Abi>
  constexpr T
    reduce_min(const basic_vec<T, Abi>& x) noexcept; // (1) C++26

  template<class T, class Abi>
  constexpr T
    reduce_min(const basic_vec<T, Abi>& x,
               const typename basic_vec<T, Abi>::mask_type& mask) noexcept; // (2) C++26

  template<class T>
  constexpr T
    reduce_min(const T& x) noexcept; // (3) C++26

  template<class T>
  constexpr T
    reduce_min(const T& x,
               std::same_as<bool> auto mask) noexcept; // (4) C++26
}

概要

basic_vecの要素のうち、最小の値を取得する。

  • (1) : xの全要素の最小値を返す。
  • (2) : maskで選択された要素の最小値を返す。ひとつも選択されていない場合はTの最大値を返す。
  • (3) : スカラー値xをそのまま返す（SIMD-genericなコードを書けるようにするためのオーバーロード）。
  • (4) : maskがtrueならxを、falseならTの最大値を返す。

テンプレートパラメータ制約

戻り値

  • (1) : すべてのi（0以上x.size()未満）についてx[i] < x[j]がfalseとなるような要素x[j]の値を返す。
  • (2) : none_of(mask)がtrueならstd::numeric_limits<T>::max()を返す。そうでなければ、maskで選択されたすべてのインデックスiについてx[i] < x[j]がfalseとなるような選択要素x[j]の値を返す。
  • (3) : xを返す。
  • (4) : maskがfalseならstd::numeric_limits<T>::max()を、そうでなければxを返す。

例外

投げない

例

#include <simd>
#include <print>

namespace simd = std::simd;

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

  // 全要素の最小値
  std::println("{}", simd::reduce_min(v));

  // 選択された要素（値が2以上）の最小値
  std::println("{}", simd::reduce_min(v, v >= 2));
}

出力

0
2

バージョン

言語

  • C++26

処理系

関連項目

参照