函式
<cmath> <ctgmath>

rint

     double rint  (double x);      float rintf (float x);long double rintl (long double x);
     double rint (double x);      float rint (float x);long double rint (long double x);     double rint (T x);           // additional overloads for integral types
舍入到整數值
使用 fegetround 指定的舍入方向,將 x 舍入為一個整數值。

如果返回的值與 x 的值不同,此函式可能會引發一個 FE_INEXACT 異常。有關不會引發此類異常的等效函式,請參見 nearbyint

標頭檔案 <tgmath.h> 提供了此函式的型別通用宏版本。
此標頭檔案 (<cmath>) 中為整數型別提供了額外的過載:這些過載在計算前有效地將 x 轉換為一個 double(為任意整數型別T 定義)。

引數

x
要取整的值。

返回值

x 的值被舍入到附近的整數(作為一個浮點值)。
如果該值與 x 不同,可能會引發一個 FE_INEXACT 異常(取決於實現)。

示例

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

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 ( "rint (2.3) = %.1f\n", rint(2.3) );
  printf ( "rint (3.8) = %.1f\n", rint(3.8) );
  printf ( "rint (-2.3) = %.1f\n", rint(-2.3) );
  printf ( "rint (-3.8) = %.1f\n", rint(-3.8) );
  return 0;
}

可能的輸出

Rounding using to-nearest rounding:
rint (2.3) = 2.0
rint (3.8) = 4.0
rint (-2.3) = -2.0
rint (-3.8) = -4.0


另見