Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C

<fenv.h> — prostředí plovoucí řádové čárky

Hlavička <fenv.h> zpřístupňuje příznaky výjimek a řídicí režimy plovoucí řádové čárky. Umožňuje zkoumat výjimečné stavy, měnit zaokrouhlování a ukládat i obnovovat prostředí vlákna.

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

Syntaxe

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

<fenv.h> spravuje stavové příznaky a řídicí režimy. fenv_t představuje celé dynamické prostředí, fexcept_t stav výjimek a femode_t pouze řídicí režimy. Dynamické prostředí náleží konkrétnímu vláknu.

FE_DIVBYZERO označuje dělení nulou, FE_INVALID neplatnou operaci, FE_OVERFLOW přetečení, FE_UNDERFLOW podtečení a FE_INEXACT nepřesný výsledek. Běžné aritmetické operace nemažou již nastavené příznaky výjimek. Obnovení uloženého prostředí pomocí fesetenv však může smazat příznaky, které v uloženém stavu nebyly nastavené, aniž by bylo nutné samostatně volat feclearexcept. FE_ALL_EXCEPT kombinuje všechny podporované výjimky pomocí |; pokud žádné nejsou, má hodnotu 0. Používejte feclearexcept a fetestexcept.

FE_DOWNWARD zaokrouhluje směrem k −∞, FE_UPWARD směrem k +∞, FE_TOWARDZERO směrem k nule a FE_TONEAREST na nejbližší hodnotu. FE_TONEARESTFROMZERO zaokrouhluje na nejbližší hodnotu a při stejné vzdálenosti dvou hodnot volí tu vzdálenější od nuly. Pro FE_TONEAREST zaručuje vazba na IEC 60559 podle přílohy F zaokrouhlení na sudou hodnotu při stejné vzdálenosti. Samotná existence makra toto pravidlo nezaručuje. Makra jednotlivých výjimek a směrů existují pouze při odpovídající podpoře; ověřte je pomocí #ifdef. fegetround čte dynamický směr, fesetround jej nastavuje.

FE_DFL_ENV označuje výchozí prostředí pro fesetenv; FE_DFL_MODE označuje výchozí režimy pro fesetmode, aniž by obnovoval příznaky. FE_DYNAMIC je token pro #pragma STDC FENV_ROUND FE_DYNAMIC, který vybírá dynamické zaokrouhlování; nejde o argument funkce fesetround.

Při testování příznaků nebo používání nestandardních dynamických režimů používejte #pragma STDC FENV_ACCESS ON. Kontrolujte výsledky operací a obnovte uložený stav. Samotná volba C23 v kompilátoru repozitáře nedokládá podporu v produkčním běhovém prostředí.

Příklady

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

Výsledek

flags clear

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje