Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C

<fenv.h> — environnement en virgule flottante

L’en-tête <fenv.h> expose les indicateurs d’exception et les modes de contrôle en virgule flottante. Il permet d’examiner les conditions exceptionnelles, de modifier l’arrondi et de sauvegarder puis restaurer l’environnement d’un thread.

Version : C23; repository compiler flag, production runtime not attested

Syntaxe

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

<fenv.h> gère les indicateurs d’état et les modes de contrôle. fenv_t représente l’environnement dynamique complet, fexcept_t l’état des exceptions et femode_t les seuls modes de contrôle. L’environnement dynamique est propre au thread.

FE_DIVBYZERO désigne une division par zéro, FE_INVALID une opération invalide, FE_OVERFLOW un dépassement de capacité, FE_UNDERFLOW un sous-dépassement et FE_INEXACT un résultat inexact. Les opérations arithmétiques ordinaires n’effacent pas les indicateurs d’exception déjà actifs. En revanche, restaurer un environnement sauvegardé avec fesetenv peut effacer les indicateurs qui n’étaient pas actifs dans l’état sauvegardé, sans appel distinct à feclearexcept. FE_ALL_EXCEPT combine toutes les exceptions prises en charge avec | ; il vaut 0 si aucune n’existe. Utilisez feclearexcept et fetestexcept.

FE_DOWNWARD arrondit vers −∞, FE_UPWARD vers +∞, FE_TOWARDZERO vers zéro et FE_TONEAREST à la valeur la plus proche. FE_TONEARESTFROMZERO arrondit à la valeur la plus proche et, si deux valeurs sont à égale distance, choisit celle qui est la plus éloignée de zéro. Pour FE_TONEAREST, les dispositions de l’annexe F relatives à la liaison avec IEC 60559 garantissent l’arrondi au pair en cas d’égalité de distance. La seule présence de la macro ne garantit pas cette règle. Les macros correspondant aux exceptions et directions individuelles n’existent qu’en cas de prise en charge ; vérifiez avec #ifdef. fegetround lit la direction dynamique et fesetround la définit.

FE_DFL_ENV désigne l’environnement par défaut pour fesetenv ; FE_DFL_MODE désigne les modes par défaut pour fesetmode, sans restaurer les indicateurs. FE_DYNAMIC est un jeton pour #pragma STDC FENV_ROUND FE_DYNAMIC, qui sélectionne l’arrondi dynamique ; ce n’est pas un argument de fesetround.

Utilisez #pragma STDC FENV_ACCESS ON pour tester les indicateurs ou utiliser des modes dynamiques non par défaut. Vérifiez les résultats des opérations et restaurez l’état sauvegardé. Le seul fait de sélectionner C23 dans le compilateur d’un dépôt ne garantit pas la prise en charge dans l’environnement d’exécution de production.

Exemples

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

Résultat

flags clear

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources