nearbyint、 、 nearbyintfnearbyintl
將指定的浮點值四捨五入成整數，並以浮點數格式傳回該值。
語法
double nearbyint( double x );
float nearbyintf( float x );
long double nearbyintl( long double x );
#define nearbyint( X ) // Requires C11 or higher
float nearbyint( float x ); //C++ only
long double nearbyint( long double x ); //C++ only
參數
x
要捨入的值。
傳回值
如果成功，則 x傳回 ，四捨五入為最接近的整數，並使用 所 fegetround回報的目前四捨五入格式。 否則，此函式可能會傳回下列其中一個值：
| 問題 | 傳回 |
|---|---|
x = ±INFINITY |
±INFINITY，未修改 |
x = ±0 |
±0，未修改 |
x = NaN |
NaN |
錯誤不會透過 _matherr回報，特別是此函式不會報告任何 FE_INEXACT 例外狀況。
備註
此函式和 的主要差異在於此函 rint 式不會引發不精確的浮點例外狀況。
因為最大浮點值是精確的整數，所以此函式自身永遠不會溢位；相反地，根據您使用的函式版本，輸出可能會造成傳回值溢位。
C++ 允許多載，因此您可以呼叫採用並傳回 float 或 long double 參數之 nearbyint 的多載。 在 C 程式中，除非您使用 <tgmath.h> 巨集來呼叫此函式， nearbyint 否則一律會採用兩個雙精度浮點數，並傳回雙精度浮點數。
如果您使用 <tgmath.h>nearbyint() 巨集，則引數的型別會決定選取哪一個函式版本。 如需詳細資料，請參閱型別泛型數學。
根據預設，此函式的全域狀態會限定於應用程式。 若要變更此行為，請參閱 CRT 中的全域狀態。
需求
| 函式 | C 標頭 | C++ 標頭 |
|---|---|---|
nearbyint、 、 nearbyintfnearbyintl |
<math.h> | <cmath> 或 <math.h> |
nearbyint 巨集 |
<tgmath.h> |
如需相容性詳細資訊，請參閱相容性。