std:: trunc, std:: truncf, std:: truncl
|
ヘッダーで定義
<cmath>
|
||
| (1) | ||
|
float
trunc
(
float
num
)
;
double
trunc
(
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オーバーロード
(C++26から)
|
||
|
ヘッダーで定義
<simd>
|
||
|
template
<
/*math-floating-point*/
V
>
constexpr
/*deduced-simd-t*/
<
V
>
|
(S) | (C++26から) |
|
追加のオーバーロード
(C++11から)
|
||
|
ヘッダーで定義
<cmath>
|
||
|
template
<
class
Integer
>
double trunc ( Integer num ) ; |
(A) | (C++23からconstexpr) |
std::trunc
のオーバーロードを提供する。
(C++23以降)
|
S)
SIMDオーバーロードは
v_num
に対して要素ごとの
std::trunc
を実行します。
|
(C++26以降) |
|
A)
すべての整数型に対して追加のオーバーロードが提供されており、これらは
double
として扱われます。
|
(since C++11) |
目次 |
パラメータ
| num | - | 浮動小数点または整数値 |
戻り値
エラーが発生しない場合、絶対値が num 以下で最も近い整数値(言い換えれば、 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)
|
最も近い整数(中間値の場合にはゼロから遠ざかる方向に丸める)
(関数) |
|
Cドキュメント
for
trunc
|
|