trunc, truncf, truncl
提供: cppreference.com
<tbody>
</tbody>
| ヘッダ <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_errhandling で規定されている通りにエラーが報告されます。
処理系が IEEE 浮動小数点算術 (IEC 60559) をサポートしている場合、
- 現在の丸めモードは効果を持ちません。
argが ±∞ であれば、それが変更されずに返されます。argが ±0 であれば、それが変更されずに返されます。argが NaN であれば、 NaN が返されます。
ノート
非整数の有限な値を丸めるとき、 FE_INEXACT が発生するかもしれません (が要求されているわけではありません)。
すべての標準の浮動小数点フォーマットにおいて、最も大きな表現可能な浮動小数点値は正確な整数であるため、この関数それ自体はオーバーフローすることはありません。 しかし任意の整数型 (intmax_t も含みます) は、整数変数に格納するとき、結果がオーバーフローするかもしれません。
浮動小数点から整数型への暗黙の変換もゼロに向かって丸めますが、ターゲットの型で表現可能な値に限定されます。
例
Run this code
#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)
関連項目
(C99)(C99) |
指定された値より大きくない最も大きな整数を返します (関数) |
(C99)(C99) |
指定された値より小さくない最も小さな整数を返します (関数) |
(C99)(C99)(C99)(C99)(C99)(C99)(C99)(C99)(C99) |
最も近い整数に丸めます。 ちょうど中央の場合はゼロから遠ざかる方向に丸めます (関数) |
trunc の C++リファレンス
| |