digit-sequence 0.3.8

Sequence of u8 digits
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106

use crate::{CrateError, CrateResult, DigitSequence};

/// [DigitSequence] can be created from an array of [u8], as long as
/// the array contains only 0-9 digits or is empty; otherwise,
/// the conversion results in a [CrateError::NonDigitNumber]:
///
/// ```
/// use digit_sequence::*;
///
/// # fn main() -> GenericResult<()> {
///
/// let sequence: DigitSequence = [].try_into()?;
/// assert_eq!(sequence, []);
///
/// let sequence: DigitSequence = [9, 2].try_into()?;
/// assert_eq!(sequence, [9, 2]);
///
/// let result: CrateResult<DigitSequence> = [10].try_into();
/// assert_eq!(result, Err(CrateError::NonDigitNumber(10)));
///
/// # Ok(())
/// # }
/// ```
impl<const N: usize> TryFrom<[u8; N]> for DigitSequence {
    type Error = CrateError;

    fn try_from(digits: [u8; N]) -> CrateResult<Self> {
        (&digits as &[u8]).try_into()
    }
}

/// [DigitSequence] can be created from a
/// reference to a [u8] array, as long as the array
/// only contains 0-9 digits or is empty; otherwise,
/// the conversion results in a [CrateError::NonDigitNumber]:
///
/// ```
/// use digit_sequence::*;
///
/// # fn main() -> GenericResult<()> {
///
/// let sequence: DigitSequence = (&[]).try_into()?;
/// assert_eq!(sequence, []);
///
/// let sequence: DigitSequence = (&[9, 2]).try_into()?;
/// assert_eq!(sequence, [9, 2]);
///
/// let result: CrateResult<DigitSequence> = [10].try_into();
/// assert_eq!(result, Err(CrateError::NonDigitNumber(10)));
///
/// # Ok(())
/// # }
/// ```
impl<const N: usize> TryFrom<&[u8; N]> for DigitSequence {
    type Error = CrateError;

    fn try_from(digits: &[u8; N]) -> CrateResult<Self> {
        (digits as &[u8]).try_into()
    }
}

/// [DigitSequence] supports equality with a fixed-size array.
///
/// ```
/// use digit_sequence::*;
///
/// # fn main() -> GenericResult<()> {
/// let source = [1, 3, 5, 7, 9];
/// let sequence: DigitSequence = (&source).try_into()?;
///
/// assert_eq!(sequence, source);
///
/// let other = [9, 4];
/// assert_ne!(sequence, other);
///
/// # Ok(())
/// # }
/// ```
impl<const N: usize> PartialEq<[u8; N]> for DigitSequence {
    fn eq(&self, other: &[u8; N]) -> bool {
        self.0 == *other
    }
}

/// [DigitSequence] supports equality with a reference to a fixed-size array.
///
/// ```
/// use digit_sequence::*;
///
/// # fn main() -> GenericResult<()> {
/// let source = [1, 3, 5, 7, 9];
/// let sequence: DigitSequence = (&source).try_into()?;
///
/// assert_eq!(sequence, &source);
///
/// let other = [9, 4];
/// assert_ne!(sequence, &other);
///
/// # Ok(())
/// # }
/// ```
impl<const N: usize> PartialEq<&[u8; N]> for DigitSequence {
    fn eq(&self, other: &&[u8; N]) -> bool {
        self.0 == **other
    }
}