bitcoin_slices 0.11.0

Parse Bitcoin objects without allocations
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

use crate::{Error, ParseResult, SResult};

/// Return a slice legnth `len` from `from` if it's long enough, error otherwise.
#[inline(always)]
#[deprecated]
pub fn read_slice(from: &[u8], len: usize) -> SResult<&[u8]> {
    if from.len() < len {
        Err(Error::MoreBytesNeeded)
    } else {
        let (parsed, remaining) = from.split_at(len);

        Ok(ParseResult::new(remaining, parsed))
    }
}

/// Split the slice at the given length, returning the remaining slice and the parsed slice.
/// Replace with std split_at_checked when MSRV >= 1.80.0
#[inline(always)]
pub(crate) fn split_at_checked(from: &[u8], len: usize) -> Result<(&[u8], &[u8]), Error> {
    if from.len() < len {
        Err(Error::MoreBytesNeeded)
    } else {
        Ok(from.split_at(len))
    }
}

#[cfg(test)]
mod test {
    use crate::{Error, ParseResult};

    #[allow(deprecated)]
    use super::read_slice as r;

    #[allow(deprecated)]
    #[test]
    fn read_slice() {
        assert_eq!(r(&[], 0), Ok(ParseResult::new(&[][..], &[][..])));
        assert_eq!(r(&[], 1), Err(Error::MoreBytesNeeded));
        assert_eq!(r(&[0u8], 1), Ok(ParseResult::new(&[][..], &[0u8][..])));
        assert_eq!(
            r(&[0u8, 1u8], 1),
            Ok(ParseResult::new(&[1u8][..], &[0u8][..]))
        );
        assert_eq!(
            r(&[0u8, 1u8], 2),
            Ok(ParseResult::new(&[][..], &[0u8, 1u8][..]))
        );
    }
}