命名空间
变体
操作

trunc、truncf、truncl

来自 cppreference.com
< c‎ | numeric‎ | math
 
 
 
常用数学函数
类型
(C99)(C99)    

(C99)(C99)    

函数
基本操作
(C99)
(C99)
(C99)
(C99)(C99)(C99)(C23)
最大/最小操作
(C99)
(C23)    
指数函数
(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)
(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)(C23)
参数和返回值
(C99)(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-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 函数 (p: TBD)
  • 7.25 类型泛型数学 <tgmath.h> (p: TBD)
  • F.10.6.8 trunc 函数 (p: TBD)
  • C17 标准 (ISO/IEC 9899:2018)
  • 7.12.9.8 trunc 函数 (p: TBD)
  • 7.25 类型泛型数学 <tgmath.h> (p: TBD)
  • F.10.6.8 trunc 函数 (p: TBD)
  • C11 标准 (ISO/IEC 9899:2011)
  • 7.12.9.8 trunc 函数 (p: 253-254)
  • 7.25 类型通用数学 <tgmath.h> (p: 373-375)
  • F.10.6.8 trunc 函数 (p: 528)
  • C99 标准 (ISO/IEC 9899:1999)
  • 7.12.9.8 trunc 函数 (p: 234)
  • 7.22 类型通用数学 <tgmath.h> (p: 335-337)
  • F.9.6.8 trunc 函数 (p: 464)

[编辑] 参见

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