std::trunc, std::truncf, std::truncl

Определено в заголовочном файле `<cmath>`
	(1)
float trunc ( float num ); double trunc ( double num ); long double trunc ( long 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)
Дополнительные перегрузки (с C++11)
Определено в заголовочном файле `<cmath>`
template< class Integer > double trunc ( Integer num );	(A)	(constexpr с C++23)

1-3) Вычисляет ближайшее целое число, не превосходящее по модулю num. Библиотека предоставляет перегрузки std::trunc для всех типов с плавающей точкой без квалификаторов cv в качестве типа параметра.(с C++23)

A) Дополнительные перегрузки предоставляются для всех целочисленных типов, которые рассматриваются как double.

(с C++11)

Параметры

num

значение с плавающей точкой или целое значение

Возвращаемое значение

Если ошибки не произошли, возвращается ближайшее целое значение, не превосходящее по модулю 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

См. также

floorfloorffloorl (C++11)(C++11)	ближайшее целое число, не большее заданного значения (функция)
ceilceilfceill (C++11)(C++11)	ближайшее целое число, не меньше заданного значения (функция)
roundroundfroundllroundlroundflroundlllroundllroundfllroundl (C++11)(C++11)(C++11)(C++11)(C++11)(C++11)(C++11)(C++11)(C++11)	ближайшее целое число, округляя в сторону от нуля в случае равноудалённости (функция)
C документация для `trunc`

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/numeric/math/trunc