CKTIS / C
<fenv.h> — prostredie s pohyblivou rádovou čiarkou
Hlavička <fenv.h> sprístupňuje príznaky výnimiek a riadiace režimy prostredia s pohyblivou rádovou čiarkou. Umožňuje skúmať výnimočné stavy, meniť zaokrúhľovanie a ukladať aj obnovovať prostredie vlákna.
Verzia: C23; repository compiler flag, production runtime not attested
Syntax
#include <fenv.h>
#pragma STDC FENV_ACCESS ON<fenv.h> spravuje stavové príznaky a riadiace režimy. fenv_t predstavuje celé dynamické prostredie, fexcept_t stav výnimiek a femode_t iba riadiace režimy. Dynamické prostredie patrí konkrétnemu vláknu.
FE_DIVBYZERO označuje delenie nulou, FE_INVALID neplatnú operáciu, FE_OVERFLOW pretečenie, FE_UNDERFLOW podtečenie a FE_INEXACT nepresný výsledok. Bežné aritmetické operácie nevymazávajú už nastavené príznaky výnimiek. Obnovenie uloženého prostredia pomocou fesetenv však môže vymazať príznaky, ktoré v uloženom stave neboli nastavené, bez samostatného volania feclearexcept. FE_ALL_EXCEPT kombinuje všetky podporované výnimky pomocou |; ak žiadne nie sú, má hodnotu 0. Používajte feclearexcept a fetestexcept.
FE_DOWNWARD zaokrúhľuje smerom k −∞, FE_UPWARD smerom k +∞, FE_TOWARDZERO smerom k nule a FE_TONEAREST na najbližšiu hodnotu. FE_TONEARESTFROMZERO zaokrúhľuje na najbližšiu hodnotu a pri rovnakej vzdialenosti dvoch hodnôt vyberie tú vzdialenejšiu od nuly. Pre FE_TONEAREST väzba na IEC 60559 podľa prílohy F zaručuje zaokrúhlenie na párnu hodnotu pri rovnakej vzdialenosti. Samotná existencia makra toto pravidlo nezaručuje. Makrá jednotlivých výnimiek a smerov existujú iba pri zodpovedajúcej podpore; overte ich pomocou #ifdef. fegetround číta dynamický smer a fesetround ho nastavuje.
FE_DFL_ENV označuje predvolené prostredie pre fesetenv; FE_DFL_MODE označuje predvolené režimy pre fesetmode bez obnovenia príznakov. FE_DYNAMIC je token pre #pragma STDC FENV_ROUND FE_DYNAMIC, ktorý vyberá dynamické zaokrúhľovanie; nie je argumentom funkcie fesetround.
Pri testovaní príznakov alebo používaní neštandardných dynamických režimov používajte #pragma STDC FENV_ACCESS ON. Kontrolujte výsledky operácií a obnovte uložený stav. Samotná voľba C23 v kompilátore repozitára nedokladá podporu v produkčnom runtime prostredí.
Prí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ýsledok
flags clear
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.