Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C

<fenv.h> — okolje s plavajočo vejico

Glava <fenv.h> omogoča dostop do zastavic izjem in načinov krmiljenja za plavajočo vejico. Z njo lahko preverjamo izjemna stanja, spreminjamo zaokroževanje ter shranimo in obnovimo okolje niti.

Različica: C23; repository compiler flag, production runtime not attested

Sintaksa

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

<fenv.h> upravlja zastavice stanja in načine krmiljenja. fenv_t predstavlja celotno dinamično okolje, fexcept_t stanje izjem, femode_t pa samo načine krmiljenja. Dinamično okolje je vezano na nit.

FE_DIVBYZERO pomeni deljenje z nič, FE_INVALID neveljavno operacijo, FE_OVERFLOW prekoračitev, FE_UNDERFLOW podkoračitev, FE_INEXACT pa nenatančen rezultat. Običajne aritmetične operacije ne počistijo že nastavljenih zastavic izjem. Obnovitev shranjenega okolja s fesetenv pa lahko počisti zastavice, ki v shranjenem stanju niso bile nastavljene, brez ločenega klica feclearexcept. FE_ALL_EXCEPT z operatorjem | združi vse podprte izjeme; če jih ni, je njegova vrednost 0. Uporabljajte feclearexcept in fetestexcept.

FE_DOWNWARD zaokrožuje proti −∞, FE_UPWARD proti +∞, FE_TOWARDZERO proti nič, FE_TONEAREST pa na najbližjo vrednost. FE_TONEARESTFROMZERO zaokrožuje na najbližjo vrednost; če sta dve vrednosti enako oddaljeni, izbere tisto, ki je dlje od ničle. Za FE_TONEAREST povezava z IEC 60559 po dodatku F zagotavlja zaokroževanje na sodo vrednost, kadar sta dve vrednosti enako oddaljeni. Sam obstoj makra tega pravila ne zagotavlja. Makri za posamezne izjeme in smeri obstajajo samo ob ustrezni podpori; preverite jih z #ifdef. fegetround prebere dinamično smer, fesetround pa jo nastavi.

FE_DFL_ENV označuje privzeto okolje za fesetenv; FE_DFL_MODE označuje privzete načine za fesetmode, ne da bi obnovil zastavice. FE_DYNAMIC je žeton za #pragma STDC FENV_ROUND FE_DYNAMIC, ki izbere dinamično zaokroževanje; ni argument za fesetround.

Pri preverjanju zastavic ali uporabi neprivzetih dinamičnih načinov uporabite #pragma STDC FENV_ACCESS ON. Preverite rezultate operacij in obnovite shranjeno stanje. Sama izbira C23 v prevajalniku repozitorija ne potrjuje podpore v produkcijskem izvajalnem okolju.

Primeri

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

Rezultat

flags clear

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri