名前空間
変種
操作

trunc, truncf, truncl

提供: cppreference.com
< c‎ | numeric‎ | math
 
 
 
一般的な数学関数
関数
基本操作
(C99)
(C99)
(C99)
(C99)
(C99)
(C99)(C99)(C99)
指数関数
(C99)
(C99)
(C99)
(C99)
冪関数
(C99)
(C99)
三角関数と双曲線関数
(C99)
(C99)
(C99)
誤差関数とガンマ関数
(C99)
(C99)
(C99)
(C99)
最も近い整数
(C99)(C99)(C99)
trunc
(C99)
(C99)(C99)(C99)
浮動小数点操作関数
(C99)(C99)
(C99)
(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) 型総称マクロ。 arglong 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

[編集] 参考文献

  • C11 standard (ISO/IEC 9899:2011):
  • 7.12.9.8 The trunc functions (p: 253-254)
  • 7.25 Type-generic math <tgmath.h> (p: 373-375)
  • F.10.6.8 The trunc functions (p: 528)
  • C99 standard (ISO/IEC 9899:1999):
  • 7.12.9.8 The trunc functions (p: 234)
  • 7.22 Type-generic math <tgmath.h> (p: 335-337)
  • F.9.6.8 The trunc functions (p: 464)

[編集] 関連項目

指定された値より大きくない最も大きな整数を返します
(関数) [edit]
(C99)(C99)
指定された値より小さくない最も小さな整数を返します
(関数) [edit]
(C99)(C99)(C99)
最も近い整数に丸めます。 ちょうど中央の場合はゼロから遠ざかる方向に丸めます
(関数) [edit]