std:: floor, std:: floorf, std:: floorl
|
定义于头文件
<cmath>
|
||
| (1) | ||
|
float
floor
(
float
num
)
;
double
floor
(
double
num
)
;
|
(C++23 前) | |
|
constexpr
/*floating-point-type*/
floor ( /*floating-point-type*/ num ) ; |
(C++23 起) | |
|
float
floorf
(
float
num
)
;
|
(2) |
(C++11 起)
(C++23 起为 constexpr) |
|
long
double
floorl
(
long
double
num
)
;
|
(3) |
(C++11 起)
(C++23 起为 constexpr) |
|
SIMD 重载
(C++26 起)
|
||
|
定义于头文件
<simd>
|
||
|
template
<
/*math-floating-point*/
V
>
constexpr
/*deduced-simd-t*/
<
V
>
|
(S) | (C++26 起) |
|
额外重载
(C++11 起)
|
||
|
定义于头文件
<cmath>
|
||
|
template
<
class
Integer
>
double floor ( Integer num ) ; |
(A) | (C++23 起为 constexpr) |
std::floor
的重载版本作为参数类型。
(since C++23)
|
S)
SIMD 重载对
v_num
执行逐元素的
std::floor
运算。
|
(since C++26) |
|
A)
为所有整数类型提供了额外的重载,这些类型被视为
double
。
|
(since C++11) |
目录 |
参数
| num | - | 浮点数或整数值 |
返回值
如果没有发生错误,则返回不大于 num 的最大整数值,即 ⌊num⌋ 。
错误处理
错误报告方式遵循 math_errhandling 中的规范。
如果实现支持 IEEE 浮点算术 (IEC 60559),
- 当前的 舍入模式 无效。
- 若 num 为 ±∞,则直接返回该值。
- 若 num 为 ±0,则直接返回该值。
- 若 num 为 NaN,则返回 NaN。
注释
FE_INEXACT 可能在舍入非整数有限值时被引发(但不是必须被引发)。
在所有标准浮点格式中,最大可表示的浮点值都是精确整数,因此该函数本身永远不会溢出;然而当结果存储在整数变量中时,可能会溢出任何整数类型(包括 std::intmax_t )。
额外的重载不需要完全按照 (A) 提供。它们只需确保对于整数类型的实参 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
参见
|
(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 文档
for
floor
|
|