std::trunc, std::truncf, std::truncl

来自cppreference.com
< cpp‎ | numeric‎ | math
 
C++
 
数值库
 
常用数学函数
函数
基础运算
(C++11)  
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)(C++11)(C++11)
指数函数
(C++11)
(C++11)

(C++11)
(C++11)
幂函数
(C++11)
(C++11)
三角与双曲函数
(C++11)
(C++11)
(C++11)

误差与伽马函数
(C++11)
(C++11)
(C++11)
(C++11)
浮点数的最接近整数
(C++11)(C++11)(C++11)
trunc
(C++11)
(C++11)
(C++11)(C++11)(C++11)
浮点数操作函数
(C++11)(C++11)
(C++11)
(C++11)
(C++11)(C++11)
(C++11)
分类与比较
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
类型
(C++11)
(C++11)
(C++11)
宏常量
分类
(C++11)(C++11)(C++11)(C++11)(C++11)


 
在标头 <cmath> 定义
(1)
float       trunc ( float num );

double      trunc ( double num );

long double trunc ( long double num );
 (C++23 前)
constexpr /* 浮点数类型 */
            trunc ( /* 浮点数类型 */ num );
 (C++23 起)
float       truncf( float num );
 (2) (C++11 起)
(C++23 起为 constexpr)
long double truncl( long double num );
 (3) (C++11 起)
(C++23 起为 constexpr)
SIMD 重载 (C++26 起)
在标头 <simd> 定义
template< /*math-floating-point*/ V >

constexpr /*deduced-simd-t*/<V>

            trunc ( const V& v_num );
 (S) (C++26 起)
额外重载 (C++11 起)
在标头 <cmath> 定义
template< class Integer >
double      trunc ( Integer num );
 (A) (C++23 起为 constexpr)
1-3) 计算绝对值不大于 num 的最接近整数。标准库提供所有以无 cv 限定的浮点数类型作为形参的类型的 std::trunc 重载。(C++23 起)
S) SIMD 重载对 v_num 实施逐元素 std::trunc。
（参见 math-floating-point 和 deduced-simd-t 的定义。）
(C++26 起)
A) 为所有整数类型提供额外重载，将它们当做 double。
 (C++11 起)

目录

[编辑] 参数

num - 浮点数或整数

[编辑] 返回值

如果没有发生错误，那么返回绝对值不大于 num 的最接近整数（换言之，将 num 向零舍入）。

返回值
math-trunc.svg
num

[编辑] 错误处理

报告 math_errhandling 中指定的错误。

如果实现支持 IEEE 浮点数算术（IEC 60559），那么

  • 当前舍入模式无效。
  • 如果 num 是 ±∞，那么返回不修改的该值。
  • 如果 num 是 ±0，那么返回不修改的该值。
  • 如果 num 是 NaN，那么返回 NaN

[编辑] 注解

截断非整数有限值时可以（但不要求）引发 FE_INEXACT。

因为所有标准浮点数格式的最大可表示浮点数值都是准确的整数，所以此函数自身永远不会上溢；然而将结果存储到整数对象时，结果可以溢出任何整数类型（包含 std::intmax_t）。

从浮点数到整数类型的隐式转换始终向零舍入，但它被限制于能表示成目标类型的值。

额外重载不需要以 (A) 的形式提供。它们只需要能够对它们的整数类型实参 num 确保 std::trunc(num) 和 std::trunc(static_cast<double>(num)) 的效果相同。

[编辑] 示例

运行此代码
#include <cmath>
#include <initializer_list>
#include <iostream>
 
int main()
{
    const auto data = std::initializer_list<double>
    {
        +2.7, -2.9, +0.7, -0.9, +0.0, 0.0, -INFINITY, +INFINITY, -NAN, +NAN
    };
 
    std::cout << std::showpos;
    for (double const x : data)
        std::cout << "trunc(" << x << ") == " << std::trunc(x) << '\n';
}

可能的输出： 

trunc(+2.7) == +2
trunc(-2.9) == -2
trunc(+0.7) == +0
trunc(-0.9) == -0
trunc(+0) == +0
trunc(+0) == +0
trunc(-inf) == -inf
trunc(+inf) == +inf
trunc(-nan) == -nan
trunc(+nan) == +nan

[编辑] 参阅

(C++11)(C++11)
 不大于给定值的最接近整数
(函数) [编辑]
(C++11)(C++11)
 不小于给定值的最接近整数
(函数) [编辑]
(C++11)(C++11)(C++11)(C++11)(C++11)(C++11)(C++11)(C++11)(C++11)
 最接近整数，中间情况下向远离零舍入
(函数) [编辑]
trunc 的 C 文档
来自“https://zh.cppreference.com/mwiki/index.php?title=cpp/numeric/math/trunc&oldid=95784”