ilogb

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);

Exigences de macros de test de fonctionnalités pour la glibc (consulter feature_test_macros(7)) :

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).

Interface	Attribut	Valeur
ilogb(), ilogbf(), ilogbl()	Sécurité des threads	MT-Safe

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 à

This document was created by man2html, using the manual pages.
Time: 05:06:17 GMT, September 19, 2025