nearbyint, nearbyintf, nearbyintl

將指定的浮點值四捨五入成整數，並以浮點數格式傳回該值。

語法

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, nearbyintf, nearbyintl	<math.h>	<cmath > 或 < math.h>
nearbyint 宏觀	<tgmath.h>

如需相容性詳細資訊，請參閱相容性。

另請參閱

字母函數參考
數學和浮點支援