Namespaces
Variants

feholdexcept

From cppreference.net
< c ‎ | numeric ‎ | fenv
Défini dans l'en-tête <fenv.h>
int feholdexcept ( fenv_t * envp ) ;
(depuis C99)

D'abord, sauvegarde l'environnement de virgule flottante actuel dans l'objet pointé par envp (similaire à fegetenv ), puis efface tous les indicateurs d'état de virgule flottante, et enfin installe le mode non-stop : les futures exceptions de virgule flottante n'interrompront pas l'exécution (ne déclencheront pas de trap), jusqu'à ce que l'environnement de virgule flottante soit restauré par feupdateenv ou fesetenv .

Cette fonction peut être utilisée au début d'une sous-routine qui doit masquer les exceptions en virgule flottante qu'elle pourrait déclencher vis-à-vis de l'appelant. Si seules certaines exceptions doivent être supprimées, tandis que d'autres doivent être signalées, le mode non-stop est généralement terminé par un appel à feupdateenv après avoir effacé les exceptions non souhaitées.

Table des matières

Paramètres

envp - pointeur vers l'objet de type fenv_t où l'environnement à virgule flottante sera stocké

Valeur de retour

0 en cas de succès, valeur non nulle sinon.

Exemple

#include <stdio.h>
#include <fenv.h>
#include <float.h>
#pragma STDC FENV_ACCESS ON
void show_fe_exceptions(void)
{
    printf("current exceptions raised: ");
    if(fetestexcept(FE_DIVBYZERO))     printf(" FE_DIVBYZERO");
    if(fetestexcept(FE_INEXACT))       printf(" FE_INEXACT");
    if(fetestexcept(FE_INVALID))       printf(" FE_INVALID");
    if(fetestexcept(FE_OVERFLOW))      printf(" FE_OVERFLOW");
    if(fetestexcept(FE_UNDERFLOW))     printf(" FE_UNDERFLOW");
    if(fetestexcept(FE_ALL_EXCEPT)==0) printf(" none");
    printf("\n");
}
double x2 (double x)   /* times two */
{
    fenv_t curr_excepts;
    /* Save and clear current f-p environment. */
    feholdexcept(&curr_excepts);
    /* Raise inexact and overflow exceptions. */
    printf("In x2():  x = %f\n", x=x*2.0);
    show_fe_exceptions();
    feclearexcept(FE_INEXACT);   /* hide inexact exception from caller */
    /* Merge caller's exceptions (FE_INVALID)        */
    /* with remaining x2's exceptions (FE_OVERFLOW). */
    feupdateenv(&curr_excepts);
    return x;
}
int main(void)
{    
    feclearexcept(FE_ALL_EXCEPT);
    feraiseexcept(FE_INVALID);   /* some computation with invalid argument */
    show_fe_exceptions();
    printf("x2(DBL_MAX) = %f\n", x2(DBL_MAX));
    show_fe_exceptions();
    return 0;
}

Sortie :

current exceptions raised:  FE_INVALID
In x2():  x = inf
current exceptions raised:  FE_INEXACT FE_OVERFLOW
x2(DBL_MAX) = inf
current exceptions raised:  FE_INVALID FE_OVERFLOW

Références

  • Norme C11 (ISO/CEI 9899:2011) :
  • 7.6.4.2 La fonction feholdexcept (p: 213-214)
  • Norme C99 (ISO/CEI 9899:1999) :
  • 7.6.4.2 La fonction feholdexcept (p: 194-195)

Voir aussi

restaure l'environnement à virgule flottante et lève les exceptions précédemment levées
(fonction)
sauvegarde ou restaure l'environnement à virgule flottante actuel
(fonction)
environnement à virgule flottante par défaut
(constante macro)
Documentation C++ pour feholdexcept