rint, rintf, rintl, lrint, lrintf, lrintl, llrint, llrintf, llrintl
来自cppreference.com
| 定义于头文件 <math.h>
|
||
| float rintf( float arg ); |
(1) | (C99 起) |
| double rint( double arg ); |
(2) | (C99 起) |
| long double rintl( long double arg ); |
(3) | (C99 起) |
| 定义于头文件 <tgmath.h>
|
||
| #define rint( arg ) |
(4) | (C99 起) |
| 定义于头文件 <math.h>
|
||
| long lrintf( float arg ); |
(5) | (C99 起) |
| long lrint( double arg ); |
(6) | (C99 起) |
| long lrintl( long double arg ); |
(7) | (C99 起) |
| 定义于头文件 <tgmath.h>
|
||
| #define lrint( arg ) |
(8) | (C99 起) |
| 定义于头文件 <math.h>
|
||
| long long llrintf( float arg ); |
(9) | (C99 起) |
| long long llrint( double arg ); |
(10) | (C99 起) |
| long long llrintl( long double arg ); |
(11) | (C99 起) |
| 定义于头文件 <tgmath.h>
|
||
| #define llrint( arg ) |
(12) | (C99 起) |
1-3) 将浮点参数
arg以浮点格式取整到整数值，以当前舍入模式。5-7, 9-11) 将浮点参数
arg以整数格式取整到整数值，以当前舍入模式。4,8,12) 通用类型宏：若
arg类型为long double，则调用rintl、 lrintl、 llrintl。否则若arg类型为整数或double，则调用rint、 lrint、 llrint。否则各自调用rintf、 lrintf、 llrintf。目录 |
[编辑] 参数
| arg | - | 浮点值 |
[编辑] 返回值
若无错误发生，返回根据当前舍入模式的最近的整数值。
[编辑] 错误处理
错误会按照math_errhandling中所指定的汇报。
若lrint或llrint在返回类型的可表示范围之外，会出现定义域错误或值域错误。
若实现支持IEEE浮点算数（IEC 60559），则
- 对于
rint函数：
- 若
arg是±∞，则返回它，不修改 - 若
arg是±0，则返回它，不修改 - 若
arg是NaN，则返回NaN
- 对于
lrint和llrint函数：
- 若
arg是±∞，则引发FE_INVALID并返回实现定义的值 - 若取整结果在返回类型范围之外，则引发FE_INVALID并返回实现定义的值
- 若
arg是NaN，则引发FE_INVALID并返回实现定义的值
[编辑] 注意
POSIX限定所有lrint 或llrint引发FE_INEXACT的情况都是定义域错误。
如math_errhandling所指定，FE_INEXACT可以（但不对非IEEE浮点数平台强制要求）为rint在取整有限非整数值时引发。
rint和nearbyint仅有的区别是nearbyint始终不引发FE_INEXACT。
最大可表示浮点值对于所有平台的浮点格式都是准确的整数，故rint自身始终不会向上溢出；然而结果可能对任何整数类型溢出（含intmax_t），在将值存储于整数变量时。
若当前舍入模式是……
- FE_DOWNWARD，则
rint等价于floor。 - FE_UPWARD，则
rint等价于ceil。 - FE_TOWARDZERO，则
rint等价于trunc。 - FE_TONEAREST，则
rint与round仅在两整数正中央时有别，后者取远离零的值。
[编辑] 示例
运行此代码
#include <stdio.h> #include <math.h> #include <fenv.h> #include <limits.h> int main(void) { #pragma STDC FENV_ACCESS ON fesetround(FE_TONEAREST); printf("rounding to nearest (halfway cases to even):\n" "rint(+2.3) = %+.1f ", rint(2.3)); printf("rint(+2.5) = %+.1f ", rint(2.5)); printf("rint(+3.5) = %+.1f\n", rint(3.5)); printf("rint(-2.3) = %+.1f ", rint(-2.3)); printf("rint(-2.5) = %+.1f ", rint(-2.5)); printf("rint(-3.5) = %+.1f\n", rint(-3.5)); fesetround(FE_DOWNWARD); printf("rounding down: \nrint(+2.3) = %+.1f ", rint(2.3)); printf("rint(+2.5) = %+.1f ", rint(2.5)); printf("rint(+3.5) = %+.1f\n", rint(3.5)); printf("rint(-2.3) = %+.1f ", rint(-2.3)); printf("rint(-2.5) = %+.1f ", rint(-2.5)); printf("rint(-3.5) = %+.1f\n", rint(-3.5)); printf("rounding down with lrint: \nlrint(+2.3) = %ld ", lrint(2.3)); printf("lrint(+2.5) = %ld ", lrint(2.5)); printf("lrint(+3.5) = %ld\n", lrint(3.5)); printf("lrint(-2.3) = %ld ", lrint(-2.3)); printf("lrint(-2.5) = %ld ", lrint(-2.5)); printf("lrint(-3.5) = %ld\n", lrint(-3.5)); printf("lrint(-0.0) = %ld\n", lrint(-0.0)); printf("lrint(-Inf) = %ld\n", lrint(-INFINITY)); // FE_INVALID引发 // 错误处理 feclearexcept(FE_ALL_EXCEPT); printf("rint(1.1) = %.1f\n", rint(1.1)); if(fetestexcept(FE_INEXACT)) puts(" FE_INEXACT was raised"); feclearexcept(FE_ALL_EXCEPT); printf("lrint(LONG_MIN-2048.0) = %ld\n", lrint(LONG_MIN-2048.0)); if(fetestexcept(FE_INVALID)) puts(" FE_INVALID was raised"); }
可能的输出：
rounding to nearest (halfway cases to even):
rint(+2.3) = +2.0 rint(+2.5) = +2.0 rint(+3.5) = +4.0
rint(-2.3) = -2.0 rint(-2.5) = -2.0 rint(-3.5) = -4.0
rounding down:
rint(+2.3) = +2.0 rint(+2.5) = +2.0 rint(+3.5) = +3.0
rint(-2.3) = -3.0 rint(-2.5) = -3.0 rint(-3.5) = -4.0
rounding down with lrint:
lrint(+2.3) = 2 lrint(+2.5) = 2 lrint(+3.5) = 3
lrint(-2.3) = -3 lrint(-2.5) = -3 lrint(-3.5) = -4
lrint(-0.0) = 0
lrint(-Inf) = -9223372036854775808
rint(1.1) = 1.0
FE_INEXACT was raised
lrint(LONG_MIN-2048.0) = -9223372036854775808
FE_INVALID was raised[编辑] 参考
- C11 standard (ISO/IEC 9899:2011):
- 7.12.9.4 The rint functions (p: 252)
- 7.12.9.5 The lrint and llrint functions (p: 252)
- 7.25 Type-generic math <tgmath.h> (p: 373-375)
- F.10.6.4 The rint functions (p: 527)
- F.10.6.5 The lrint and llrint functions (p: 527)
- C99 standard (ISO/IEC 9899:1999):
- 7.12.9.4 The rint functions (p: 232-233)
- 7.12.9.5 The lrint and llrint functions (p: 233)
- 7.22 Type-generic math <tgmath.h> (p: 335-337)
- F.9.6.4 The rint functions (p: 463)
- F.9.6.5 The lrint and llrint functions (p: 463)
[编辑] 参阅
| (C99) (C99) (C99) |
取整到绝对值不大于给定值的最接近整数 (函数) |
| (C99) (C99) (C99) |
用当前舍入模式取整到整数 (函数) |
| (C99) (C99) |
获得或设置舍入方向 (函数) |
| rint的 C++ 文档
|
