rint, rintf, rintl, lrint, lrintf, lrintl, llrint, llrintf, llrintl

 

C

编译器支持

语言

头文件

类型支持

程序工具

变参函数支持

错误处理

动态内存管理

字符串库

算法

数值

日期和时间工具

输入/输出支持

本地化支持

并发支持 (C11)

技术规范

符号索引

 

数值

常用数学函数

浮点环境 (C99)

伪随机数生成

复数运算 (C99)

类型通用数学 (C99)

位操作 (C23)

检查整数运算 (C23)

 

常用数学函数

函数 基本操作 abslabsllabsimaxabs (C99)(C99) fabs divldivlldivimaxdiv (C99)(C99) fmod remainder (C99) remquo (C99) fma (C99) fdim (C99) nannanfnanlnandN (C99)(C99)(C99)(C23) 最大值/最小值操作 fmax (C99) fmin (C99) fmaximum (C23) fminimum (C23) fmaximum_mag (C23)  fmaximum_num (C23) fminimum_mag (C23) fminimum_num (C23) fmaximum_mag_num (C23) fminimum_mag_num (C23)   指数函数 exp exp10 (C23) exp2 (C99) expm1 (C99) exp10m1 (C23) exp2m1 (C23) log log10 log2 (C99) log1plogp1 (C99)(C23) log10p1 (C23) log2p1 (C23) 幂函数 sqrt cbrt (C99) rootn (C23) rsqrt (C23) hypot (C99) compound (C23) pow pown (C23) powr (C23) 三角函数和双曲函数 sin cos tan asin acos atan atan2 sinpi (C23) cospi (C23) tanpi (C23) asinpi (C23) acospi (C23) atanpi (C23) atan2pi (C23) sinh cosh tanh asinh (C99) acosh (C99) atanh (C99)

最近整数浮点数 ceil floor roundlroundllround (C99)(C99)(C99) roundeven (C23) trunc (C99) nearbyint (C99) rintlrintllrint (C99)(C99)(C99) fromfpfromfpxufromfpufromfpx (C23)(C23)(C23)(C23) 浮点数操作 ldexp frexp scalbnscalbln (C99)(C99) ilogbllogb (C99)(C23) logb (C99) modf nextafternexttoward (C99)(C99) nextupnextdown (C23)(C23) copysign (C99) canonicalize (C23) 窄化操作 fadd (C23) fsub (C23) fmul (C23) fdiv (C23) ffma (C23) fsqrt (C23) 量子与量子指数 quantizedN (C23) quantumdN (C23) samequantumdN (C23) llquantexpdN (C23) 十进制重新编码函数 encodedecdN (C23) decodedecdN (C23) encodebindN (C23) decodebindN (C23) 总序和载荷函数 totalorder (C23) getpayload (C23) setpayload (C23) setpayloadsig (C23) 分类 fpclassify (C99) iscanonical (C23)  isfinite (C99) isinf (C99) isnan (C99) isnormal (C99) signbit (C99) issubnormal (C23) iszero (C23) isgreater (C99) isgreaterequal (C99)   isless (C99) islessequal (C99) islessgreater (C99) isunordered (C99) issignaling (C23) iseqsig (C23)

误差函数和伽马函数 erf (C99) erfc (C99) lgamma (C99) tgamma (C99) 类型 div_tldiv_tlldiv_timaxdiv_t (C99)(C99) float_tdouble_t (C99)(C99) _Decimal32_t_Decimal64_t (C23)(C23) 宏常量 特殊浮点值 HUGE_VALHUGE_VALFHUGE_VALLHUGE_VALDN (C99)(C99)(C23) INFINITYDEC_INFINITY (C99)(C23) NANDEC_NAN (C99)(C23) 参数和返回值 FP_ILOGB0FP_ILOGBNAN (C99)(C99) FP_NORMALFP_SUBNORMALFP_ZEROFP_INFINITEFP_NAN (C99)(C99)(C99)(C99)(C99) FP_LLOGB0FP_LLOGBNAN (C23)(C23) FP_INT_UPWARDFP_INT_DOWNWARDFP_INT_TOWARDZEROFP_INT_TONEARESTFROMZEROFP_INT_TONEAREST (C23)(C23)(C23)(C23)(C23) 错误处理 MATH_ERRNOMATH_ERRNOEXCEPT (C99)(C99)  math_errhandling (C99) 快速操作指示符 FP_FAST_FMAFFP_FAST_FMA (C99)(C99) FP_FAST_FADDFP_FAST_FADDLFP_FAST_DADDLFP_FAST_DMADDDN (C23)(C23)(C23)(C23) FP_FAST_FMULFP_FAST_FMULLFP_FAST_DMULLFP_FAST_DMMULDN (C23)(C23)(C23)(C23) FP_FAST_FFMAFP_FAST_FFMALFP_FAST_DFMALFP_FAST_DMFMADN (C23)(C23)(C23)(C23) FP_FAST_FMALFP_FAST_FMADN (C99)(C23) FP_FAST_FSUBFP_FAST_FSUBLFP_FAST_DSUBLFP_FAST_DMSUBDN (C23)(C23)(C23)(C23) FP_FAST_FDIVFP_FAST_FDIVLFP_FAST_DDIVLFP_FAST_DMDIVDN (C23)(C23)(C23)(C23) FP_FAST_FSQRTFP_FAST_FSQRTLFP_FAST_DSQRTLFP_FAST_DMSQRTDN (C23)(C23)(C23)(C23)

 

定义于头文件 <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

-

浮点值

返回值

如果没有发生错误，则返回 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 中所述，当 rint 舍入非整数有限值时，可能会（但不要求在非 IEEE 浮点平台上）触发 FE_INEXACT。

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 <fenv.h>
#include <limits.h>
#include <math.h>
#include <stdio.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 raised
 
    // error handling
    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

参考

• C23 标准 (ISO/IEC 9899:2024)

• 7.12.9.4 rint 函数 (p: 待定)

• 7.12.9.5 lrint 和 llrint 函数 (p: 待定)

• 7.25 类型通用数学 <tgmath.h> (p: TBD)

• F.10.6.4 rint 函数 (p: 待定)

• F.10.6.5 lrint 和 llrint 函数 (p: 待定)

• C17 标准 (ISO/IEC 9899:2018)

• 7.12.9.4 rint 函数 (p: 184)

• 7.12.9.5 lrint 和 llrint 函数 (p: 184)

• 7.25 类型通用数学 <tgmath.h> (p: 272-273)

• F.10.6.4 rint 函数 (p: 384)

• F.10.6.5 lrint 和 llrint 函数 (p: 384)

• C11 标准 (ISO/IEC 9899:2011)

• 7.12.9.4 rint 函数 (p: 252)

• 7.12.9.5 lrint 和 llrint 函数 (p: 252)

• 7.25 类型通用数学 <tgmath.h> (p: 373-375)

• F.10.6.4 rint 函数 (p: 527)

• F.10.6.5 lrint 和 llrint 函数 (p: 527)

• C99 标准 (ISO/IEC 9899:1999)

• 7.12.9.4 rint 函数 (p: 232-233)

• 7.12.9.5 lrint 和 llrint 函数 (p: 233)

• 7.22 类型通用数学 <tgmath.h> (p: 335-337)

• F.9.6.4 rint 函数 (p: 463)

• F.9.6.5 lrint 和 llrint 函数 (p: 463)

另请参阅

trunctruncftruncl (C99)(C99)(C99)	将数字截断到最接近的整数，其绝对值不大于给定值 (函数)
nearbyintnearbyintfnearbyintl (C99)(C99)(C99)	使用当前舍入模式四舍五入到整数 (函数)
fegetroundfesetround (C99)(C99)	获取或设置舍入方向 (函数)
C++ 文档 关于 rint