digit_sequence/
arrays.rs

1use crate::{CrateError, CrateResult, DigitSequence};
2
3/// [DigitSequence] can be created from an array of [u8], as long as
4/// the array contains only 0-9 digits or is empty; otherwise,
5/// the conversion results in a [CrateError::NonDigitNumber]:
6///
7/// ```
8/// use digit_sequence::*;
9///
10/// # fn main() -> GenericResult<()> {
11///
12/// let sequence: DigitSequence = [].try_into()?;
13/// assert_eq!(sequence, []);
14///
15/// let sequence: DigitSequence = [9, 2].try_into()?;
16/// assert_eq!(sequence, [9, 2]);
17///
18/// let result: CrateResult<DigitSequence> = [10].try_into();
19/// assert_eq!(result, Err(CrateError::NonDigitNumber(10)));
20///
21/// # Ok(())
22/// # }
23/// ```
24impl<const N: usize> TryFrom<[u8; N]> for DigitSequence {
25    type Error = CrateError;
26
27    fn try_from(digits: [u8; N]) -> CrateResult<Self> {
28        (&digits as &[u8]).try_into()
29    }
30}
31
32/// [DigitSequence] can be created from a
33/// reference to a [u8] array, as long as the array
34/// only contains 0-9 digits or is empty; otherwise,
35/// the conversion results in a [CrateError::NonDigitNumber]:
36///
37/// ```
38/// use digit_sequence::*;
39///
40/// # fn main() -> GenericResult<()> {
41///
42/// let sequence: DigitSequence = (&[]).try_into()?;
43/// assert_eq!(sequence, []);
44///
45/// let sequence: DigitSequence = (&[9, 2]).try_into()?;
46/// assert_eq!(sequence, [9, 2]);
47///
48/// let result: CrateResult<DigitSequence> = [10].try_into();
49/// assert_eq!(result, Err(CrateError::NonDigitNumber(10)));
50///
51/// # Ok(())
52/// # }
53/// ```
54impl<const N: usize> TryFrom<&[u8; N]> for DigitSequence {
55    type Error = CrateError;
56
57    fn try_from(digits: &[u8; N]) -> CrateResult<Self> {
58        (digits as &[u8]).try_into()
59    }
60}
61
62/// [DigitSequence] supports equality with a fixed-size array.
63///
64/// ```
65/// use digit_sequence::*;
66///
67/// # fn main() -> GenericResult<()> {
68/// let source = [1, 3, 5, 7, 9];
69/// let sequence: DigitSequence = (&source).try_into()?;
70///
71/// assert_eq!(sequence, source);
72///
73/// let other = [9, 4];
74/// assert_ne!(sequence, other);
75///
76/// # Ok(())
77/// # }
78/// ```
79impl<const N: usize> PartialEq<[u8; N]> for DigitSequence {
80    fn eq(&self, other: &[u8; N]) -> bool {
81        self.0 == *other
82    }
83}
84
85/// [DigitSequence] supports equality with a reference to a fixed-size array.
86///
87/// ```
88/// use digit_sequence::*;
89///
90/// # fn main() -> GenericResult<()> {
91/// let source = [1, 3, 5, 7, 9];
92/// let sequence: DigitSequence = (&source).try_into()?;
93///
94/// assert_eq!(sequence, &source);
95///
96/// let other = [9, 4];
97/// assert_ne!(sequence, &other);
98///
99/// # Ok(())
100/// # }
101/// ```
102impl<const N: usize> PartialEq<&[u8; N]> for DigitSequence {
103    fn eq(&self, other: &&[u8; N]) -> bool {
104        self.0 == **other
105    }
106}
digit_sequence/arrays.rs

digit_sequence/
arrays.rs
