Enum Supplied 

#[non_exhaustive]
pub enum Supplied<T> {
    Absent,
    Decoded(T),
    Undecoded,
}

What OANDA actually supplied for an optional contract field.

A provider that sent nothing, a value this client decoded, and a value this client could not decode are three different facts. Collapsing the last two into absence would report evidence OANDA did send as evidence it never sent, so a caller reconciling a rejected mutation could not tell a body it has already accounted for from a body it is missing.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Absent

OANDA sent no value for this field. A body (or field) that arrived empty — only whitespace — is the same fact: nothing was sent to read.

Decoded(T)

OANDA sent a value that matched the documented shape.

Undecoded

OANDA sent a non-empty value that did not match the documented shape.

Implementations

impl<T> Supplied<T>

pub fn is_absent(&self) -> bool

Whether OANDA sent no value at all.

pub fn is_undecoded(&self) -> bool

Whether OANDA sent a value this client could not decode.

pub fn decoded(&self) -> Option<&T>

The decoded value, when OANDA sent one this client could read.

Trait Implementations

impl<T: Clone> Clone for Supplied<T>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for Supplied<T>

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

Formats the value using the given formatter.

impl<T: PartialEq> PartialEq for Supplied<T>

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

Equality operator ==.

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

Inequality operator !=.

impl<T: PartialEq> StructuralPartialEq for Supplied<T>