cpp/numeric/math/fabs：修订间差异

float       abs( float num );
double      abs( double num );
long double abs( long double num );

constexpr /* 浮点类型 */ abs( /* 浮点类型 */ num );

float       fabs ( float num );
double      fabs ( double num );
long double fabs ( long double num );

constexpr /* 浮点类型 */ fabs( /* 浮点类型 */ num );

float       fabsf( float num );

long double fabsl( long double num );

template< class Integer >
double      fabs ( Integer num );

对于整数参数，std::abs 的整数重载通常是更好的匹配。如果以不能由整数提升转换成 int 的无符号整型参数调用 std::abs，那么程序非良构。

参数

返回值

在成功时返回 arg 的绝对值（|arg|）。值是准确的，且不依赖任何舍入模式。

错误处理

此函数不受制于任何指定于 math_errhandling 的错误条件。

如果实现支持 IEEE 浮点算术（IEC 60559），那么

• 在参数是 ±0 时返回 +0
• 在参数是 ±∞ 时返回 +∞
• 在参数是 NaN 时返回 NaN

注解

额外重载不需要以 (A) 的形式提供。它们只需要能够对它们的整数类型实参 num 确保 std::fabs(num) 和 std::fabs(static_cast<double>(num)) 的效果相同。

示例

#include <cmath>
#include <iostream>

int main()
{
    std::cout << "abs(+3.0) = " << std::abs(+3.0) << '\n'
              << "abs(-3.0) = " << std::abs(-3.0) << '\n';
    
    // 特殊值
    std::cout << "abs(-0.0) = " << std::abs(-0.0) << '\n'
              << "abs(-Inf) = " << std::abs(-INFINITY) << '\n'
              << "abs(-NaN) = " << std::abs(-NAN) << '\n';
}

abs(+3.0) = 3
abs(-3.0) = 3
abs(-0.0) = 0
abs(-Inf) = inf
abs(-NaN) = nan

缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

参阅