C++

参考

<cmath> (math.h)

函数
<cmath> <ctgmath>

lrint

long int lrint  (double x);long int lrintf (float x);long int lrintl (long double x);
long int lrint (double x);long int lrint (float x);long int lrint (long double x);long int lrint (T x);           // additional overloads for integral types
舍入并转型为长整型
使用 fegetround 指定的舍入方向将 x 舍入为一个整数值，并将其作为 long int 类型的值返回。

请参阅 llrint 以了解返回 long long int 的等效函数。

头文件 <tgmath.h> 提供了此函数的类型通用宏版本。
此头文件 (<cmath>) 中为整型提供了额外的重载：这些重载在计算前有效地将 x 转型为 double（为任意整型的 T 定义）。

参数

x
要取整的值。

返回值

x 的值舍入到临近的整数，并转型为 long int 类型的值。
如果取整后的值超出了返回类型的范围，则返回的值是未指定的，并且可能会发生定义域错误或上溢范围错误（或者，根据具体实现，也可能什么都不发生）。

如果发生定义域错误
- 并且 math_errhandling 设置了 MATH_ERRNO：全局变量 errno 会被设置为 EDOM。
- 并且 math_errhandling 设置了 MATH_ERREXCEPT：将引发 FE_INVALID。

如果发生上溢范围错误
- 并且 math_errhandling 设置了 MATH_ERRNO：全局变量 errno 被设置为 ERANGE。
- 并且 math_errhandling 设置了 MATH_ERREXCEPT：将引发 FE_OVERFLOW。

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
 
/* lrint example */
#include <stdio.h>      /* printf */
#include <fenv.h>       /* fegetround, FE_* */
#include <math.h>       /* lrint */

int main ()
{
  printf ("rounding using ");
  switch (fegetround()) {
    case FE_DOWNWARD: printf ("downward"); break;
    case FE_TONEAREST: printf ("to-nearest"); break;
    case FE_TOWARDZERO: printf ("toward-zero"); break;
    case FE_UPWARD: printf ("upward"); break;
    default: printf ("unknown");
  }
  printf (" rounding:\n");

  printf ( "lrint (2.3) = %ld\n", lrint(2.3) );
  printf ( "lrint (3.8) = %ld\n", lrint(3.8) );
  printf ( "lrint (-2.3) = %ld\n", lrint(-2.3) );
  printf ( "lrint (-3.8) = %ld\n", lrint(-3.8) );
  return 0;
}

可能的输出

Rounding using to-nearest rounding:
lrint (2.3) = 2
lrint (3.8) = 4
lrint (-2.3) = -2
lrint (-3.8) = -4


另见

nearbyint
舍入到附近的整数值 (函数)
rint
舍入到整数值 (函数)
llrint
舍入并转换为 long long integer (函数)
round
四舍五入到最接近的值 (函数)
floor
向下舍入值 (函数)
ceil
向上舍入值 (函数)
trunc
截断值 (函数)