std::sqrt, std::sqrtf, std::sqrtl

ヘッダー `<cmath>` で定義
	(1)
float sqrt ( float num ); double sqrt ( double num ); long double sqrt ( long double num );			(C++23まで)
/浮動小数点数型/ sqrt ( /浮動小数点型/ num );			(C++23から) (C++26 以降 constexpr)
float sqrtf( float num );		(2)	(C++11以降) (C++26 以降 constexpr)
long double sqrtl( long double num );		(3)	(C++11以降) (C++26 以降 constexpr)
SIMDオーバーロード (C++26以降)
ヘッダー `<simd>` で定義
template< /math-floating-point/ V > constexpr /deduced-simd-t/<V> sqrt ( const V& v_num );		(S)	(C++26以降)
追加のオーバーロード (C++11以降)
ヘッダー `<cmath>` で定義
template< class Integer > double sqrt ( Integer num );		(A)	(C++26 以降 constexpr)

1-3) num の平方根を計算します。ライブラリは、パラメータの型として、すべての cv 修飾されていない浮動小数点型に対する std::sqrt のオーバーロードを提供します。(since C++23)

S) SIMD オーバーロードは、v_num に対して要素ごとの std::sqrt を実行します。

(定義については、math-floating-point および deduced-simd-t を参照してください。)

(C++26以降)

A) すべての整数型に対する追加のオーバーロードが提供されます。これらは double として扱われます。

(C++11以降)

std::sqrt は、IEEE 標準によって無限に正確な結果から正しく丸められることが要求されます。特に、平方根が浮動小数点型で表現できる場合、正確な結果が生成されます。この要件を満たす他の操作は、算術演算子と関数 std::fma のみです。std::pow を含む他の関数は、この制約を受けません。

追加のオーバーロードは、(A) とまったく同じように提供される必要はありません。整数型の引数 num に対して、std::sqrt(num) が std::sqrt(static_cast<double>(num)) と同じ効果を持つことを保証するのに十分なものであればよいです。

[編集] 例

このコードを実行

#include <cerrno>
#include <cfenv>
#include <cmath>
#include <cstring>
#include <iostream>
// #pragma STDC FENV_ACCESS ON
 
int main()
{
    // normal use
    std::cout << "sqrt(100) = " << std::sqrt(100) << '\n'
              << "sqrt(2) = " << std::sqrt(2) << '\n'
              << "golden ratio = " << (1 + std::sqrt(5)) / 2 << '\n';
 
    // special values
    std::cout << "sqrt(-0) = " << std::sqrt(-0.0) << '\n';
 
    // error handling
    errno = 0;
    std::feclearexcept(FE_ALL_EXCEPT);
 
    std::cout << "sqrt(-1.0) = " << std::sqrt(-1) << '\n';
    if (errno == EDOM)
        std::cout << "    errno = EDOM " << std::strerror(errno) << '\n';
    if (std::fetestexcept(FE_INVALID))
        std::cout << "    FE_INVALID raised\n";
}

実行結果の例

sqrt(100) = 10
sqrt(2) = 1.41421
golden ratio = 1.61803
sqrt(-0) = -0
sqrt(-1.0) = -nan
    errno = EDOM Numerical argument out of domain
    FE_INVALID raised

[編集] 関連項目

powpowfpowl (C++11)(C++11)	数値を指定されたべき乗に累乗する ($\small{x^y}$ $x y$ ) (関数) [編集]
cbrtcbrtfcbrtl (C++11)(C++11)(C++11)	立方根を計算する ($\small{\sqrt[3]{x}}$ $3 \sqrt x$ ) (関数) [編集]
hypothypotfhypotl (C++11)(C++11)(C++11)	斜辺 $\scriptsize{\sqrt{x^2+y^2}}$ $\sqrt x 2 +y 2$ を計算するおよび $\scriptsize{\sqrt{x^2+y^2+z^2}}$ $\sqrt x 2 +y 2 +z 2$ (C++17 から) (関数) [編集]
sqrt(std::complex)	複素数の平方根、右半平面の範囲 (関数テンプレート) [編集]
sqrt(std::valarray)	valarray の各要素に関数 std::sqrt を適用します。 (function template) [編集]
C のドキュメント（sqrt）

コンパイラサポート
フリースタンディングとホスト
言語
標準ライブラリ
標準ライブラリヘッダー
名前付き要件
機能テストマクロ (C++20)
言語サポートライブラリ
コンセプトライブラリ (C++20)
診断ライブラリ
メモリ管理ライブラリ
メタプログラミングライブラリ (C++11)
汎用ユーティリティライブラリ
コンテナライブラリ
イテレータライブラリ
Rangesライブラリ (C++20)
アルゴリズムライブラリ
文字列ライブラリ
テキスト処理ライブラリ
数値ライブラリ
日付と時刻ライブラリ
入出力ライブラリ
ファイルシステムライブラリ (C++17)
並行サポートライブラリ (C++11)
実行制御ライブラリ (C++26)
Technical specifications (技術仕様)
シンボルインデックス
外部ライブラリ

cppreference.com

名前空間

変種

表示

操作

std::sqrt, std::sqrtf, std::sqrtl

目次

[編集] パラメータ

[編集] 戻り値

[編集] エラー処理

[編集] 注記

[編集] 例

[編集] 関連項目

ナビゲーション

ツールボックス

powpowfpowl (C++11)(C++11)	数値を指定されたべき乗に累乗する (\(\small{x^y}\) $x y$ ) (関数) [編集]
cbrtcbrtfcbrtl (C++11)(C++11)(C++11)	立方根を計算する (\(\small{\sqrt[3]{x}}\) $3 \sqrt x$ ) (関数) [編集]
hypothypotfhypotl (C++11)(C++11)(C++11)	斜辺 \(\scriptsize{\sqrt{x^2+y^2}}\) $\sqrt x 2 +y 2$ を計算するおよび \(\scriptsize{\sqrt{x^2+y^2+z^2}}\) $\sqrt x 2 +y 2 +z 2$ (C++17 から) (関数) [編集]
sqrt(std::complex)	複素数の平方根、右半平面の範囲 (関数テンプレート) [編集]
sqrt(std::valarray)	valarray の各要素に関数 std::sqrt を適用します。 (function template) [編集]
C のドキュメント（sqrt）