sqrt, sqrtf, sqrtl

参数

返回值

若无错误发生，则返回 arg 的平方根 ( \({\small \sqrt{arg} }\) √ arg )。

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

如果由于下溢发生范围错误，将返回正确结果（舍入后）。

错误处理

错误报告方式遵循 math_errhandling 中的规范。

当 arg 小于零时会发生定义域错误。

如果实现支持 IEEE 浮点算术 (IEC 60559)，

• 若参数小于 -0，将引发 FE_INVALID 并返回 NaN。
• 若参数为 +∞ 或 ±0，则直接返回原值。
• 若参数为 NaN，则返回 NaN。

注释

sqrt 函数根据 IEEE 标准要求必须从无限精确的结果进行正确舍入。特别地，如果精确结果可以用浮点类型表示，则必须产生该精确结果。唯一其他有此要求的是 算术运算符 和函数 fma 。其他函数（包括 pow ）则不受此约束。

示例

#include <errno.h>
#include <fenv.h>
#include <math.h>
#include <stdio.h>
// #pragma STDC FENV_ACCESS ON
int main(void)
{
    // 常规用法
    printf("sqrt(100) = %f\n", sqrt(100));
    printf("sqrt(2) = %f\n", sqrt(2));
    printf("golden ratio = %f\n", (1 + sqrt(5)) / 2);
    // 特殊值
    printf("sqrt(-0) = %f\n", sqrt(-0.0));
    // 错误处理
    errno = 0; feclearexcept(FE_ALL_EXCEPT);
    printf("sqrt(-1.0) = %f\n", sqrt(-1));
    if (errno == EDOM)
        perror("    errno == EDOM");
    if (fetestexcept(FE_INVALID))
        puts("    FE_INVALID was raised");
}

sqrt(100) = 10.000000
sqrt(2) = 1.414214
golden ratio = 1.618034
sqrt(-0) = -0.000000
sqrt(-1.0) = -nan
    errno = EDOM: Numerical argument out of domain
    FE_INVALID was raised

参考文献

另请参阅