ilogb, ilogbf, ilogbl − Récupérer l’exposant entier d’une valeur en virgule flottante.

#include <math.h>

int ilogb(double x);
int ilogbf(float x);
int ilogbl(long double x);

Lier avec −lm.

Ces fonctions renvoient la partie exposant de leur argument en tant qu’entier signé. Lorsqu’aucune erreur ne survient, ces fonctions sont équivalentes aux fonctions logb() correspondantes dont on a forcé le type (Ndt : cast) en entier. Une erreur surviendra pour zéro, l’infini, Nan et probablement pour un débordement.

Afin de vérifier si des erreurs surviennent, mettez zéro dans errno et appelez feclearexcept(FE_ALL_EXCEPT) avant d’appeler ces fonctions. Au retour, si errno n’est pas nul ou si fetestexcept(FE_INVALID | FE_DIVBYZERO | FE_OVERFLOW | FE_UNDERFLOW) n’est pas nul, c’est qu’une erreur est apparue.

Si une erreur survient et si (math_errhandling & MATH_ERRNO) n’est pas nul, alors errno est remplie avec EDOM. Si une erreur survient et si (math_errhandling & MATH_ERREXCEPT) n’est pas nul, c’est que l’exception virgule flottante non valide est apparue.

Une erreur de domaine survient lorsque x vaut zéro ou l’infini (ou trop grand, ou trop petit) ou NaN. Si x vaut zéro, la constante FP_ILOGB0 est renvoyée. Si x est NaN, la constante FP_ILOGBNAN est renvoyée. Si x est l’infini (ou trop grand), INT_MAX est renvoyé. Si x est trop petit, INT_MIN est renvoyé.

C99.

log(3), logb(3)

Ce document est une traduction réalisée par Alain Portal <aportal AT univ-montp2 DOT fr> le 12 mai 2006 et révisée le 14 août 2006.

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 ilogb ». N’hésitez pas à signaler à l’auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.