Struct approx::Ulps

pub struct Ulps<A: ?Sized, B = A> where
    A: UlpsEq<B>,
    B: ?Sized,  {
    pub epsilon: A::Epsilon,
    pub max_ulps: u32,
}

The requisite parameters for testing for approximate equality using an ULPs based comparison.

This is not normally used directly, rather via the assert_ulps_{eq|ne}! and ulps_{eq|ne}! macros.

Example

use std::f64;
use approx::Ulps;

Ulps::default().eq(&1.0, &1.0);
Ulps::default().epsilon(f64::EPSILON).eq(&1.0, &1.0);
Ulps::default().max_ulps(4).eq(&1.0, &1.0);
Ulps::default().epsilon(f64::EPSILON).max_ulps(4).eq(&1.0, &1.0);
Ulps::default().max_ulps(4).epsilon(f64::EPSILON).eq(&1.0, &1.0);

Fields

epsilon: A::Epsilon

The tolerance to use when testing values that are close together.

max_ulps: u32

The ULPs to tolerate when testing values that are far-apart.

Implementations

impl<A: ?Sized, B> Ulps<A, B> where
    A: UlpsEq<B>,
    B: ?Sized, 

pub fn epsilon(self, epsilon: A::Epsilon) -> Ulps<A, B>

Replace the epsilon value with the one specified.

pub fn max_ulps(self, max_ulps: u32) -> Ulps<A, B>

Replace the max ulps value with the one specified.

pub fn eq(self, lhs: &A, rhs: &B) -> bool

Peform the equality comparison

pub fn ne(self, lhs: &A, rhs: &B) -> bool

Peform the inequality comparison

Trait Implementations

impl<A: ?Sized, B> Default for Ulps<A, B> where
    A: UlpsEq<B>,
    B: ?Sized, 

fn default() -> Ulps<A, B>

Returns the “default value” for a type.