Struct sudoku_backend::ops::constraints::HexString

pub struct HexString<P: StringLength>(pub String, pub PhantomData<P>);

Require that the string be hexadecimal and of the specified width.

The error type can be deconstructed as:

• Some(Some(len)) ⇒ supplied string has invalid length
• Some(None) ⇒ supplied string contains non-hexadecimal characters
• None ⇒ supplied string coudln't be decoded

Examples

#[derive(Debug, Clone, Hash, PartialEq, Eq, PartialOrd, Ord)]
pub struct TestLength;

impl StringLength for TestLength {
    const LENGTH: usize = 8;
}

assert_eq!(HexString::<TestLength>::from_str("0a1B3c4D"),
           Ok(HexString("0a1B3c4D".to_string(), PhantomData)));

assert!(HexString::<TestLength>::from_str("0a1B3c4").is_err());
assert!(HexString::<TestLength>::from_str("0a1B3c4D5").is_err());
assert!(HexString::<TestLength>::from_str("Давай по").is_err());

Trait Implementations

impl<P: PartialEq + StringLength> PartialEq<HexString<P>> for HexString<P>

fn eq(&self, other: &HexString<P>) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &HexString<P>) -> bool

This method tests for !=.

impl<P: Clone + StringLength> Clone for HexString<P>

fn clone(&self) -> HexString<P>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<P: Ord + StringLength> Ord for HexString<P>

fn cmp(&self, other: &HexString<P>) -> Ordering

This method returns an Ordering between self and other.

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

Compares and returns the maximum of two values.

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

Compares and returns the minimum of two values.

impl<P: Eq + StringLength> Eq for HexString<P>

impl<P: PartialOrd + StringLength> PartialOrd<HexString<P>> for HexString<P>

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

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

fn lt(&self, other: &HexString<P>) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &HexString<P>) -> bool

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

fn gt(&self, other: &HexString<P>) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &HexString<P>) -> bool

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

impl<P: Debug + StringLength> Debug for HexString<P>

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

Formats the value using the given formatter.

impl<P: StringLength> FromStr for HexString<P>

type Err = Self::Error

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

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

impl<P: Hash + StringLength> Hash for HexString<P>

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

Feeds this value into the given [Hasher].

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

Feeds a slice of this type into the given [Hasher].

impl<P: StringLength> Serialize for HexString<P>

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where     __S: Serializer,

Serialize this value into the given Serde serializer.

impl<'de, P: StringLength> Deserialize<'de> for HexString<P>

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where     __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'v, P: StringLength> FromFormValue<'v> for HexString<P>

type Error = Option<Option<usize>>

The associated error which can be returned from parsing. It is a good idea to have the return type be or contain an &'v str so that the unparseable string can be examined after a bad parse.

fn from_form_value(form_value: &'v RawStr) -> Result<Self, Self::Error>

Parses an instance of Self from an HTTP form field value or returns an Error if one cannot be parsed.

fn default() -> Option<Self>

Returns a default value to be used when the form field does not exist. If this returns None, then the field is required. Otherwise, this should return Some(default_value). The default implementation simply returns None.