trunc, truncf, truncl

 

C

语言

头文件

类型支持

程序工具

变参数函数支持

动态内存管理

错误处理

日期和时间工具

字符串库

算法

数值

输入/输出支持

本地化支持

线程支持 (C11)

原子操作 (C11)

技术规范

 

数值

常用数学函数

浮点环境

复数算术

伪随机数生成

泛型数学

 

常用数学函数

函数
基本运算
abslabsllabsimaxabs (C99) fabs divldivlldivimaxdiv (C99) fmod	remainder (C99) remquo (C99) fma (C99) fmax (C99) fmin (C99) fdim (C99) nannanfnanl (C99)(C99)(C99)
指数函数
exp exp2 (C99) expm1 (C99)	log log10 log1p (C99) log2 (C99)
幂函数
sqrt cbrt (C99)	hypot (C99) pow
三角及双曲函数
sin cos tan asin acos atan atan2	sinh cosh tanh asinh (C99) acosh (C99) atanh (C99)
误差及伽马函数
erf (C99) erfc (C99)	lgamma (C99) tgamma (C99)
临近整数的浮点运算
ceil floor roundlroundllround (C99)(C99)(C99)	trunc (C99) nearbyint (C99) rintlrintllrint (C99)(C99)(C99)
浮点数操作函数
ldexp scalbnscalbln (C99)(C99) ilogb (C99) logb (C99)	frexp modf nextafternexttoward (C99)(C99) copysign (C99)
分类
fpclassify (C99) isfinite (C99) isinf (C99) isnan (C99) isnormal (C99) signbit (C99)	isgreater (C99) isgreaterequal (C99) isless (C99) islessequal (C99) islessgreater (C99) isunordered (C99)
类型
div_tldiv_tlldiv_timaxdiv_t (C99)(C99)	float_tdouble_t (C99)(C99)
宏常量
HUGE_VALFHUGE_VALHUGE_VALL (C99)(C99) FP_FAST_FMAFFP_FAST_FMAFP_FAST_FMAL (C99)(C99)(C99) math_errhandlingMATH_ERRNOMATH_ERRNOEXCEPT (C99)(C99)(C99)	INFINITY (C99) NAN (C99) FP_ILOGB0FP_ILOGBNAN (C99)(C99) FP_NORMALFP_SUBNORMALFP_ZEROFP_INFINITEFP_NAN (C99)(C99)(C99)(C99)(C99)

 

定义于头文件 <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

引用

• C11 standard (ISO/IEC 9899:2011):

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

• 7.25 Type-generic math <tgmath.h> (p: 373-375)

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

• C99 standard (ISO/IEC 9899:1999):

• 7.12.9.8 The trunc functions (p: 234)

• 7.22 Type-generic math <tgmath.h> (p: 335-337)

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

参阅

floorfloorffloorl (C99)(C99)	计算不大于给定值的最大整数 (函数)
ceilceilfceill (C99)(C99)	计算不小于给定值的最小整数 (函数)
roundroundfroundllroundlroundflroundllroundllroundfllroundl (C99)(C99)(C99)(C99)(C99)(C99)(C99)(C99)(C99)	取整到最接近的整数，在相邻整数正中间时取远离零的数 (函数)