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: 待定)

• 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