Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje