scalbn, scalbnf, scalbnl, scalbln, scalblnf, scalblnl - Multiplier un nombre en
virgule flottante par un entier puissance d'une base
Bibliothèque de math (
libm,
-lm)
#include <math.h>
double scalbln(double x, long exp);
float scalblnf(float x, long exp);
long double scalblnl(long double x, long exp);
double scalbn(double x, int exp);
float scalbnf(float x, int exp);
long double scalbnl(long double x, int exp);
scalbln(),
scalblnf(),
scalblnl() :
_ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
|| /* Depuis la glibc 2.19 : */ _DEFAULT_SOURCE
scalbn(),
scalbnf(),
scalbnl() :
_ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
|| /* Depuis la glibc 2.19 : */ _DEFAULT_SOURCE
|| /* glibc <= 2.19 : */ _BSD_SOURCE || _SVID_SOURCE
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>.
En cas de réussite, ces fonctions renvoient
x *
FLT_RADIX
**
exp.
Si
x n’est pas un nombre, un
NaN est
renvoyé.
Si
x est une valeur infinie positive (resp. négative), une valeur
infinie positive est renvoyée (resp. négative).
Si
x est +0 (-0),
+0 (
-0) 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.
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
- Une exception de dépassement 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.
Ces fonctions ont été ajoutées dans la glibc 2.1.
Pour une explication des termes utilisés dans cette section, consulter
attributes(7).
| Interface |
Attribut |
Valeur |
|
scalbn(), scalbnf(), scalbnl(), scalbln(),
scalblnf(), scalblnl() |
Sécurité des threads |
MT-Safe |
C99, POSIX.1-2001, POSIX.1-2008.
Ces fonctions diffèrent des fonctions obsolètes décrites
dans
scalb(3) par le type de leur deuxième paramètre. Les
fonctions décrites sur cette page ont un deuxième
paramètre de type entier, tandis que celle de
scalb(3) ont un
deuxième paramètre de type
double.
Si
FLT_RADIX vaut 2 (ce qui est le cas en général), alors
scalbn() est équivalent à
ldexp(3).
Avant la glibc 2.20, Ces fonctions ne positionnaient pas
errno
pour les erreurs d'intervalle.
ldexp(3),
scalb(3)
La traduction française de cette page de manuel a été
créée par Christophe Blaess
<
https://www.blaess.fr/christophe/>, Stéphan Rafin
<
[email protected]>, Thierry Vignaud
<
[email protected]>, François Micaux, Alain Portal
<
[email protected]>, Jean-Philippe Guérard
<
[email protected]>, Jean-Luc Coulon (f5ibh)
<
[email protected]>, Julien Cristau
<
[email protected]>, Thomas Huriaux <
[email protected]>,
Nicolas François <
[email protected]>, Florentin
Duneau <
[email protected]>, Simon Paillard
<
[email protected]>, Denis Barbier
<
[email protected]>, David Prévot <
[email protected]> et
Cédric Boutillier <
[email protected]>
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 à
[email protected]