Namespaces
Variants

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

From cppreference.net
Common mathematical functions
Nearest integer floating point operations
trunc
(C++11)
(C++11)
(C++11) (C++11) (C++11)
Floating point manipulation functions
(C++11) (C++11)
(C++11)
(C++11)
Classification and comparison
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
Types
(C++11)
(C++11)
(C++11)
Macro constants
ヘッダーで定義 <cmath>
(1)
float trunc ( float num ) ;

double trunc ( double num ) ;

long double trunc ( long double num ) ;
(C++23まで)
constexpr /*floating-point-type*/
trunc ( /*floating-point-type*/ 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>
template < /*math-floating-point*/ V >

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

trunc ( const V & v_num ) ;
(S) (C++26から)
ヘッダーで定義 <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 として扱われます。
(since 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)
最も近い整数(中間値の場合にはゼロから遠ざかる方向に丸める)
(関数)