NOM

scalb, scalbf, scalbl - scale by an integer power of radix (OBSOLETE)

BIBLIOTHÈQUE

Bibliothèque de math (libm, -lm)

SYNOPSIS

#include <math.h>

[[deprecated]] double scalb(double x, double e);
[[deprecated]] float scalbf(float x, float e);
[[deprecated]] long double scalbl(long double x, long double e);

scalb() :

    _XOPEN_SOURCE >= 500
        || /* Depuis la glibc 2.19 : */ _DEFAULT_SOURCE
        || /* glibc <= 2.19 : */ _BSD_SOURCE || _SVID_SOURCE

scalbf(), scalbl() :

    _XOPEN_SOURCE >= 600
    || /* Depuis la glibc 2.19 : */ _DEFAULT_SOURCE
    || /* glibc <= 2.19 : */ _BSD_SOURCE || _SVID_SOURCE

DESCRIPTION

These functions multiply their first argument x by FLT_RADIX (probably 2) to the power of e, that is:

    x * FLT_RADIX ** e

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

VALEUR RENVOYÉE

On success, these functions return x * FLT_RADIX ** e.

If x or e is a NaN, a NaN is returned.

If x is positive infinity (negative infinity), and e is not negative infinity, positive infinity (negative infinity) is returned.

If x is +0 (-0), and e is not positive infinity, +0 (-0) is returned.

If x is zero, and e is positive infinity, a domain error occurs, and a NaN is returned.

If x is an infinity, and e is negative infinity, a domain error occurs, and a NaN is returned.

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 :

Domain error: x is 0, and e is positive infinity, or x is positive infinity and e is negative infinity and the other argument is not a 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).

STANDARDS

Aucun.

HISTORIQUE

scalb()

4.3BSD. Obsolète dans POSIX.1-2008 ; supprimé dans POSIX.1-2008, en recommandant d'utiliser scalbln(3), scalblnf(3) ou scalblnl(3) à la place.

BOGUES

Avant la glibc 2.20, Ces fonctions ne positionnaient pas errno pour les erreurs de domaine ou d'intervalle.

VOIR AUSSI

ldexp(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>, Cédric Boutillier <cedric.boutillier@gmail.com> et Jean-Pierre Giraud <jean-pierregiraud@neuf.fr>

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.