Namespaces
Variants

trunc, truncf, truncl

From cppreference.net
< c ‎ | numeric ‎ | math
Common mathematical functions
Functions
Basic operations
(C99)
(C99)
(C99)
(C99) (C99) (C99) (C23)
Maximum/minimum operations
Exponential functions
Power functions
Trigonometric and hyperbolic functions
Nearest integer floating-point
(C99) (C99) (C99)
trunc
(C99)

(C99) (C99) (C99)
(C23) (C23) (C23) (C23)
Floating-point manipulation
Narrowing operations
(C23)
(C23)
(C23)
(C23)
(C23)
(C23)
Quantum and quantum exponent
Decimal re-encoding functions
Total order and payload functions
Classification
Error and gamma functions
(C99)
(C99)
(C99)
(C99)
Types
Macro constants
Special floating-point values
Arguments and return values
Error handling
Fast operation indicators
ヘッダーで定義 <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)
最も近い整数に丸め、中間値の場合はゼロから離れる方向に丸める
(関数)