sqrt.md

sqrt

• 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> sqrt(const V& x); // (1) C++26

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

• deduced-vec-t[link /reference/simd/deduced-vec-t.md]
• math-floating-point[link /reference/simd/math-floating-point.md]
• simd-complex[link /reference/simd/simd-complex.md]

概要

basic_vecの各要素について、平方根を求める。

• (1) : 浮動小数点数型を要素とするbasic_vecについて、各要素に<cmath>のsqrtを要素ごとに適用する。
• (2) : 要素型がstd::complex<T>のbasic_vecについて、各要素に<complex>のsqrtを要素ごとに適用する。

制約math-floating-pointは、Vが浮動小数点数型を要素とするbasic_vecであることを表す説明専用のコンセプトである。deduced-vec-t<V>はVから導出されるbasic_vec型（通常はV自身）を表す。制約simd-complexは、Vが要素型std::complex<T>のbasic_vecであることを表す説明専用のコンセプトである。

戻り値

各要素i（0以上V::size()未満）について、v[i]（x[i]）に対応するsqrtを適用した結果に要素ごとに等しいbasic_vecオブジェクトを返す。

• (1) : <cmath>のsqrtを適用する。
• (2) : <complex>のsqrtを適用する。

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

備考

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

例

基本的な使い方

#include <simd>
#include <print>

namespace simd = std::simd;

int main()
{
  simd::vec<float, 4> v{[](int i) {
    float table[] = {1.0f, 4.0f, 9.0f, 16.0f};
    return table[i];
  }};

  // 各要素の平方根を求める
  simd::vec<float, 4> r = simd::sqrt(v);

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

• simd::sqrt[color ff0000]

出力例

1 2 3 4 

複素数版 (2)

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

  // 各要素の平方根を求める
  simd::vec<std::complex<float>, 2> r = simd::sqrt(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("");
}

• simd::sqrt[color ff0000]

出力例

(1, 0) (1.41421, 0) 

バージョン

言語

• C++26

処理系

• Clang: 22 [mark noimpl]
• GCC: 16.1 [mark noimpl]
• Visual C++: 2026 Update 2 [mark noimpl]

関連項目

• std::simd::cbrt
• std::simd::hypot
• std::simd::pow
• std::simd::exp
• std::simd::log
• std::sqrt
• std::complex::sqrt

参照

• P1928R15 std::simd — merge data-parallel types from the Parallelism TS 2
  • C++26でstd::simdライブラリが追加され、実数版のsqrt (1) が追加された
• P2663R7 Interleaved complex values support in std::simd
  • 要素型が複素数のbasic_vecに対する複素数版のsqrt (2) が追加された