Trait num_traits::ops::mul_add::MulAdd

pub trait MulAdd<A = Self, B = Self> {
    type Output;

    fn mul_add(self, a: A, b: B) -> Self::Output;
}

Fused multiply-add. Computes (self * a) + b with only one rounding error, yielding a more accurate result than an unfused multiply-add.

Using mul_add can be more performant than an unfused multiply-add if the target architecture has a dedicated fma CPU instruction.

Note that A and B are Self by default, but this is not mandatory.

Example

use std::f32;

let m = 10.0_f32;
let x = 4.0_f32;
let b = 60.0_f32;

// 100.0
let abs_difference = (m.mul_add(x, b) - (m*x + b)).abs();

assert!(abs_difference <= 100.0 * f32::EPSILON);

Required Associated Types

type Output

The resulting type after applying the fused multiply-add.

Required Methods

fn mul_add(self, a: A, b: B) -> Self::Output

Performs the fused multiply-add operation.

Implementations on Foreign Types

impl MulAdd<f32, f32> for f32

type Output = f32

fn mul_add(self, a: Self, b: Self) -> Self::Output

impl MulAdd<f64, f64> for f64

type Output = f64

fn mul_add(self, a: Self, b: Self) -> Self::Output

impl MulAdd<isize, isize> for isize

type Output = isize

fn mul_add(self, a: Self, b: Self) -> Self::Output

impl MulAdd<usize, usize> for usize

type Output = usize

fn mul_add(self, a: Self, b: Self) -> Self::Output

impl MulAdd<i8, i8> for i8

type Output = i8

fn mul_add(self, a: Self, b: Self) -> Self::Output

impl MulAdd<u8, u8> for u8

type Output = u8

fn mul_add(self, a: Self, b: Self) -> Self::Output

impl MulAdd<i16, i16> for i16

type Output = i16

fn mul_add(self, a: Self, b: Self) -> Self::Output

impl MulAdd<u16, u16> for u16

type Output = u16

fn mul_add(self, a: Self, b: Self) -> Self::Output

impl MulAdd<i32, i32> for i32

type Output = i32

fn mul_add(self, a: Self, b: Self) -> Self::Output

impl MulAdd<u32, u32> for u32

type Output = u32

fn mul_add(self, a: Self, b: Self) -> Self::Output

impl MulAdd<i64, i64> for i64

type Output = i64

fn mul_add(self, a: Self, b: Self) -> Self::Output

impl MulAdd<u64, u64> for u64

type Output = u64

fn mul_add(self, a: Self, b: Self) -> Self::Output

impl MulAdd<i128, i128> for i128

type Output = i128

fn mul_add(self, a: Self, b: Self) -> Self::Output

impl MulAdd<u128, u128> for u128

type Output = u128

fn mul_add(self, a: Self, b: Self) -> Self::Output

Implementors

impl<Frac, MulFrac: LeEqU8> MulAdd<FixedI8<MulFrac>, FixedI8<Frac>> for FixedI8<Frac>

impl<Frac, MulFrac: LeEqU16> MulAdd<FixedI16<MulFrac>, FixedI16<Frac>> for FixedI16<Frac>

impl<Frac, MulFrac: LeEqU32> MulAdd<FixedI32<MulFrac>, FixedI32<Frac>> for FixedI32<Frac>

impl<Frac, MulFrac: LeEqU64> MulAdd<FixedI64<MulFrac>, FixedI64<Frac>> for FixedI64<Frac>

impl<Frac, MulFrac: LeEqU128> MulAdd<FixedI128<MulFrac>, FixedI128<Frac>> for FixedI128<Frac>

impl<Frac, MulFrac: LeEqU8> MulAdd<FixedU8<MulFrac>, FixedU8<Frac>> for FixedU8<Frac>

impl<Frac, MulFrac: LeEqU16> MulAdd<FixedU16<MulFrac>, FixedU16<Frac>> for FixedU16<Frac>

impl<Frac, MulFrac: LeEqU32> MulAdd<FixedU32<MulFrac>, FixedU32<Frac>> for FixedU32<Frac>

impl<Frac, MulFrac: LeEqU64> MulAdd<FixedU64<MulFrac>, FixedU64<Frac>> for FixedU64<Frac>

impl<Frac, MulFrac: LeEqU128> MulAdd<FixedU128<MulFrac>, FixedU128<Frac>> for FixedU128<Frac>

impl<T: Clone + Num + MulAdd<Output = T>> MulAdd<Complex<T>, Complex<T>> for Complex<T>

impl<'a, 'b, T: Clone + Num + MulAdd<Output = T>> MulAdd<&'b Complex<T>, &'a Complex<T>> for &'a Complex<T>