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)
其他重载 (自 C++11 起)
在头文件 `<cmath>` 中定义
template< class Integer > double sqrt ( Integer num );		(A)	(自 C++26 起为 constexpr)

1-3) 计算 num 的平方根。库为所有 cv 无限定浮点类型提供了 std::sqrt 的重载，作为参数的类型。(自 C++23 起)

A) 为所有整数类型提供了其他重载，这些类型被视为 double.

(自 C++11 起)

[编辑] 参数

num

-

浮点或整数值

[编辑] 返回值

如果未发生错误，则返回 num 的平方根 (${\small \sqrt{num} }$ $\sqrt num$ )。

如果发生域错误，则返回实现定义的值（在支持的情况下返回 NaN）。

如果因下溢而发生范围错误，则返回正确的结果（四舍五入后）。

[编辑] 错误处理

错误按 math_errhandling 中指定的报告。

如果 num 小于零，则会发生域错误。

如果实现支持 IEEE 浮点运算（IEC 60559），

如果参数小于 -0，则会引发 FE_INVALID 并返回 NaN。
如果参数为 +∞ 或 ±0，则会返回其本身，不进行修改。
如果参数为 NaN，则返回 NaN。

[编辑] 备注

根据 IEEE 标准，要求 std::sqrt 从无限精确的结果中进行正确舍入。特别是，如果结果可以在浮点类型中表示，则会生成精确的结果。唯一要求此功能的其他操作是算术运算符和函数 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)	计算两个或三个(自 C++17 起)给定数字的平方和的平方根 ($\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)	将函数 std::sqrt 应用于 valarray 的每个元素 (函数模板) [编辑]
C 文档 for sqrt

编译器支持
独立和托管
语言
标准库
标准库头文件
命名需求
特性测试宏 (C++20)
语言支持库
概念库 (C++20)
元编程库 (C++11)
诊断库
通用实用程序库
字符串库
容器库
迭代器库
范围库 (C++20)
算法库
数值库
本地化库
输入/输出库
文件系统库 (C++17)
正则表达式库 (C++11)
并发支持库 (C++11)
执行支持库 (C++26)
技术规范
符号索引
外部库

cppreference.com

命名空间

变体

视图

操作