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)
(constexpr начиная с C++23) |
|
long
double
truncl
(
long
double
num
)
;
|
(3) |
(начиная с C++11)
(constexpr начиная с C++23) |
|
Перегрузка 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) | (constexpr начиная с C++23) |
std::trunc
для всех cv-неквалифицированных типов с плавающей запятой в качестве типа параметра.
(since C++23)
|
S)
Перегрузка SIMD выполняет поэлементное применение
std::trunc
к
v_num
.
|
(since 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
для
trunc
|
|