FMA(3)

ИМЯ
fma, fmaf, fmal - умножение и сложение чисел с плавающей запятой

ОБЗОР
#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);

Компонуется при указании параметра -lm.

Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):

fma(), fmaf(), fmal():
    _XOPEN_SOURCE >= 600 || _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L;
    или cc -std=c99

ОПИСАНИЕ
Функция fma() вычисляет x * y + z. Результат округляется как единая тернарная операция согласно текущему режиму округления (смотрите fenv(3)).

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
Данные функции возвращают результат x * y + z, округлённый как для единой тернарной операции. Если x или y равно NaN, то будет возвращено NaN. Если x умноженное на y стремится к бесконечности и значение z равно минус бесконечности, то будет сгенерирована ошибка выхода за пределы области, а в качестве результата будет возвращено NaN. Если x или y равно бесконечности, не равно 0 и z не равно NaN, то будет сгенерирована ошибка выхода за пределы области, а в качестве результата будет возвращено NaN. Если x или y равно бесконечности, не равно 0, а z равно NaN, то будет сгенерирована ошибка выхода за пределы области, а в качестве результата будет возвращено NaN. Если x умноженное на y не равно бесконечности умноженной на 0 (или наоборот) и значение z равно NaN, то будет возвращено NaN. Если происходит переполнение результата, возникает ошибка диапазона, и возвращается бесконечность с математически правильным знаком. Если в результате исчезает порядок числа, возникает ошибка диапазона и возвращается ноль со знаком.

ОШИБКИ
Смотрите math_error(7), чтобы определить, какие ошибки могут возникать при вызове этих функций.

Могут возникать следующие ошибки:

Ошибка области: x * y + z или x * y некорректно и z не равно NaN
    Возникает исключение неправильной плавающей запятой (FE_INVALID).

Ошибка диапазона: результат превысил разрядность
    Вызывается исключение переполнения плавающей точки (FE_OVERFLOW).

Ошибка диапазона: результат потерял разрядность
    Возникает исключение исчезновение порядка плавающей запятой (FE_UNDERFLOW).

Эти функции не изменяют errno.

ВЕРСИИ
Эти функции впервые появились в glibc 2.1.

АТРИБУТЫ
Описание терминов данного раздела смотрите в attributes(7).
Интерфейс | Атрибут | Значение
fma(), fmaf(), fmal() | безвредность в нитях | безвредно (MT-Safe)

СООТВЕТСТВИЕ СТАНДАРТАМ
C99, POSIX.1-2001.

СМОТРИТЕ ТАКЖЕ
remainder(3), remquo(3)