Namespaces
Variants

FE_DOWNWARD, FE_TONEAREST, FE_TOWARDZERO, FE_UPWARD

From cppreference.net
< c ‎ | numeric ‎ | fenv
Definido en el encabezado <fenv.h>
#define FE_DOWNWARD /*implementation defined*/
(desde C99)
#define FE_TONEAREST /*implementation defined*/
(desde C99)
#define FE_TOWARDZERO /*implementation defined*/
(desde C99)
#define FE_UPWARD /*implementation defined*/
(desde C99)

Cada una de estas constantes de macro se expande a una expresión constante entera no negativa, que puede utilizarse con fesetround y fegetround para indicar uno de los modos de redondeo de punto flotante soportados. La implementación puede definir constantes adicionales de modo de redondeo en <fenv.h> , que deben comenzar con FE_ seguido por al menos una letra mayúscula. Cada macro solo se define si está soportada.

Constante Explicación
FE_DOWNWARD redondeo hacia infinito negativo
FE_TONEAREST redondeo hacia el valor representable más cercano
FE_TOWARDZERO redondeo hacia cero
FE_UPWARD redondeo hacia infinito positivo

Modos de redondeo adicionales pueden ser soportados por una implementación.

El modo de redondeo actual afecta a lo siguiente:

  • resultados de operadores aritméticos de punto flotante fuera de expresiones constantes
double x = 1;
x / 10; // 0.09999999999999999167332731531132594682276248931884765625 o
        // 0.1000000000000000055511151231257827021181583404541015625
sqrt(2); // 1.41421356237309492343001693370752036571502685546875 o
         // 1.4142135623730951454746218587388284504413604736328125
  • conversión implícita y conversiones explícitas de punto flotante a punto flotante
double d = 1 + DBL_EPSILON;
float f = d; // 1.00000000000000000000000 o
             // 1.00000011920928955078125
strtof("0.1", NULL); // 0.0999999940395355224609375 o
                     // 0.100000001490116119384765625
lrint(2.1); // 2 o 3

El modo de redondeo actual NO afecta a lo siguiente:

  • conversión implícita y conversiones de punto flotante a entero (siempre hacia cero)
  • resultados de operadores aritméticos de punto flotante en expresiones constantes ejecutadas en tiempo de compilación (siempre al más cercano)
  • las funciones de biblioteca round , lround , llround , ceil , floor , trunc

Como con cualquier funcionalidad del entorno de punto flotante , el redondeo solo está garantizado si #pragma STDC FENV_ACCESS ON está establecido.

Los compiladores que no admiten el pragma pueden ofrecer sus propias formas de soportar el modo de redondeo actual. Por ejemplo Clang y GCC tienen la opción -frounding-math destinada a desactivar optimizaciones que cambiarían el significado del código sensible al redondeo.

Ejemplo

#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));
}

Salida:

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

Referencias

  • Estándar C23 (ISO/IEC 9899:2024):
  • 7.6/8 Entorno de punto flotante <fenv.h> (p: TBD)
  • Estándar C17 (ISO/IEC 9899:2018):
  • 7.6/8 Entorno de punto flotante <fenv.h> (p: 151)
  • Estándar C11 (ISO/IEC 9899:2011):
  • 7.6/8 Entorno de punto flotante <fenv.h> (p: 207)
  • Estándar C99 (ISO/IEC 9899:1999):
  • 7.6/7 Entorno de punto flotante <fenv.h> (p: 188)

Véase también

obtiene o establece la dirección de redondeo
(función)
Documentación de C++ para macros de redondeo de punto flotante