Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti