Namespaces
Variants

FE_DOWNWARD, FE_TONEAREST, FE_TOWARDZERO, FE_UPWARD

From cppreference.net
< c ‎ | numeric ‎ | fenv
Определено в заголовочном файле <fenv.h>
#define FE_DOWNWARD /*implementation defined*/
(начиная с C99)
#define FE_TONEAREST /*implementation defined*/
(начиная с C99)
#define FE_TOWARDZERO /*implementation defined*/
(начиная с C99)
#define FE_UPWARD /*implementation defined*/
(начиная с C99)

Каждая из этих макроконстант раскрывается в неотрицательное целочисленное константное выражение, которое может использоваться с fesetround и fegetround для указания одного из поддерживаемых режимов округления чисел с плавающей точкой. Реализация может определять дополнительные константы режимов округления в <fenv.h> , которые должны начинаться с FE_ и содержать как минимум одну заглавную букву. Каждый макрос определяется только если он поддерживается.

Константа Описание
FE_DOWNWARD округление в сторону отрицательной бесконечности
FE_TONEAREST округление к ближайшему представимому значению
FE_TOWARDZERO округление в сторону нуля
FE_UPWARD округление в сторону положительной бесконечности

Дополнительные режимы округления могут поддерживаться реализацией.

Текущий режим округления влияет на следующее:

  • результаты операторов с плавающей точкой вне константных выражений
double x = 1;
x / 10; // 0.09999999999999999167332731531132594682276248931884765625 или
        // 0.1000000000000000055511151231257827021181583404541015625
sqrt(2); // 1.41421356237309492343001693370752036571502685546875 или
         // 1.4142135623730951454746218587388284504413604736328125
  • Неявное преобразование и приведение типов с плавающей точкой к типам с плавающей точкой
double d = 1 + DBL_EPSILON;
float f = d; // 1.00000000000000000000000 или
             // 1.00000011920928955078125
  • преобразования строк, такие как strtod или printf
strtof("0.1", NULL); // 0.0999999940395355224609375 или
                     // 0.100000001490116119384765625
lrint(2.1); // 2 или 3

Текущий режим округления НЕ влияет на следующее:

  • неявное преобразование и приведение типов с плавающей точкой к целочисленным (всегда в сторону нуля)
  • результаты арифметических операторов с плавающей точкой в константных выражениях, выполняемых во время компиляции (всегда к ближайшему)
  • библиотечные функции round , lround , llround , ceil , floor , trunc

Как и в случае с любой floating-point environment функциональностью, округление гарантировано только если установлена #pragma STDC FENV_ACCESS ON директива.

Компиляторы, которые не поддерживают прагму, могут предлагать собственные способы поддержки текущего режима округления. Например, Clang и GCC имеют опцию -frounding-math предназначенную для отключения оптимизаций, которые могут изменить смысл кода, чувствительного к округлению.

Пример

#include <fenv.h>
#include <math.h>
#include <stdio.h>
#include <stdlib.h>
// #pragma STDC FENV_ACCESS ON
int main()
{
    fesetround(FE_DOWNWARD);
    puts("rounding down: ");
    printf("           pi = %.22f\n", acosf(-1));
    printf("strtof(\"1.1\") = %.22f\n", strtof("1.1", NULL));
    printf("    rint(2.1) = %.22f\n\n", rintf(2.1));
    fesetround(FE_UPWARD);
    puts("rounding up: ");
    printf("           pi = %.22f\n", acosf(-1));
    printf("strtof(\"1.1\") = %.22f\n", strtof("1.1", NULL));
    printf("    rint(2.1) = %.22f\n", rintf(2.1));
}

Вывод:

rounding down:
           pi = 3.1415925025939941406250
strtof("1.1") = 1.0999999046325683593750
    rint(2.1) = 2.0000000000000000000000
rounding up:
           pi = 3.1415927410125732421875
strtof("1.1") = 1.1000000238418579101563
    rint(2.1) = 3.0000000000000000000000

Ссылки

  • Стандарт C23 (ISO/IEC 9899:2024):
  • 7.6/8 Среда с плавающей запятой <fenv.h> (стр.: TBD)
  • Стандарт C17 (ISO/IEC 9899:2018):
  • 7.6/8 Среда с плавающей запятой <fenv.h> (стр: 151)
  • Стандарт C11 (ISO/IEC 9899:2011):
  • 7.6/8 Среда с плавающей запятой <fenv.h> (стр: 207)
  • Стандарт C99 (ISO/IEC 9899:1999):
  • 7.6/7 Среда с плавающей запятой <fenv.h> (стр: 188)

Смотрите также

получает или устанавливает направление округления
(функция)
C++ documentation для макросов округления чисел с плавающей точкой