trunc, truncf, truncl

 

C

编译器支持

语言

头文件

类型支持

程序工具

变参函数支持

错误处理

动态内存管理

字符串库

算法

数值

日期和时间工具

输入/输出支持

本地化支持

并发支持 (C11)

技术规范

符号索引

 

数值

常用数学函数

浮点环境 (C99)

伪随机数生成

复数运算 (C99)

类型通用数学 (C99)

位操作 (C23)

检查整数运算 (C23)

 

常用数学函数

函数 基本操作 abslabsllabsimaxabs (C99)(C99) fabs divldivlldivimaxdiv (C99)(C99) fmod remainder (C99) remquo (C99) fma (C99) fdim (C99) nannanfnanlnandN (C99)(C99)(C99)(C23) 最大值/最小值操作 fmax (C99) fmin (C99) fmaximum (C23) fminimum (C23) fmaximum_mag (C23)  fmaximum_num (C23) fminimum_mag (C23) fminimum_num (C23) fmaximum_mag_num (C23) fminimum_mag_num (C23)   指数函数 exp exp10 (C23) exp2 (C99) expm1 (C99) exp10m1 (C23) exp2m1 (C23) log log10 log2 (C99) log1plogp1 (C99)(C23) log10p1 (C23) log2p1 (C23) 幂函数 sqrt cbrt (C99) rootn (C23) rsqrt (C23) hypot (C99) compound (C23) pow pown (C23) powr (C23) 三角函数和双曲函数 sin cos tan asin acos atan atan2 sinpi (C23) cospi (C23) tanpi (C23) asinpi (C23) acospi (C23) atanpi (C23) atan2pi (C23) sinh cosh tanh asinh (C99) acosh (C99) atanh (C99)

最近整数浮点数 ceil floor roundlroundllround (C99)(C99)(C99) roundeven (C23) trunc (C99) nearbyint (C99) rintlrintllrint (C99)(C99)(C99) fromfpfromfpxufromfpufromfpx (C23)(C23)(C23)(C23) 浮点数操作 ldexp frexp scalbnscalbln (C99)(C99) ilogbllogb (C99)(C23) logb (C99) modf nextafternexttoward (C99)(C99) nextupnextdown (C23)(C23) copysign (C99) canonicalize (C23) 窄化操作 fadd (C23) fsub (C23) fmul (C23) fdiv (C23) ffma (C23) fsqrt (C23) 量子与量子指数 quantizedN (C23) quantumdN (C23) samequantumdN (C23) llquantexpdN (C23) 十进制重新编码函数 encodedecdN (C23) decodedecdN (C23) encodebindN (C23) decodebindN (C23) 总序和载荷函数 totalorder (C23) getpayload (C23) setpayload (C23) setpayloadsig (C23) 分类 fpclassify (C99) iscanonical (C23)  isfinite (C99) isinf (C99) isnan (C99) isnormal (C99) signbit (C99) issubnormal (C23) iszero (C23) isgreater (C99) isgreaterequal (C99)   isless (C99) islessequal (C99) islessgreater (C99) isunordered (C99) issignaling (C23) iseqsig (C23)

误差函数和伽马函数 erf (C99) erfc (C99) lgamma (C99) tgamma (C99) 类型 div_tldiv_tlldiv_timaxdiv_t (C99)(C99) float_tdouble_t (C99)(C99) _Decimal32_t_Decimal64_t (C23)(C23) 宏常量 特殊浮点值 HUGE_VALHUGE_VALFHUGE_VALLHUGE_VALDN (C99)(C99)(C23) INFINITYDEC_INFINITY (C99)(C23) NANDEC_NAN (C99)(C23) 参数和返回值 FP_ILOGB0FP_ILOGBNAN (C99)(C99) FP_NORMALFP_SUBNORMALFP_ZEROFP_INFINITEFP_NAN (C99)(C99)(C99)(C99)(C99) FP_LLOGB0FP_LLOGBNAN (C23)(C23) FP_INT_UPWARDFP_INT_DOWNWARDFP_INT_TOWARDZEROFP_INT_TONEARESTFROMZEROFP_INT_TONEAREST (C23)(C23)(C23)(C23)(C23) 错误处理 MATH_ERRNOMATH_ERRNOEXCEPT (C99)(C99)  math_errhandling (C99) 快速操作指示符 FP_FAST_FMAFFP_FAST_FMA (C99)(C99) FP_FAST_FADDFP_FAST_FADDLFP_FAST_DADDLFP_FAST_DMADDDN (C23)(C23)(C23)(C23) FP_FAST_FMULFP_FAST_FMULLFP_FAST_DMULLFP_FAST_DMMULDN (C23)(C23)(C23)(C23) FP_FAST_FFMAFP_FAST_FFMALFP_FAST_DFMALFP_FAST_DMFMADN (C23)(C23)(C23)(C23) FP_FAST_FMALFP_FAST_FMADN (C99)(C23) FP_FAST_FSUBFP_FAST_FSUBLFP_FAST_DSUBLFP_FAST_DMSUBDN (C23)(C23)(C23)(C23) FP_FAST_FDIVFP_FAST_FDIVLFP_FAST_DDIVLFP_FAST_DMDIVDN (C23)(C23)(C23)(C23) FP_FAST_FSQRTFP_FAST_FSQRTLFP_FAST_DSQRTLFP_FAST_DMSQRTDN (C23)(C23)(C23)(C23)

 

定义于头文件 <math.h>
float       truncf( float arg );	(1)	(C99 起)
double      trunc( double arg );	(2)	(C99 起)
long double truncl( long double arg );	(3)	(C99 起)
定义于头文件 <tgmath.h>
#define trunc( arg )	(4)	(C99 起)

1-3) 计算不比 arg 在量值上更大的最接近整数值。

4) 类型泛型宏：若 arg 的类型为 long double，则调用 truncl。否则，若 arg 的类型为整数类型或 double，则调用 trunc。否则，调用 truncf。

参数

arg

-

浮点值

返回值

若无错误发生，则返回不比 arg 在量值上更大的最接近整数值（换言之，即 arg 向零舍入）。

返回值

参数

错误处理

错误按 math_errhandling 中指定的方式报告。

如果实现支持 IEEE 浮点算术 (IEC 60559)

• 当前的舍入模式无效。
• 如果 arg 是 ±∞，则返回它，不作修改。
• 如果 arg 是 ±0，则返回它，不作修改。
• 如果 arg 是 NaN，则返回 NaN。

注意

当截断一个非整数的有限值时，可能（但不要求）引发 FE_INEXACT。

在所有标准的浮点格式中，最大的可表示浮点值都是精确的整数，因此该函数本身从不溢出；但是，当结果存储在整型变量中时，可能会溢出任何整型类型（包括 intmax_t）。

从浮点类型到整数类型的隐式转换也向零舍入，但仅限于目标类型可以表示的值。

示例

运行此代码

#include <math.h>
#include <stdio.h>
 
int main(void)
{
    printf("trunc(+2.7) = %+.1f\n", trunc(+2.7));
    printf("trunc(-2.7) = %+.1f\n", trunc(-2.7));
    printf("trunc(-0.0) = %+.1f\n", trunc(-0.0));
    printf("trunc(-Inf) = %+f\n",   trunc(-INFINITY));
}

可能的输出

trunc(+2.7) = +2.0
trunc(-2.7) = -2.0
trunc(-0.0) = -0.0
trunc(-Inf) = -inf

引用

• C23 标准 (ISO/IEC 9899:2024)

• 7.12.9.8 The trunc functions (p: TBD)

• 7.25 类型通用数学 <tgmath.h> (p: TBD)

• F.10.6.8 The trunc functions (p: TBD)

• C17 标准 (ISO/IEC 9899:2018)

• 7.12.9.8 The trunc functions (p: TBD)

• 7.25 类型通用数学 <tgmath.h> (p: TBD)

• F.10.6.8 The trunc functions (p: TBD)

• C11 标准 (ISO/IEC 9899:2011)

• 7.12.9.8 The trunc functions (p: 253-254)

• 7.25 类型通用数学 <tgmath.h> (p: 373-375)

• F.10.6.8 The trunc functions (p: 528)

• C99 标准 (ISO/IEC 9899:1999)

• 7.12.9.8 The trunc functions (p: 234)

• 7.22 类型通用数学 <tgmath.h> (p: 335-337)

• F.9.6.8 The trunc functions (p: 464)

参阅

floorfloorffloorl (C99)(C99)	计算不大于给定值的最大整数 (函数)
ceilceilfceill (C99)(C99)	计算不小于给定值的最小整数 (函数)
roundroundfroundllroundlroundflroundlllroundllroundfllroundl (C99)(C99)(C99)(C99)(C99)(C99)(C99)(C99)(C99)	四舍五入到最接近的整数，在半数情况下远离零 (函数)
C++ 文档中关于trunc的部分