fma

NOM

fma, fmaf, fmal - Multiplication et addition en virgule flottante

BIBLIOTHÈQUE

Bibliothèque de math ( libm, -lm)

SYNOPSIS

#include <math.h>

double fma(double x, double y, double z);
float fmaf(float x, float y, float z);
long double fmal(long double x, long double y, long double z);

fma(), fmaf(), fmal() :

    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L

DESCRIPTION

Ces fonctions calculent x * y + z. Le résultat est arrondi à la fin suivant le mode d'arrondi (consultez fenv(3)).

VALEUR RENVOYÉE

Ces fonctions renvoient la valeur de x * y + z, arrondie comme une seule opération ternaire. Si x ou y n’est pas un nombre, un NaN est renvoyé. Si x fois y est exactement un infini et z est un infini de signe opposé, une erreur de domaine se produit et NaN est renvoyé. Si x ou y est une valeur infinie et si l'autre vaut 0 et si z n'est pas un NaN, une erreur de domaine est produite et un NaN est renvoyé. Si x ou y est une valeur infinie et si l'autre vaut 0 et si z est un NaN, une erreur de domaine est produite et un NaN est renvoyé. Si x fois y n'est pas une valeur infinie fois zéro (ou vice versa) et si z est un NaN, un NaN est renvoyé. En cas de dépassement pour le résultat, une erreur d'intervalle se produit et un infini du bon signe est renvoyé. En cas de soupassement (« underflow ») du résultat, une erreur d'intervalle se produit et un zéro signé 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 domaine : x * y + z ou x * y n'est pas correct et z n'est pas un NaN

Une exception indiquant une virgule flottante non valable (FE_INVALID) est levée.

Erreur de plage : débordement du résultat

Une exception de dépassement de virgule flottante (FE_OVERFLOW) est levée.

Erreur d'intervalle : dépassement par le bas du résultat

Une exception en virgule flottante de dépassement par le bas ( FE_UNDERFLOW) est levée.

Ces fonctions n'affectent pas de valeur à errno.

VERSIONS

Ces fonctions ont été ajoutées dans la glibc 2.1.

ATTRIBUTS

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

Interface	Attribut	Valeur
fma(), fmaf(), fmal()	Sécurité des threads	MT-Safe

STANDARDS

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

VOIR AUSSI

remainder(3), remquo(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 <[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]