函式
<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


另見