nearbyint, nearbyintf, nearbyintl
来自 cppreference.cn
定义于头文件 <math.h> |
||
float nearbyintf( float arg ); |
(1) | (C99 起) |
double nearbyint( double arg ); |
(2) | (C99 起) |
long double nearbyintl( long double arg ); |
(3) | (C99 起) |
定义于头文件 <tgmath.h> |
||
#define nearbyint( arg ) |
(4) | (C99 起) |
4) 类型泛型宏:如果 arg 的类型为 long double,则调用
nearbyintl
。否则,如果 arg 具有整数类型或类型 double,则调用 nearbyint
。否则,调用 nearbyintf
。目录 |
[编辑] 参数
arg | - | 浮点值 |
[编辑] 返回值
返回 arg 最接近的整数值,根据 当前舍入模式。
[编辑] 错误处理
此函数不受 math_errhandling
中指定的任何错误影响。
如果实现支持 IEEE 浮点运算 (IEC 60559),
- FE_INEXACT 从不引发。
- 如果 arg 是 ±∞,则返回它,不作修改。
- 如果 arg 是 ±0,则返回它,不作修改。
- 如果 arg 是 NaN,则返回 NaN。
[编辑] 注意
nearbyint
和 rint 之间唯一的区别是 nearbyint
永不引发 FE_INEXACT。
在所有标准浮点格式中,最大可表示浮点值都是精确整数,因此 nearbyint
本身不会溢出;但是,当存储在整数变量中时,结果可能会溢出任何整数类型(包括 intmax_t)。
如果当前舍入模式是 FE_TONEAREST,则此函数在半途情况(例如 rint,但不同于 round)下向偶数舍入。
[编辑] 示例
运行此代码
#include <fenv.h> #include <math.h> #include <stdio.h> int main(void) { // #pragma STDC FENV_ACCESS ON fesetround(FE_TONEAREST); printf("rounding to nearest:\nnearbyint(+2.3) = %+.1f ", nearbyint(2.3)); printf("nearbyint(+2.5) = %+.1f ", nearbyint(2.5)); printf("nearbyint(+3.5) = %+.1f\n", nearbyint(3.5)); printf("nearbyint(-2.3) = %+.1f ", nearbyint(-2.3)); printf("nearbyint(-2.5) = %+.1f ", nearbyint(-2.5)); printf("nearbyint(-3.5) = %+.1f\n", nearbyint(-3.5)); fesetround(FE_DOWNWARD); printf("rounding down: \nnearbyint(+2.3) = %+.1f ", nearbyint(2.3)); printf("nearbyint(+2.5) = %+.1f ", nearbyint(2.5)); printf("nearbyint(+3.5) = %+.1f\n", nearbyint(3.5)); printf("nearbyint(-2.3) = %+.1f ", nearbyint(-2.3)); printf("nearbyint(-2.5) = %+.1f ", nearbyint(-2.5)); printf("nearbyint(-3.5) = %+.1f\n", nearbyint(-3.5)); printf("nearbyint(-0.0) = %+.1f\n", nearbyint(-0.0)); printf("nearbyint(-Inf) = %+.1f\n", nearbyint(-INFINITY)); }
输出
rounding to nearest: nearbyint(+2.3) = +2.0 nearbyint(+2.5) = +2.0 nearbyint(+3.5) = +4.0 nearbyint(-2.3) = -2.0 nearbyint(-2.5) = -2.0 nearbyint(-3.5) = -4.0 rounding down: nearbyint(+2.3) = +2.0 nearbyint(+2.5) = +2.0 nearbyint(+3.5) = +3.0 nearbyint(-2.3) = -3.0 nearbyint(-2.5) = -3.0 nearbyint(-3.5) = -4.0 nearbyint(-0.0) = -0.0 nearbyint(-Inf) = -inf
[编辑] 参考
- C23 标准 (ISO/IEC 9899:2024)
- 7.12.9.3 nearbyint 函数 (p: TBD)
- 7.25 类型通用数学 <tgmath.h> (p: TBD)
- F.10.6.3 nearbyint 函数 (p: TBD)
- C17 标准 (ISO/IEC 9899:2018)
- 7.12.9.3 nearbyint 函数 (p: TBD)
- 7.25 类型通用数学 <tgmath.h> (p: TBD)
- F.10.6.3 nearbyint 函数 (p: TBD)
- C11 标准 (ISO/IEC 9899:2011)
- 7.12.9.3 nearbyint 函数 (p: 251-252)
- 7.25 类型通用数学 <tgmath.h> (p: 373-375)
- F.10.6.3 nearbyint 函数 (p: 526)
- C99 标准 (ISO/IEC 9899:1999)
- 7.12.9.3 nearbyint 函数 (p: 232)
- 7.22 类型通用数学 <tgmath.h> (p: 335-337)
- F.9.6.3 nearbyint 函数 (p: 463)
[编辑] 另请参阅
(C99)(C99)(C99)(C99)(C99)(C99)(C99)(C99)(C99) |
使用当前舍入模式四舍五入到整数 如果结果不同则抛出异常 (函数) |
(C99)(C99)(C99)(C99)(C99)(C99)(C99)(C99)(C99) |
四舍五入到最接近的整数,在半数情况下远离零 (函数) |
(C99)(C99) |
获取或设置舍入方向 (函数) |
C++ 文档 for nearbyint
|