Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C

<fenv.h> — ambiente de vírgula flutuante

O cabeçalho <fenv.h> disponibiliza indicadores de exceção e modos de controlo de vírgula flutuante. Permite examinar condições excepcionais, alterar o arredondamento e guardar e restaurar o ambiente de uma thread.

Versão: C23; repository compiler flag, production runtime not attested

Sintaxe

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

<fenv.h> gere indicadores de estado e modos de controlo. fenv_t representa todo o ambiente dinâmico, fexcept_t o estado das exceções e femode_t apenas os modos de controlo. O ambiente dinâmico é específico da thread.

FE_DIVBYZERO significa divisão por zero, FE_INVALID uma operação inválida, FE_OVERFLOW excesso, FE_UNDERFLOW falta e FE_INEXACT um resultado inexato. As operações aritméticas correntes não limpam os indicadores de exceção que já estão ativos. No entanto, restaurar um ambiente guardado com fesetenv pode limpar os indicadores que não estavam ativos no estado guardado, sem ser necessário fazer uma chamada separada a feclearexcept. FE_ALL_EXCEPT combina com | todas as exceções suportadas; vale 0 se não existir nenhuma. Utilize feclearexcept e fetestexcept.

FE_DOWNWARD arredonda em direção a −∞, FE_UPWARD em direção a +∞, FE_TOWARDZERO em direção a zero e FE_TONEAREST para o valor mais próximo. FE_TONEARESTFROMZERO arredonda para o valor mais próximo e, em caso de empate, escolhe o valor mais afastado de zero. Para FE_TONEAREST, as regras de ligação à IEC 60559 definidas no anexo F garantem o arredondamento para o valor par em caso de empate. A mera presença da macro não garante esta regra. As macros de exceções e direções individuais só existem quando há suporte correspondente; verifique com #ifdef. fegetround lê a direção dinâmica e fesetround define-a.

FE_DFL_ENV designa o ambiente predefinido para fesetenv; FE_DFL_MODE designa os modos predefinidos para fesetmode, sem restaurar os indicadores. FE_DYNAMIC é um token para #pragma STDC FENV_ROUND FE_DYNAMIC, que seleciona o arredondamento dinâmico; não é um argumento de fesetround.

Utilize #pragma STDC FENV_ACCESS ON ao testar indicadores ou usar modos dinâmicos não predefinidos. Verifique os resultados das operações e restaure o estado guardado. A simples seleção de C23 no compilador de um repositório não comprova o suporte no ambiente de execução de produção.

Exemplos

#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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes