std::nearbyint, std::nearbyintf, std::nearbyintl
来自 cppreference.cn
| 定义于头文件 <cmath> |
||
| (1) | ||
float nearbyint ( float num ); double nearbyint ( double num ); |
(直至 C++23) | |
| /*floating-point-type*/ nearbyint ( /*floating-point-type*/ num ); |
(C++23 起) | |
float nearbyintf( float num ); |
(2) | (C++11 起) |
long double nearbyintl( long double num ); |
(3) | (C++11 起) |
| SIMD 重载 (C++26 起) |
||
| 定义于头文件 <simd> |
||
| template< /*数学浮点类型*/ V > constexpr /*推导 SIMD 类型*/<V> |
(S) | (C++26 起) |
| 额外重载 (自 C++11 起) |
||
| 定义于头文件 <cmath> |
||
template< class Integer > double nearbyint ( Integer num ); |
(A) | |
1-3) 使用 当前舍入模式，将浮点参数 num 舍入为浮点格式的整数值。 库为所有 cv-unqualified 浮点类型提供了
std::nearbyint 的重载作为参数类型。(C++23 起)|
S) SIMD 重载对 v_num 执行逐元素
std::nearbyint。
|
(C++26 起) |
|
A) 为所有整数类型提供了额外的重载，它们被视为 double。
|
(C++11 起) |
目录 |
[编辑] 参数
| num | - | 浮点值或整数值 |
[编辑] 返回值
返回根据当前舍入模式，最接近 num 的整数值。
[编辑] 错误处理
此函数不受 math_errhandling 中指定的任何错误的影响。
如果实现支持 IEEE 浮点运算 (IEC 60559)，
- 永不引发 FE_INEXACT。
- 若 num 为 ±∞，则返回它，不修改。
- 若 num 为 ±0，则返回它，不修改。
- 若 num 为 NaN，则返回 NaN。
[编辑] 注意
std::nearbyint 与 std::rint 之间的唯一区别是 std::nearbyint 永远不会引发 FE_INEXACT。
所有标准浮点格式中可表示的最大浮点值都是精确整数，因此 std::nearbyint 本身永远不会溢出；但是，当存储在整数变量中时，结果可能会溢出任何整数类型（包括 std::intmax_t）。
如果当前舍入模式为 FE_TONEAREST，则此函数在半值情况下舍入到偶数（与 std::rint 相同，但与 std::round 不同）。
不要求完全按照 (A) 提供额外的重载。它们只需要足以确保对于整数类型的参数 num，std::nearbyint(num) 具有与 std::nearbyint(static_cast<double>(num)) 相同的效果。
[编辑] 示例
运行此代码
#include <cfenv> #include <cmath> #include <iostream> #pragma STDC FENV_ACCESS ON int main() { std::fesetround(FE_TONEAREST); std::cout << "rounding to nearest: \n" << "nearbyint(+2.3) = " << std::nearbyint(2.3) << " nearbyint(+2.5) = " << std::nearbyint(2.5) << " nearbyint(+3.5) = " << std::nearbyint(3.5) << '\n' << "nearbyint(-2.3) = " << std::nearbyint(-2.3) << " nearbyint(-2.5) = " << std::nearbyint(-2.5) << " nearbyint(-3.5) = " << std::nearbyint(-3.5) << '\n'; std::fesetround(FE_DOWNWARD); std::cout << "rounding down:\n" << "nearbyint(+2.3) = " << std::nearbyint(2.3) << " nearbyint(+2.5) = " << std::nearbyint(2.5) << " nearbyint(+3.5) = " << std::nearbyint(3.5) << '\n' << "nearbyint(-2.3) = " << std::nearbyint(-2.3) << " nearbyint(-2.5) = " << std::nearbyint(-2.5) << " nearbyint(-3.5) = " << std::nearbyint(-3.5) << '\n'; std::cout << "nearbyint(-0.0) = " << std::nearbyint(-0.0) << '\n' << "nearbyint(-Inf) = " << std::nearbyint(-INFINITY) << '\n'; }
输出
rounding to nearest: nearbyint(+2.3) = 2 nearbyint(+2.5) = 2 nearbyint(+3.5) = 4 nearbyint(-2.3) = -2 nearbyint(-2.5) = -2 nearbyint(-3.5) = -4 rounding down: nearbyint(+2.3) = 2 nearbyint(+2.5) = 2 nearbyint(+3.5) = 3 nearbyint(-2.3) = -3 nearbyint(-2.5) = -3 nearbyint(-3.5) = -4 nearbyint(-0.0) = -0 nearbyint(-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++11)(C++11)(C++11)(C++11) |
最接近整数，在半数情况下远离零舍入 (函数) |
| (C++11)(C++11) |
获取或设置舍入方向 (函数) |
| C 文档 为 nearbyint
| |
