CKTIS / C
<fenv.h> — drijvendekommaomgeving
De header <fenv.h> biedt drijvendekomma-exceptievlaggen en besturingsmodi. Programma’s kunnen uitzonderlijke situaties onderzoeken, de afronding wijzigen en de omgeving van een thread opslaan en herstellen.
Versie: C23; repository compiler flag, production runtime not attested
Syntax
#include <fenv.h>
#pragma STDC FENV_ACCESS ON<fenv.h> beheert statusvlaggen en besturingsmodi. fenv_t staat voor de volledige dynamische omgeving, fexcept_t voor de uitzonderingsstatus en femode_t alleen voor de besturingsmodi. De dynamische omgeving is threadgebonden.
FE_DIVBYZERO betekent delen door nul, FE_INVALID een ongeldige bewerking, FE_OVERFLOW overloop, FE_UNDERFLOW onderloop en FE_INEXACT een onnauwkeurig resultaat. Gewone rekenbewerkingen wissen geen exceptievlaggen die al zijn ingesteld. Bij het herstellen van een opgeslagen omgeving met fesetenv kunnen echter vlaggen worden gewist die in de opgeslagen toestand niet waren ingesteld, zonder dat daarvoor een aparte aanroep van feclearexcept nodig is. FE_ALL_EXCEPT combineert alle ondersteunde uitzonderingen met |; de waarde is 0 als er geen zijn. Gebruik feclearexcept en fetestexcept.
FE_DOWNWARD rondt af richting −∞, FE_UPWARD richting +∞, FE_TOWARDZERO richting nul en FE_TONEAREST naar de dichtstbijzijnde waarde. FE_TONEARESTFROMZERO rondt af naar de dichtstbijzijnde waarde en kiest bij gelijke afstand de waarde die verder van nul ligt. Voor FE_TONEAREST garandeert de koppeling met IEC 60559 volgens bijlage F dat bij gelijke afstand naar de even waarde wordt afgerond. De aanwezigheid van de macro op zich biedt die garantie niet. Macro’s voor afzonderlijke uitzonderingen en richtingen bestaan alleen bij overeenkomstige ondersteuning; controleer dit met #ifdef. fegetround leest de dynamische richting en fesetround stelt die in.
FE_DFL_ENV duidt de standaardomgeving aan voor fesetenv; FE_DFL_MODE duidt de standaardmodi aan voor fesetmode, zonder vlaggen te herstellen. FE_DYNAMIC is een token voor #pragma STDC FENV_ROUND FE_DYNAMIC, waarmee dynamische afronding wordt gekozen; het is geen argument voor fesetround.
Gebruik #pragma STDC FENV_ACCESS ON bij het testen van vlaggen of het gebruiken van niet-standaard dynamische modi. Controleer de resultaten van bewerkingen en herstel de opgeslagen toestand. Alleen C23 selecteren in de compiler van een repository bewijst geen ondersteuning in de productie-runtime.
Voorbeelden
#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;
}Resultaat
flags clear
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.