ldexp(3)

NOM
ldexp, ldexpf, ldexpl - Multiplier un nombre réel par une puissance de 2

BIBLIOTHÈQUE
Bibliothèque de math (libm, -lm)

SYNOPSIS
#include <math.h>

double ldexp(double x, int exp);
float ldexpf(float x, int exp);
long double ldexpl(long double x, int exp);

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

ldexpf(), ldexpl() :
    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
        || /* Depuis la glibc 2.19 : */ _DEFAULT_SOURCE
        || /* glibc <= 2.19 : */ _BSD_SOURCE || _SVID_SOURCE

DESCRIPTION
Ces fonctions renvoient le résultat de la multiplication du nombre à virgule flottante x par 2 élevé à la puissance exp.

VALEUR RENVOYÉE
En cas de réussite, ces fonctions renvoient x * (2^exp).

Si exp est nul, alors x est renvoyé.

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

Si x est l'infini positif (l'infini négatif), l'infini positif (l'infini négatif) est renvoyé.

En cas de dépassement par le bas du résultat, une erreur d'intervalle se produit et zéro est renvoyé.

En cas de dépassement pour le résultat, une erreur d'intervalle se produit et les fonctions renvoient HUGE_VAL, HUGE_VALF ou HUGE_VALL, resp. avec le même signe que x.

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, dépassement par le haut
    errno est configurée à ERANGE. Une exception de dépassement par le haut de virgule flottante (FE_OVERFLOW) est levée.

Erreur d'intervalle, dépassement par le bas
    errno prend la valeur ERANGE. Une exception de dépassement par le bas de virgule flottante (FE_UNDERFLOW) est levée.

ATTRIBUTS
Pour une explication des termes utilisés dans cette section, consulter attributes(7).
Interface | Attribut | Valeur
ldexp(), ldexpf(), ldexpl() | Sécurité des threads | MT-Safe

STANDARDS
C11, POSIX.1-2008.

HISTORIQUE
C99, POSIX.1-2001.

La variante renvoyant double est également conforme à SVr4, 4.3BSD et C89.

VOIR AUSSI
frexp(3), modf(3), scalbln(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 (https://www.gnu.org/licenses/gpl-3.0.html) 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.