NOM¶

ilogb, ilogbf, ilogbl - Obtenir l'exposant entier d'un nombre en virgule flottante

BIBLIOTHÈQUE¶

Bibliothèque de math (libm, -lm)

SYNOPSIS¶

#include <math.h>

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

ilogb() :

    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L


        || _XOPEN_SOURCE >= 500


        || /* Depuis la glibc 2.19 : */ _DEFAULT_SOURCE


        || /* glibc <= 2.19 : */ _BSD_SOURCE || _SVID_SOURCE

ilogbf(), ilogbl() :

    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L


        || /* Depuis la glibc 2.19 : */ _DEFAULT_SOURCE


        || /* glibc <= 2.19 : */ _BSD_SOURCE || _SVID_SOURCE

DESCRIPTION¶

Ces fonctions renvoient l'exposant de leur argument sous forme d'entier signé. Si aucune erreur ne se produit, ces fonctions sont équivalentes aux fonctions logb(3) avec un transtypage vers le type int.

VALEUR RENVOYÉE¶

En cas de succès, ces fonctions renvoient l'exposant de x sous forme d'entier signé.

Si x est nul, cela cause une erreur d'intervalle et les fonctions renvoient FP_ILOGB0.

Si x n'est pas un nombre (NaN), cela cause une erreur d'intervalle et les fonctions renvoient FP_ILOGBNAN.

Si x est l'infini négatif ou positif, cela cause une erreur d'intervalle et les fonctions renvoient INT_MAX.

ERREURS¶

Voir math_error(7) pour savoir comment déterminer si une erreur s'est produite lors de l'appel d'une de ces fonctions.

Les erreurs suivantes peuvent se produire :

Erreur d'intervalle : x est nul ou n'est pas un nombre (NaN)

Une exception indiquant une virgule flottante incorrecte (FE_INVALID) est levée et errno est positionné sur EDOM (mais voir les BOGUES).

Erreur de domaine : x est une valeur infinie

Une exception indiquant une virgule flottante incorrecte (FE_INVALID) est levée et errno est positionné sur EDOM (mais voir les BOGUES).

ATTRIBUTS¶

Pour une explication des termes utilisés dans cette section, consulter attributes(7).

STANDARDS¶

C11, POSIX.1-2008.

HISTORIQUE¶

C99, POSIX.1-2001.

BOGUES¶

Avant la glibc 2.16, les bogues suivants existaient dans l'implémentation de ces fonctions dans la glibc :

• Le cas de l'erreur d’intervalle où x vaut 0 ou un NaN ne positionnait pas errno ou (sur certaines architectures) levait une exception de virgule flottante.
• Le cas de l'erreur d’intervalle où x est infini ne positionnait pas errno ou levait une exception de virgule flottante.

VOIR AUSSI¶

log(3), logb(3), significand(3)

TRADUCTION¶

La traduction française de cette page de manuel a été créée par Christophe Blaess <https://www.blaess.fr/christophe/>, Stéphan Rafin <stephan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>, François Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe Guérard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas Huriaux <thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centraliens.net>, Florentin Duneau <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-bretagne.fr>, Denis Barbier <barbier@debian.org>, David Prévot <david@tilapin.org>, Cédric Boutillier <cedric.boutillier@gmail.com> et Jean-Philippe MENGUAL <jpmengual@debian.org>

Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à debian-l10n-french@lists.debian.org.