Struct Mismatch

pub struct Mismatch<N, H> {
    pub need: N,
    pub have: H,
    pub info: &'static str,
}

Represents a mismatch between an expected need and an encountered have.

With optional contextual information in the info field.

This struct conveys optional information about the anticipated need and the observed have, allowing for either, both, or none to be specified.

It can be particularly useful for error handling and reporting.

Fields

need: N

Information about something that was needed, expected or anticipated.

have: H

Information about something that was obtained, observed, or encountered.

info: &'static str

Contextual static information about the mismatch.

Implementations

impl<N, H> Mismatch<N, H>

pub const fn new(need: N, have: H) -> Self

Creates a new Mismatch with the specified need and have.

pub const fn with_info(need: N, have: H, info: &'static str) -> Self

Creates a new Mismatch with the specified need, have, and info.

impl<N, H> Mismatch<Interval<N>, H>

pub fn in_point_interval(need_point: N, have: H, info: &'static str) -> Self

where N: Clone,

Creates a mismatch where need is an Interval::point, and have does not match.

pub fn in_empty_interval(have: H, info: &'static str) -> Self

where N: Default,

Creates a mismatch where need is an Interval::empty, but have was provided.

pub const fn in_empty_const_interval(have: H, info: &'static str) -> Self

where N: ConstDefault,

Creates a mismatch where need is an Interval::empty_const, but have was provided.

pub fn in_empty_interval_with(value: N, have: H, info: &'static str) -> Self

where N: Clone,

Creates a mismatch where need is an Interval::empty_with, but have was provided.

pub const fn in_closed_interval( lower: N, upper: N, have: H, info: &'static str, ) -> Self

Creates a mismatch where need is an Interval::closed, and have is outside it.

pub const fn in_closed_open_interval( lower: N, upper: N, have: H, info: &'static str, ) -> Self

Creates a mismatch where need is an Interval::closed_open, and have is outside it.

pub const fn in_open_interval( lower: N, upper: N, have: H, info: &'static str, ) -> Self

Creates a mismatch where need is an Interval::open, and have is outside it.

Trait Implementations

impl<N: Clone, H: Clone> Clone for Mismatch<N, H>

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<N: ConstDefault, H: ConstDefault> ConstDefault for Mismatch<N, H>

const DEFAULT: Self

Returns a const default Mismatch.

impl<N: Debug, H: Debug> Debug for Mismatch<N, H>

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

Formats the value using the given formatter.

impl<N: Default, H: Default> Default for Mismatch<N, H>

fn default() -> Self

Returns a default Mismatch.

impl<N: Display, H: Display> Display for Mismatch<N, H>

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

Formats the value using the given formatter.

impl<N: Hash, H: Hash> Hash for Mismatch<N, H>

fn hash<HR: Hasher>(&self, state: &mut HR)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<N: Ord, H: Ord> Ord for Mismatch<N, H>

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

Compare need first. If they are equal, then compare have.

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<N: PartialEq, H: PartialEq> PartialEq for Mismatch<N, H>

fn eq(&self, other: &Self) -> 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<N: PartialOrd, H: PartialOrd> PartialOrd for Mismatch<N, H>

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

Compare need first. If they are equal, then compare have.

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<N: Copy, H: Copy> Copy for Mismatch<N, H>

impl<N: Eq, H: Eq> Eq for Mismatch<N, H>