Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C

<fenv.h> — entorno de coma flotante

El encabezado <fenv.h> proporciona indicadores de excepción y modos de control de coma flotante. Permite examinar condiciones excepcionales, cambiar el redondeo y guardar y restaurar el entorno de un hilo.

Versión: C23; repository compiler flag, production runtime not attested

Sintaxis

#include <fenv.h>
#pragma STDC FENV_ACCESS ON

<fenv.h> gestiona los indicadores de estado y los modos de control. fenv_t representa todo el entorno dinámico, fexcept_t el estado de las excepciones y femode_t únicamente los modos de control. El entorno dinámico es propio de cada hilo.

FE_DIVBYZERO indica división por cero, FE_INVALID una operación no válida, FE_OVERFLOW desbordamiento, FE_UNDERFLOW subdesbordamiento y FE_INEXACT un resultado inexacto. Las operaciones aritméticas ordinarias no borran los indicadores de excepción que ya están activados. Sin embargo, restaurar un entorno guardado con fesetenv puede borrar los indicadores que no estaban activados en el estado guardado, sin necesidad de llamar por separado a feclearexcept. FE_ALL_EXCEPT combina con | todas las excepciones admitidas; vale 0 si no hay ninguna. Use feclearexcept y fetestexcept.

FE_DOWNWARD redondea hacia −∞, FE_UPWARD hacia +∞, FE_TOWARDZERO hacia cero y FE_TONEAREST al valor más cercano. FE_TONEARESTFROMZERO redondea al valor más cercano y, en caso de empate, elige el que está más lejos de cero. Para FE_TONEAREST, la vinculación con IEC 60559 definida en el anexo F garantiza el redondeo al valor par en caso de empate. La mera presencia de la macro no garantiza esta regla. Las macros de excepciones y direcciones individuales solo existen si hay compatibilidad correspondiente; compruébelo con #ifdef. fegetround lee la dirección dinámica y fesetround la establece.

FE_DFL_ENV designa el entorno predeterminado para fesetenv; FE_DFL_MODE designa los modos predeterminados para fesetmode, sin restaurar los indicadores. FE_DYNAMIC es un token para #pragma STDC FENV_ROUND FE_DYNAMIC, que selecciona el redondeo dinámico; no es un argumento de fesetround.

Use #pragma STDC FENV_ACCESS ON al comprobar indicadores o usar modos dinámicos no predeterminados. Compruebe los resultados de las operaciones y restaure el estado guardado. Seleccionar C23 en el compilador de un repositorio, por sí solo, no acredita la compatibilidad del entorno de ejecución de producción.

Ejemplos

#include <fenv.h>
#include <stdio.h>
#include <stdlib.h>

#pragma STDC FENV_ACCESS ON

int main(void)
{
    fenv_t saved;
    int cleared;

    if (fegetenv(&saved) != 0)
        return EXIT_FAILURE;

    if (feclearexcept(FE_ALL_EXCEPT) != 0) {
        (void)fesetenv(&saved);
        return EXIT_FAILURE;
    }

    cleared = fetestexcept(FE_ALL_EXCEPT) == 0;
    if (fesetenv(&saved) != 0)
        return EXIT_FAILURE;

    puts(cleared ? "flags clear" : "unexpected flags");
    return cleared ? EXIT_SUCCESS : EXIT_FAILURE;
}

Resultado

flags clear

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes