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.