digit_sequence/vecs.rs
1use crate::{CrateError, CrateResult, DigitSequence};
2
3/// [DigitSequence] can be created from a [Vec] of [u8], as long as
4/// the vector 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 = vec![].try_into()?;
13/// assert_eq!(sequence, []);
14///
15/// let sequence: DigitSequence = vec![9, 2].try_into()?;
16/// assert_eq!(sequence, [9, 2]);
17///
18/// let result: CrateResult<DigitSequence> = vec![10].try_into();
19/// assert_eq!(result, Err(CrateError::NonDigitNumber(10)));
20///
21/// # Ok(())
22/// # }
23/// ```
24impl TryFrom<Vec<u8>> for DigitSequence {
25 type Error = CrateError;
26
27 fn try_from(value: Vec<u8>) -> CrateResult<Self> {
28 (&value as &[u8]).try_into()
29 }
30}
31
32/// [DigitSequence] can be created from a
33/// reference to a [Vec] of [u8], as long as the vector
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 = (&vec![]).try_into()?;
43/// assert_eq!(sequence, []);
44///
45/// let sequence: DigitSequence = (&vec![9, 2]).try_into()?;
46/// assert_eq!(sequence, [9, 2]);
47///
48/// let result: CrateResult<DigitSequence> = (&vec![10]).try_into();
49/// assert_eq!(result, Err(CrateError::NonDigitNumber(10)));
50///
51/// # Ok(())
52/// # }
53/// ```
54impl TryFrom<&Vec<u8>> for DigitSequence {
55 type Error = CrateError;
56
57 fn try_from(value: &Vec<u8>) -> CrateResult<Self> {
58 (value as &[u8]).try_into()
59 }
60}
61
62/// [DigitSequence] supports equality with a [Vec] of [u8].
63///
64/// ```
65/// use digit_sequence::*;
66///
67/// # fn main() -> GenericResult<()> {
68/// let vector = vec![1, 3, 5, 7, 9];
69/// let sequence: DigitSequence = (&vector).try_into()?;
70///
71/// assert_eq!(sequence, vector);
72///
73/// let other = vec![90, 92];
74/// assert_ne!(sequence, other);
75///
76/// # Ok(())
77/// # }
78/// ```
79impl PartialEq<Vec<u8>> for DigitSequence {
80 fn eq(&self, other: &Vec<u8>) -> bool {
81 self.0 == *other
82 }
83}
84
85/// [DigitSequence] supports equality with a reference to a [Vec] of [u8].
86///
87/// ```
88/// use digit_sequence::*;
89///
90/// # fn main() -> GenericResult<()> {
91///
92/// let vector = vec![1, 3, 5, 7, 9];
93/// let sequence: DigitSequence = (&vector).try_into()?;
94///
95/// assert_eq!(sequence, &vector);
96///
97/// let other = vec![90, 92];
98/// assert_ne!(sequence, &other);
99///
100/// # Ok(())
101/// # }
102/// ```
103impl PartialEq<&Vec<u8>> for DigitSequence {
104 fn eq(&self, other: &&Vec<u8>) -> bool {
105 self.0 == **other
106 }
107}