#include <fenv.h> int feclearexcept(int excepts);
int fegetexceptflag(fexcept_t *flagp, int excepts);
int feraiseexcept(int excepts);
int fesetexceptflag(const fexcept_t *flagp, int excepts);
int fetestexcept(int excepts); int fegetround(void);
int fesetround(int rounding_mode); int fegetenv(fenv_t *envp);
int feholdexcept(fenv_t *envp);
int fesetenv(const fenv_t *envp);
int feupdateenv(const fenv_t *envp);
L'exception « Overflow » se produit quand un résultat doit être représenté par un nombre en virgule flottante, mais que sa valeur absolue est trop grande pour être représentée par un nombre fini.
L'exception « Underflow » se produit quand un résultat doit être représenté par un nombre en virgule flottante, mais que sa valeur absolue est trop petite pour être représentée.
L'exception « Inexact » se produit quand le résultat arrondi d'une opération n'est pas égal au résultat en précision infinie. Elle peut se déclencher quand les exceptions « Overflown » ou « Underflow » se produisent.
L'exception « Invalid » se produit quand il n'y a pas de résultat bien défini pour une opération, comme « 0/0 » ou « infini-infini » ou « sqrt(-1) ».
Chacune des macros FE_DIVBYZERO, FE_INEXACT, FE_INVALID, FE_OVERFLOW, FE_UNDERFLOW est définie lorsque l'implémentation supporte la gestion de l'exception correspondante. Les bits sont alors définis, ainsi on peut appeler, par exemple, les fonctions de gestion des exceptions avec un argument entier FE_OVERFLOW|FE_UNDERFLOW. D'autres exceptions peuvent être supportées. La macro FE_ALL_EXCEPT est un masque regroupant par OU binaire tous les bits des exceptions supportées.
La fonction feclearexcept() efface les exceptions supportées représentées par les bits présents dans son argument.
La fonction fegetexceptflag() stocke une représentation de l'état des exceptions contenues dans son argument excepts dans l'objet opaque *flagp.
La fonction feraiseexcept() déclenche les exceptions supportées représentées par les bits de l'argument excepts.
La fonction fesetexceptflag() fixe l'état des exceptions représentées par l'argument excepts en employant la valeur *flagp. Cette dernière doit être le résultat d'un appel préalable à fegetexceptflag() avec un dernier argument contenant au moins tous les bits présents dans excepts.
La fonction fetestexcept() renvoie un mot dont les bits également présents dans l'argument excepts seront positionnés si l'exception correspondante est présente.
La fonction fegetround() renvoie la macro correspondant au mode d'arrondi en cours.
La fonction fesetround() définit le mode d'arrondi tel qu'il est spécifié par son argument et renvoie zéro lorsqu'elle réussit.
La fonction fegetenv() sauve l'environnement de travail en virgule flottante en cours dans l'objet *envp.
La fonction feholdexcept() effectue la même chose, puis efface tous les drapeaux d'exceptions, et bascule si possible sur un mode sans arrêt (continuer en présence d'exceptions). Elle renvoie zéro si elle réussit.
La fonction fesetenv() recharge l'environnement de travail en virgule flottante à partir de l'objet *envp. Cet objet doit être valide, c'est-à-dire être le résultat d'un appel à fegetenv(), de feholdexcept() ou égal à FE_DFL_ENV. Cet appel ne déclenche pas d'exception.
La fonction feupdateenv() installe l'environnement en virgule flottante représenté par l'objet *envp, sauf que les exceptions déjà déclenchées ne sont pas effacées. Après l'appel de cette fonction, les exceptions déclenchées seront un OU binaire entre l'ensemble précédent, et celui contenu dans *envp. Comme précédemment, l'objet *envp doit être valide.
#define _GNU_SOURCE
#include <fenv.h> int feenableexcept(int excepts);
int fedisableexcept(int excepts);
int fegetexcept(void);
Les fonctions feenableexcept() et fedisableexcept() activent (désactivent) les interceptions pour chaque exception représentée par excepts et renvoient l'ensemble précédent des exceptions activées lorsqu'elles réussissent, et -1 sinon. La fonction fegetexcept() renvoie l'ensemble des exceptions actuellement activées.
Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 31 août 2000 et révisée le 8 janvier 2008.
L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 3 fenv ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.
Dernière mise à jour : 17 juillet 2008