trunc, truncf, truncl

判斷小於或等於指定浮點值且最接近的整數。

語法

double trunc( double x );
long double truncl( long double x );
#define trunc(X) // Requires C11 or higher

long double trunc( long double x ); //C++ only
float trunc( float x ); //C++ only

參數

x
要截斷的值。

傳回值

如果成功，函式會傳回 的 x 整數值，四捨五入為零。

否則，函式可能會傳回下列其中一個值：

問題	傳回
x = ±INFINITY	x
x = ±0	x
x = NaN	NaN

錯誤會回報為 中指定的 _matherr 。

備註

因為 C++ 允許多載，所以您可以呼叫採用並傳回 trunc 和 float 類型的 long double 的多載。 在 C 程式中，除非您使用 < tgmath.h > 宏來呼叫此函式， trunc 否則一律會採用 並傳 double 回 。

如果您使用 < tgmath.h >trunc() 宏，引數的類型會決定選取哪一個函式版本。 如需詳細資訊，請參閱 類型泛型數學 。

因為最大的浮點值是確切的整數，因此此函式不會自行溢位。 不過，您可能會因為將值傳回到整數類型而造成函式溢位。

您也可以透過隱含地從浮點數轉換為整數進行無條件捨去。不過，這麼做受限於可以用目標類型儲存的值。

需求

函式	C 標頭	C++ 標頭
trunc, truncf, truncl	<math.h>	<cmath>
trunc 宏觀	<tgmath.h>

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

另請參閱

字母函數參考
floor, floorf, floorl
ceil, ceilf, ceill
round, roundf, roundl