Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

<fenv.h> — środowisko zmiennoprzecinkowe

Nagłówek <fenv.h> udostępnia flagi wyjątków i tryby sterowania obliczeniami zmiennoprzecinkowymi. Pozwala badać błędy, zmieniać zaokrąglanie oraz zapisywać i odtwarzać środowisko wątku.

Wersja: C23; repository compiler flag, production runtime not attested

Składnia

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

<fenv.h> obsługuje flagi stanu i tryby sterowania. fenv_t reprezentuje całe środowisko dynamiczne, fexcept_t — stan wyjątków, a femode_t — same tryby. Środowisko dynamiczne należy do wątku.

FE_DIVBYZERO oznacza dzielenie przez zero, FE_INVALID — nieprawidłową operację, FE_OVERFLOW — nadmiar, FE_UNDERFLOW — niedomiar, a FE_INEXACT — niedokładny wynik. Zwykłe operacje arytmetyczne nie kasują ustawionych flag wyjątków. Odtworzenie zapisanego środowiska za pomocą fesetenv może jednak wyczyścić flagi, które nie były ustawione w zapisanym stanie, bez osobnego wywołania feclearexcept. FE_ALL_EXCEPT łączy wszystkie obsługiwane wyjątki operatorem |; wynosi 0, gdy nie ma żadnych. Używaj feclearexcept i fetestexcept.

FE_DOWNWARD zaokrągla ku −∞, FE_UPWARD ku +∞, FE_TOWARDZERO ku zeru, FE_TONEAREST do najbliższej wartości, a FE_TONEARESTFROMZERO do najbliższej wartości, przy równej odległości od dwóch wartości wybierając tę dalszą od zera. Dla FE_TONEAREST regułę wyboru wartości parzystej przy równej odległości gwarantują zasady powiązania C z IEC 60559 określone w załączniku F. Sama obecność makra nie daje tej gwarancji. Makra poszczególnych wyjątków i kierunków istnieją tylko przy odpowiednim wsparciu; sprawdzaj #ifdef. fegetround odczytuje kierunek dynamiczny, fesetround go ustawia.

FE_DFL_ENV wskazuje domyślne środowisko dla fesetenv; FE_DFL_MODE wskazuje domyślne tryby dla fesetmode, bez przywracania flag. FE_DYNAMIC jest tokenem dla #pragma STDC FENV_ROUND FE_DYNAMIC, wybierającym zaokrąglanie dynamiczne, nie argumentem fesetround.

Przy badaniu flag lub używaniu niestandardowych trybów dynamicznych stosuj #pragma STDC FENV_ACCESS ON. Sprawdzaj wyniki operacji i odtwarzaj zapisany stan. Sam wybór C23 w kompilatorze repozytorium nie potwierdza obsługi w środowisku produkcyjnym.

Przykłady

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

Wynik

flags clear

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła