命名空间
变体
操作

trunc, truncf, truncl

来自 cppreference.cn
< c‎ | numeric‎ | math
 
 
 
常用数学函数
函数
基本操作
(C99)
(C99)
(C99)
(C99)(C99)(C99)(C23)
最大值/最小值操作
(C99)
(C99)
指数函数
(C23)
(C99)
(C99)
(C23)
(C23)

(C99)
(C99)(C23)
(C23)
(C23)
幂函数
(C99)
(C23)
(C23)

(C99)
(C23)
(C23)
三角函数和双曲函数
(C23)
(C23)
(C23)
(C23)
(C99)
(C99)
(C99)
最接近整数的浮点数
(C99)(C99)(C99)
trunc
(C99)

(C99)(C99)(C99)
(C23)(C23)(C23)(C23)
浮点数操作
(C99)(C99)
(C99)(C23)
(C99)
窄化操作
(C23)
(C23)
(C23)
(C23)
(C23)
(C23)
量子和量子指数
十进制重编码函数
总阶数和有效载荷函数
分类
(C99)
(C99)
(C99)
(C23)
误差和伽玛函数
(C99)
(C99)
(C99)
(C99)
类型
宏常量
特殊浮点数值
(C99)(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-trunc.svg
参数

[编辑] 错误处理

错误报告按照 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 trunc 函数 (页码:待定)
  • 7.25 类型泛型数学 <tgmath.h> (页码:待定)
  • F.10.6.8 trunc 函数 (页码:待定)
  • C17 标准 (ISO/IEC 9899:2018)
  • 7.12.9.8 trunc 函数 (页码:待定)
  • 7.25 类型泛型数学 <tgmath.h> (页码:待定)
  • F.10.6.8 trunc 函数 (页码:待定)
  • C11 标准 (ISO/IEC 9899:2011)
  • 7.12.9.8 trunc 函数 (页码:253-254)
  • 7.25 类型泛型数学 <tgmath.h> (页码:373-375)
  • F.10.6.8 trunc 函数 (页码:528)
  • C99 标准 (ISO/IEC 9899:1999)
  • 7.12.9.8 trunc 函数 (页码:234)
  • 7.22 类型泛型数学 <tgmath.h> (页码:335-337)
  • F.9.6.8 trunc 函数 (页码:464)

[编辑] 参见

计算不大于给定值的最大整数
(函数) [编辑]
(C99)(C99)
计算不小于给定值的最小整数
(函数) [编辑]
(C99)(C99)(C99)(C99)(C99)(C99)(C99)(C99)(C99)
舍入到最接近的整数,中间情况远离零舍入
(函数) [编辑]
C++ 文档 关于 trunc