命名空间
变体
操作

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

来自 cppreference.cn
< cpp‎ | 数值‎ | 数学
 
C++
 
数值库
 
常用数学函数
函数
基本操作
(C++11)  
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)(C++11)(C++11)
指数函数
(C++11)
(C++11)

(C++11)
(C++11)
幂函数
sqrt
(C++11)
(C++11)
三角和
双曲函数
(C++11)
(C++11)
(C++11)

误差函数和伽马函数
(C++11)
(C++11)
(C++11)
(C++11)
取整浮点运算
(C++11)(C++11)(C++11)
(C++11)
(C++11)
(C++11)(C++11)(C++11)
浮点操纵函数
(C++11)(C++11)
(C++11)
(C++11)
(C++11)(C++11)
(C++11)
分类和比较
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
类型
(C++11)
(C++11)
(C++11)
宏常量
分类
(C++11)(C++11)(C++11)(C++11)(C++11)


 
定义于头文件 <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< /*数学浮点类型*/ V >

constexpr /*推导 SIMD 类型*/<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 的重载作为参数类型。(C++23 起)
S) SIMD 重载对 v_num 执行逐元素 std::sqrt。
(有关它们的定义，请参阅 math-floating-point 和 deduced-simd-t。)
(C++26 起)
A) 为所有整数类型提供了额外的重载，它们被视为 double。
 (C++11 起)

目录

[编辑] 参数

num - 浮点值或整数值

[编辑] 返回值

如果没有发生错误，返回 num 的平方根（√num）。

如果发生域错误，则返回实现定义的值 (支持 NaN 时返回 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

[编辑] 参阅

(C++11)(C++11)
 将数字提升到给定幂（xy）
(函数) [编辑]
(C++11)(C++11)(C++11)
 计算立方根（3√x）
(函数) [编辑]
(C++11)(C++11)(C++11)
 计算斜边 √x2
+y2
 和 √x2
+y2
+z2
(C++17 起)
(函数) [编辑]
 右半平面范围内的复平方根
(函数模板) [编辑]
 将函数 std::sqrt 应用于 valarray 的每个元素
(函数模板) [编辑]
C 文档 用于 sqrt
取自 "https://cppreference.cn/mwiki/index.php?title=cpp/numeric/math/sqrt&oldid=160742"