NOM

       scalb,  scalbf,  scalbl  -  Multiplier  un nombre en virgule flottante par un entier puissance d'une base
       (OBSOLÈTE)

SYNOPSIS

       #include <math.h>

       double scalb(double x, double exp);
       float scalbf(float x, float exp);
       long double scalbl(long double x, long double exp);

       Éditer les liens avec -lm.

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

       scalb() :
           _XOPEN_SOURCE >= 500
               || /* Since glibc 2.19: */ _DEFAULT_SOURCE
               || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
       scalbf(), scalbl() :
           _XOPEN_SOURCE >= 600
               || /* Since glibc 2.19: */ _DEFAULT_SOURCE
               || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

DESCRIPTION

       Ces fonctions multiplient leur premier paramètre x par FLT_RADIX (probablement 2)  à  la  puissance  exp,
       c'est-à-dire :

           x * FLT_RADIX ** exp

       La définition de FLT_RADIX peut être obtenue en incluant <float.h>.

VALEUR RENVOYÉE

       En cas de réussite, ces fonctions renvoient x * FLT_RADIX ** exp.

       Si x ou exp est un NaN, un NaN est renvoyé.

       Si  x  est  une  valeur  infinie  positive (resp. négative) et exp n'est pas une valeur infinie négative,
       l'infini positif (resp. négatif) est renvoyé.

       Si x vaut +0 (resp. -0) et exp n'est pas l'infini positif, +0 (resp. -0) est renvoyé.

       Si x est nul et exp est l'infini positif, une erreur de domaine se produit et un NaN est renvoyé.

       Si x est infini et exp est l'infini négatif, une erreur de domaine se produit et un NaN 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.

       En  cas  de  soupassement  (« underflow »), une erreur d'intervalle se produit et les fonctions renvoient
       zéro 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 de domaine : x est nul et exp est l'infini positif, ou x est l'infini positif et exp est l'infini
       négatif et l'autre paramètre n'est pas un NaN.
              errno prend la valeur EDOM. Une exception de virgule flottante non valable (FE_INVALID) est levée.

       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  │
       ├──────────────────────────────┼──────────────────────┼─────────┤
       │ scalb(), scalbf(), scalbl()  │ Sécurité des threads │ MT-Safe │
       └──────────────────────────────┴──────────────────────┴─────────┘

CONFORMITÉ

       scalb()  est  spécifiée  dans  POSIX.1-2001,  mais marquée comme étant obsolète. POSIX.1-2008 supprime la
       spécification de scalb(), en recommandant d'utiliser scalbln(3), scalblnf(3) ou scalblnl(3) à  la  place.
       La fonction scalb() provient de BSD 4.3.

       scalbf() et scalbl() ne sont pas standard ; scalbf() est cependant présent dans certains autres système.

BOGUES

       Before glibc 2.20, these functions did not set errno for domain and range errors.

VOIR AUSSI

       ldexp(3), scalbln(3)

COLOPHON

       Cette page fait partie de la publication 5.10 du projet man-pages Linux. Une description du projet et des
       instructions  pour  signaler  des  anomalies et la dernière version de cette page peuvent être trouvées à
       l'adresse https://www.kernel.org/doc/man-pages/.

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  à
       debian-l10n-french@lists.debian.org.

                                                   9 juin 2020                                          SCALB(3)