fma

Section: C Library Functions (3)
Updated: 15 décembre 2022
Index Return to Main Contents

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);

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

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 <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 à

This document was created by man2html, using the manual pages.
Time: 05:40:46 GMT, May 18, 2024