trunc, truncf, truncl

float       truncf( float arg );

double      trunc( double arg );

long double truncl( long double arg );

#define trunc( arg )

Параметры

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

Если ошибок не возникает, возвращается ближайшее целое число, модуль которого не больше модуля arg (иначе говоря, arg, округлённое к нулю).

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

Аргумент

Обработка ошибок

Об ошибках сообщается согласно требованиям 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

Ссылки

• Стандарт C23 (ISO/IEC 9899:2024):
• 7.12.9.8 Функции trunc (с. TBD)
• 7.25 Обобщённая математика для типов <tgmath.h> (с. TBD)
• F.10.6.8 Функции trunc (с. TBD)
• Стандарт C17 (ISO/IEC 9899:2018):
• 7.12.9.8 Функции trunc (с. TBD)
• 7.25 Обобщённая математика для типов <tgmath.h> (с. TBD)
• F.10.6.8 Функции trunc (с. TBD)
• Стандарт C11 (ISO/IEC 9899:2011):
• 7.12.9.8 Функции trunc (с. 253-254)
• 7.25 Обобщённая математика для типов <tgmath.h> (с. 373-375)
• F.10.6.8 Функции trunc (с. 528)
• Стандарт C99 (ISO/IEC 9899:1999):
• 7.12.9.8 Функции trunc (с. 234)
• 7.22 Обобщённая математика для типов <tgmath.h> (с. 335-337)
• F.9.6.8 Функции trunc (с. 464)

См. также