Struct UnitIntervalOpen 

pub struct UnitIntervalOpen;

Marker type enforcing that a value lies in the open unit interval: 0 < x < 1.

Requires T: UnitBounds. We provide UnitBounds implementations for f32, f64, and uom::si::f64::Ratio.

You can construct a value constrained to (0, 1) using either the generic Constrained::new method or the convenient UnitIntervalOpen::new associated function.

Examples

Using with f64:

use twine_models::support::constraint::{Constrained, UnitIntervalOpen};

// Generic constructor:
let a = Constrained::<_, UnitIntervalOpen>::new(0.25).unwrap();
assert_eq!(a.into_inner(), 0.25);

// Associated constructor:
let b = UnitIntervalOpen::new(0.9).unwrap();
assert_eq!(b.as_ref(), &0.9);

// Error cases:
assert!(UnitIntervalOpen::new(0.0).is_err());
assert!(UnitIntervalOpen::new(1.0).is_err());
assert!(UnitIntervalOpen::new(f64::NAN).is_err());

Using with uom::si::f64::Ratio:

use twine_models::support::constraint::{Constrained, UnitIntervalOpen};
use uom::si::{f64::Ratio, ratio::{ratio, percent}};

let r = Constrained::<Ratio, UnitIntervalOpen>::new(Ratio::new::<ratio>(0.42)).unwrap();
assert_eq!(r.as_ref().get::<percent>(), 42.0);

Implementations

impl UnitIntervalOpen

pub fn new<T: UnitBounds>( value: T, ) -> Result<Constrained<T, UnitIntervalOpen>, ConstraintError>

Constructs Constrained<T, UnitIntervalOpen> if 0 < value < 1.

Errors

Fails if the value is outside the open unit interval:

• ConstraintError::BelowMinimum if less than or equal to zero.
• ConstraintError::AboveMaximum if greater than or equal to one.
• ConstraintError::NotANumber if comparison is undefined (e.g., NaN).

Trait Implementations

impl Clone for UnitIntervalOpen

fn clone(&self) -> UnitIntervalOpen

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: UnitBounds> Constraint<T> for UnitIntervalOpen

fn check(value: &T) -> Result<(), ConstraintError>

Checks that the given value satisfies this constraint.

impl Debug for UnitIntervalOpen

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Ord for UnitIntervalOpen

fn cmp(&self, other: &UnitIntervalOpen) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for UnitIntervalOpen

fn eq(&self, other: &UnitIntervalOpen) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for UnitIntervalOpen

fn partial_cmp(&self, other: &UnitIntervalOpen) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Copy for UnitIntervalOpen

impl Eq for UnitIntervalOpen

impl StructuralPartialEq for UnitIntervalOpen