MulAdd in num_traits::ops::mul_add - Rust
Description: Fused multiply-add. Computes `(self * a) + b` with only one rounding error, yielding a more accurate result than an unfused multiply-add.
Keywords: rust, rustlang, rust-lang, MulAdd

# Trait num_traits::ops::mul_add::MulAdd

source ·

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

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

Expand description

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§

source

#### type Output

The resulting type after applying the fused multiply-add.

## Required Methods§

source

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

Performs the fused multiply-add operation.

## Implementations on Foreign Types§

source§

### impl MulAdd<f32, f32> for f32

§

#### type Output = f32

source§

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

source§

### impl MulAdd<f64, f64> for f64

§

#### type Output = f64

source§

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

source§

### impl MulAdd<isize, isize> for isize

§

#### type Output = isize

source§

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

source§

### impl MulAdd<usize, usize> for usize

§

#### type Output = usize

source§

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

source§

### impl MulAdd<i8, i8> for i8

§

#### type Output = i8

source§

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

source§

### impl MulAdd<u8, u8> for u8

§

#### type Output = u8

source§

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

source§

### impl MulAdd<i16, i16> for i16

§

#### type Output = i16

source§

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

source§

### impl MulAdd<u16, u16> for u16

§

#### type Output = u16

source§

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

source§

### impl MulAdd<i32, i32> for i32

§

#### type Output = i32

source§

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

source§

### impl MulAdd<u32, u32> for u32

§

#### type Output = u32

source§

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

source§

### impl MulAdd<i64, i64> for i64

§

#### type Output = i64

source§

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

source§

### impl MulAdd<u64, u64> for u64

§

#### type Output = u64

source§

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

source§

### impl MulAdd<i128, i128> for i128

§

#### type Output = i128

source§

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

source§

### impl MulAdd<u128, u128> for u128

§

#### type Output = u128

source§

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

## Implementors§