Floor

定义于头文件 <cmath> 中。

描述

计算不大于 num 的最大整数值。
该库为所有 cv-不限定的浮点类型提供了 std::floor 的重载，作为参数 num 的类型。 (自 C++23 起).
附加重载为所有整数类型提供，它们被视为 double (自 C++11 起).

声明

C++23

// 1)
constexpr /* floating-point-type */ floor( /* floating-point-type */ num );
// 2)
constexpr float floorf( float num );
// 3)
constexpr long double floorl( long double num );

附加重载

// 4)
template< class Integer >
constexpr double floor ( Integer num );

C++11

// 1)
float floor ( float num );
// 2)
double floor ( double num );
//3)
long double floor ( long double num );
// 4)
float erfcf( float num );
// 5)
long double erfcl( long double num );

附加重载

// 6)
template< class Integer >
double floor ( Integer num );

参数

​num - 浮点或整数值

返回值

如果没有错误发生，则返回不大于 num 的最大整数值，即 ⌊num⌋。

错误处理

错误按 math_errhandling 中指定的方式报告。

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

当前的舍入模式无效。

• 如果 num 是 ±∞，则原样返回
• 如果 num 是 ±0，则原样返回
• 如果 num 是 NaN，则返回 NaN

备注

当对非整数有限值进行舍入时，可能会（但不是必须）引发 FE_INEXACT。

在所有标准浮点格式中，最大的可表示浮点值都是精确整数，因此此函数本身永远不会溢出；但是，当存储在整数变量中时，结果可能会溢出任何整数类型（包括 std::intmax_t）。

额外的重载不需要完全按照额外重载提供。它们只需要足以确保对于其整数类型的参数 num，
std::floor(num) 的效果与 std::floor(static_cast<double>(num)) 相同

示例

#include <cmath>
#include <iostream>
 
int main()
{
    std::cout 
        << std::fixed
        << "floor(+2.7) = " 
        << std::floor(+2.7) << '\n'
        << "floor(-2.7) = " 
        << std::floor(-2.7) << '\n'
        << "floor(-0.0) = " 
        << std::floor(-0.0) << '\n'
        << "floor(-Inf) = " 
        << std::floor(-INFINITY) << '\n';
}

结果

floor(+2.7) = 2.000000
floor(-2.7) = -3.000000
floor(-0.0) = -0.000000
floor(-Inf) = -inf