logb

Section: C Library Functions (3)
Updated: 5 février 2023
Index Return to Main Contents

NOM

logb, logbf, logbl - Obtenir l'exposant d'un nombre à virgule flottante

BIBLIOTHÈQUE

Bibliothèque de math (libm, -lm)

SYNOPSIS

#include <math.h>

double logb(double x);
float logbf(float x);
long double logbl(long double x);

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

logb() :

    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
        || _XOPEN_SOURCE >= 500
        || /* Depuis la glibc 2.19 : */ _DEFAULT_SOURCE
        || /* Versions <= 2.19 de la glibc : */ _BSD_SOURCE || _SVID_SOURCE

logbf(), logbl() :

    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
        || /* Depuis la glibc 2.19 : */ _DEFAULT_SOURCE
        || /* glibc <= 2.19 : */ _BSD_SOURCE || _SVID_SOURCE

DESCRIPTION

Ces fonctions extraient l'exposant de la représentation interne en virgule flottante de x et le renvoie sous forme de nombre en virgule flottante. La constante entière FLT_RADIX, définie dans <float.h>, indique la base utilisée pour la représentation des nombres en virgule flottante du système. Si FLT_RADIX vaut 2, alors logb(x) est équivalent à floor(log2(x)) et elle est probablement plus rapide.

Si x est dénormalisé, logb() renvoie l'exposant x comme s'il était normalisé.

VALEUR RENVOYÉE

En cas de réussite, ces fonctions renvoient l'exposant de x.

Si x n’est pas un nombre, un NaN est renvoyé.

Si x est zéro, une erreur de pôle se produit et les fonctions renvoient -HUGE_VAL, -HUGE_VALF ou -HUGE_VALL, respectivement.

Si x est l’infini positif ou négatif, l'infini positif est renvoyé.

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 de pôle : x est zéro: Une exception de division par zéro de virgule flottante (FE_DIVBYZERO) est levée.

Ces fonctions n'affectent pas de valeur à errno.

ATTRIBUTS

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

Interface	Attribut	Valeur
logb(), logbf(), logbl()	Sécurité des threads	MT-Safe

STANDARDS

C99, POSIX.1-2001, POSIX.1-2008.

VOIR AUSSI

ilogb(3), log(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> et Cédric Boutillier <cedric.boutillier@gmail.com>

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: 07:47:38 GMT, May 18, 2024