Struct Lexical 

pub struct Lexical<T> { /* private fields */ }

Value with stable lexical representation.

Some value (such as date/time) can have multiple lexical representations. When dealing with externally generated data, it is sometime preferable to preserve the lexical representation we are provided with, even if it is not in canonical form.

This type is a wrapper around a value of type T that preserves any eventual lexical representation, found when deserializing (with Deserialize::deserialize) or parsing (with FromStr::from_str or str::parse).

Implementations

impl<T> Lexical<T>

pub fn new(value: T) -> Lexical<T>

Wraps a value without any particular lexical representation.

The fmt::Display or Serialize implementation of T will be used as lexical representation.

pub fn new_with_representation(value: T, representation: String) -> Lexical<T>

Wraps a value with the given lexical representation.

This representation will be used in the fmt::Display and Serialize implementations.

It is a logical error to provide a representation that is not a valid lexical representation of value.

pub fn from_parts(value: T, representation: Option<String>) -> Lexical<T>

Wraps a value with the given lexical optional representation.

If a representation is given, will be used in the fmt::Display and Serialize implementations. Otherwise the T implementation of those traits will be used.

It is a logical error to provide a representation that is not a valid lexical representation of value.

pub fn as_inner(&self) -> &T

Returns a reference to the inner value.

pub fn to_value(&self) -> T

where T: Clone,

Clones the inner value.

pub fn into_value(self) -> T

Returns ownership over the inner value.

pub fn into_parts(self) -> (T, Option<String>)

Breaks self into its constituting parts.

Trait Implementations

impl<T> Clone for Lexical<T>

where T: Clone,

fn clone(&self) -> Lexical<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T> Debug for Lexical<T>

where T: Debug,

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

Formats the value using the given formatter.

impl<T> Default for Lexical<T>

where T: Default,

fn default() -> Lexical<T>

Returns the “default value” for a type.

impl<T> Deref for Lexical<T>

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &<Lexical<T> as Deref>::Target

Dereferences the value.

impl<'de, T> Deserialize<'de> for Lexical<T>

where T: FromStr, <T as FromStr>::Err: Display,

fn deserialize<D>( deserializer: D, ) -> Result<Lexical<T>, <D as Deserializer<'de>>::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<T> Display for Lexical<T>

where T: Display,

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

Formats the value using the given formatter.

impl<T> From<T> for Lexical<T>

fn from(value: T) -> Lexical<T>

Converts to this type from the input type.

impl<T> FromStr for Lexical<T>

where T: FromStr,

type Err = <T as FromStr>::Err

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Lexical<T>, <Lexical<T> as FromStr>::Err>

Parses a string s to return a value of this type.

impl<T> Hash for Lexical<T>

where T: Hash,

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

where H: Hasher,

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<T> Ord for Lexical<T>

where T: Ord,

fn cmp(&self, other: &Lexical<T>) -> 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<T> PartialEq<T> for Lexical<T>

where T: PartialEq,

fn eq(&self, other: &T) -> 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<T> PartialEq for Lexical<T>

where T: PartialEq,

fn eq(&self, other: &Lexical<T>) -> 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<T> PartialOrd<T> for Lexical<T>

where T: PartialOrd,

fn partial_cmp(&self, other: &T) -> 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<T> PartialOrd for Lexical<T>

where T: PartialOrd,

fn partial_cmp(&self, other: &Lexical<T>) -> 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<T> Serialize for Lexical<T>

where T: Serialize,

fn serialize<S>( &self, serializer: S, ) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl<T> Eq for Lexical<T>

where T: Eq,