std::rint, std::rintf, std::rintl, std::lrint, std::lrintf, std::lrintl, std::llrint, std::llrintf

来自cppreference.com
< cpp‎ | numeric‎ | math
 
C++
 
数值库
 
常用数学函数
浮点数的最接近整数
(C++11)(C++11)(C++11)
(C++11)
(C++11)
rintlrintllrint
(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++11)


 
在标头 <cmath> 定义
舍入到浮点数类型
(1)
float       rint (float num );

double      rint (double num );

longdouble rint (longdouble num );
(C++11 起)
(C++23 前)
/* floating-point-type */ rint(/* floating-point-type */ num );
(C++23 起)
float       rintf(float num );
 (2) (C++11 起)
longdouble rintl(longdouble num );
 (3) (C++11 起)
舍入到 long
(4)
long lrint (float num );

long lrint (double num );

long lrint (longdouble num );
(C++11 起)
(C++23 前)
long lrint (/* floating-point-type */ num );
(C++23 起)
long lrintf(float num );
 (5) (C++11 起)
long lrintl(longdouble num );
 (6) (C++11 起)
舍入到 longlong
(7)
longlong llrint (float num );

longlong llrint (double num );

longlong llrint (longdouble num );
(C++11 起)
(C++23 前)
longlong llrint (/* floating-point-type */ num );
(C++23 起)
longlong llrintf(float num );
 (8) (C++11 起)
longlong llrintl(longdouble num );
 (9) (C++11 起)
在标头 <cmath> 定义
template<class Integer >
double rint( Integer num );
 (A) (C++11 起)
template<class Integer >
long lrint( Integer num );
 (B) (C++11 起)
template<class Integer >
longlong llrint( Integer num );
 (C) (C++11 起)
1-3) 用当前舍入模式，舍入浮点数实参 num 为（浮点数格式的）整数。标准库提供所有以无 cv 限定的浮点数类型作为实参 num 的类型的 std::rint 重载。(C++23 起)
4-9) 用当前舍入模式，舍入浮点数实参 num 为整数。标准库提供所有以无 cv 限定的浮点数类型作为实参 num 的类型的 std::lrint 和 std::llrint 重载。(C++23 起)
A-C) 为所有整数类型提供额外重载，将它们当做 double。

目录

[编辑]参数

num - 浮点数或整数

[编辑]返回值

如果没有发生错误，那么返回 num 按照当前舍入模式的最接近整数。

[编辑]错误处理

报告 math_errhandling 中指定的错误。

如果 std::lrint 或 std::llrint 的结果在返回类型的可表示范围外，那么可能发生定义域错误或值域错误。

如果实现支持 IEEE 浮点数算术（IEC 60559），那么

对于 std::rint 函数：
  • 如果 num 是 ±∞，那么返回不修改的该值
  • 如果 num 是 ±0，那么返回不修改的该值
  • 如果 num 是 NaN，那么返回 NaN
对于 std::lrint 和 std::llrint 函数：
  • 如果 num 是 ±∞，那么引发 FE_INVALID 并返回实现定义值
  • 如果舍入结果在返回类型范围外，那么引发 FE_INVALID 并返回实现定义值
  • 如果 num 是 NaN，那么引发 FE_INVALID 并返回实现定义值

[编辑]注解

POSIX 指定std::lrint 或 std::llrint 引发 FE_INEXACT 的所有情况都是定义域错误。

如 math_errhandling 中指定，std::rint 在舍入非整数有限值时可以（但不在非 IEEE 浮点数平台上要求）引发 FE_INEXACT。

std::rint 和 std::nearbyint 间仅有的区别是 std::nearbyint 决不引发 FE_INEXACT。

所有标准浮点数格式的最大可表示浮点数值都是准确的整数，所以 std::rint 自身永远不会上溢；然而将结果存储到整数对象时，结果可能溢出任何整数类型（包含 std::intmax_t）。

如果当前舍入模式是：

额外重载不需要以 (A-C) 的形式提供。它们只需要能够对它们的整数类型实参 num 确保：

  • std::rint(num) 和 std::rint(static_cast<double>(num)) 的效果相同。
  • std::lrint(num) 和 std::lrint(static_cast<double>(num)) 的效果相同。
  • std::llrint(num) 和 std::llrint(static_cast<double>(num)) 的效果相同。

[编辑]示例

运行此代码
#include <cfenv>#include <climits>#include <cmath>#include <iostream>// #pragma STDC FENV_ACCESS ON   int main(){std::fesetround(FE_TONEAREST);std::cout<<"就近舍入（在中点舍入到偶数）：\n"<<" rint(+2.3) = "<< std::rint(2.3)<<'\n'<<" rint(+2.5) = "<< std::rint(2.5)<<'\n'<<" rint(+3.5) = "<< std::rint(3.5)<<'\n'<<" rint(-2.3) = "<< std::rint(-2.3)<<'\n'<<" rint(-2.5) = "<< std::rint(-2.5)<<'\n'<<" rint(-3.5) = "<< std::rint(-3.5)<<'\n';   std::fesetround(FE_DOWNWARD);std::cout<<"向下舍入：\n"<<" rint(+2.3) = "<< std::rint(2.3)<<'\n'<<" rint(+2.5) = "<< std::rint(2.5)<<'\n'<<" rint(+3.5) = "<< std::rint(3.5)<<'\n'<<" rint(-2.3) = "<< std::rint(-2.3)<<'\n'<<" rint(-2.5) = "<< std::rint(-2.5)<<'\n'<<" rint(-3.5) = "<< std::rint(-3.5)<<'\n'<<"使用 lrint 向下舍入：\n"<<" lrint(+2.3) = "<< std::lrint(2.3)<<'\n'<<" lrint(+2.5) = "<< std::lrint(2.5)<<'\n'<<" lrint(+3.5) = "<< std::lrint(3.5)<<'\n'<<" lrint(-2.3) = "<< std::lrint(-2.3)<<'\n'<<" lrint(-2.5) = "<< std::lrint(-2.5)<<'\n'<<" lrint(-3.5) = "<< std::lrint(-3.5)<<'\n'<<"特殊值：\n"<<" lrint(-0.0) = "<< std::lrint(-0.0)<<'\n'<<std::hex<<std::showbase<<" lrint(-Inf) = "<< std::lrint(-INFINITY)<<'\n';   // 错误处理std::feclearexcept(FE_ALL_EXCEPT);   std::cout<<"std::rint(0.1) = "<< std::rint(.1)<<'\n';if(std::fetestexcept(FE_INEXACT))std::cout<<" 发生 FE_INEXACT\n";   std::feclearexcept(FE_ALL_EXCEPT);   std::cout<<"std::lrint(LONG_MIN-2048.0) = "<< std::lrint(LONG_MIN-2048.0)<<'\n';if(std::fetestexcept(FE_INVALID))std::cout<<" 发生 FE_INVALID\n";}

可能的输出： 

就近舍入（在中点舍入到偶数）： rint(+2.3) = 2 rint(+2.5) = 2 rint(+3.5) = 4 rint(-2.3) = -2 rint(-2.5) = -2 rint(-3.5) = -4 向下舍入： rint(+2.3) = 2 rint(+2.5) = 2 rint(+3.5) = 4 rint(-2.3) = -2 rint(-2.5) = -2 rint(-3.5) = -4 使用 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) = 0x8000000000000000 std::rint(0.1) = 0 std::lrint(LONG_MIN-2048.0) = 0x8000000000000000 发生 FE_INVALID

[编辑]参阅

(C++11)(C++11)(C++11)
 绝对值不大于给定值的最接近整数
(函数)[编辑]
(C++11)(C++11)(C++11)
 使用当前舍入模式的最接近整数
(函数)[编辑]
(C++11)(C++11)
 获取或设置舍入方向
(函数)[编辑]
rint 的 C 文档
来自“https://zh.cppreference.com/mwiki/index.php?title=cpp/numeric/math/rint&oldid=95779”
close