CKTIS / C
<fenv.h> — ambiente a virgola mobile
L’header <fenv.h> espone i flag di eccezione e le modalità di controllo a virgola mobile. Consente di esaminare le condizioni eccezionali, modificare l’arrotondamento e salvare e ripristinare l’ambiente di un thread.
Versione: C23; repository compiler flag, production runtime not attested
Sintassi
#include <fenv.h>
#pragma STDC FENV_ACCESS ON<fenv.h> gestisce i flag di stato e le modalità di controllo. fenv_t rappresenta l’intero ambiente dinamico, fexcept_t lo stato delle eccezioni e femode_t le sole modalità di controllo. L’ambiente dinamico è locale al thread.
FE_DIVBYZERO indica una divisione per zero, FE_INVALID un’operazione non valida, FE_OVERFLOW un overflow, FE_UNDERFLOW un underflow e FE_INEXACT un risultato non esatto. Le normali operazioni aritmetiche non cancellano i flag di eccezione già impostati. Il ripristino di un ambiente salvato con fesetenv può però cancellare i flag che non erano impostati nello stato salvato, senza una chiamata separata a feclearexcept. FE_ALL_EXCEPT combina con | tutte le eccezioni supportate; vale 0 se non ce ne sono. Usare feclearexcept e fetestexcept.
FE_DOWNWARD arrotonda verso −∞, FE_UPWARD verso +∞, FE_TOWARDZERO verso zero e FE_TONEAREST al valore più vicino. FE_TONEARESTFROMZERO arrotonda al valore più vicino e, se due valori sono equidistanti, sceglie quello più lontano da zero. Per FE_TONEAREST, le disposizioni dell’allegato F che collegano C a IEC 60559 garantiscono l’arrotondamento al valore pari in caso di equidistanza. La sola presenza della macro non garantisce questa regola. Le macro per le singole eccezioni e direzioni esistono solo se supportate; verificare con #ifdef. fegetround legge la direzione dinamica, fesetround la imposta.
FE_DFL_ENV designa l’ambiente predefinito per fesetenv; FE_DFL_MODE designa le modalità predefinite per fesetmode, senza ripristinare i flag. FE_DYNAMIC è un token per #pragma STDC FENV_ROUND FE_DYNAMIC, che seleziona l’arrotondamento dinamico; non è un argomento di fesetround.
Usare #pragma STDC FENV_ACCESS ON quando si verificano i flag o si usano modalità dinamiche non predefinite. Verificare i risultati delle operazioni e ripristinare lo stato salvato. La sola selezione di C23 nel compilatore di un repository non attesta il supporto nell’ambiente di produzione.
Esempi
#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;
}Risultato
flags clear
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.